আপনার শপ কীভাবে LinkHarbor-কে বিক্রির খবর জানায়: ক্লিক আইডি, কলব্যাক সিক্রেট আর সেল কলব্যাক। সাথে সমর্থকদের পেমেন্ট কীভাবে কনভার্সন হিসেবে গোনা হয়।
কনভার্সন হলো এমন একটি বিক্রি বা সমর্থকের পেমেন্ট, যা LinkHarbor আপনার পেজের একটি ক্লিকের সাথে যুক্ত করতে পারে। এভাবে আপনি শুধু একটি লিংক কতবার ক্লিক হয়েছে তা-ই নয়, তা থেকে কী এসেছে তাও দেখেন। এই লেখাটি নিজস্ব শপ আছে এমন ক্রিয়েটর আর যে ডেভেলপাররা শপ সংযুক্ত করেন তাঁদের জন্য। কনভার্সন বিশ্লেষণ আর কলব্যাক সিক্রেট তৈরি Creator Pro থেকে করা যায়।
কনভার্সন কোথা থেকে আসে
- আপনার শপ বা সার্ভার সেল কলব্যাকের মাধ্যমে যে বিক্রি রিপোর্ট করে
- Stripe-এর মাধ্যমে সমর্থকদের পেমেন্ট; রিফান্ড হলে কনভার্সনটি আবার সরে যায়, দেখুন Stripe দিয়ে সমর্থকদের পেমেন্ট
প্রতিটি কনভার্সন তার ক্লিকের ডেটা পায়: পেজ, লিংক, দেশ, ডিভাইস, রেফারার আর UTM প্যারামিটার। তাই এটি পরিসংখ্যানে ঠিক সেখানেই দেখা যায় যেখান থেকে ক্লিকটি এসেছিল।
যুক্ত করা কীভাবে কাজ করে
- একজন ভিজিটর আপনার পেজে একটি লিংকে ক্লিক করেন
- LinkHarbor ক্লিকটি গোনে এবং রিডাইরেক্টের সময় গন্তব্য URL-এ একটি ইউনিক ক্লিক আইডিসহ lt_click_id প্যারামিটার জুড়ে দেয়
- আপনার গন্তব্য পেজ (যেমন শপ) ঠিকানা থেকে lt_click_id পড়ে এবং কেনাকাটা পর্যন্ত রেখে দেয়
- কেনাকাটার পর আপনার সার্ভার এই ক্লিক আইডিসহ LinkHarbor-এ একটি সেল কলব্যাক পাঠায়
- কনভার্সনটি ড্যাশবোর্ডে আর পেজের পরিসংখ্যানে দেখা যায়
ক্লিক আইডি শুধু http:// বা https:// দিয়ে শুরু হওয়া গন্তব্যে জোড়া হয়। mailto: বা tel:-এর লিংক এটি পায় না, কারণ সেখানে প্যারামিটারটি বিষয় বা ফোন নম্বর নষ্ট করে দিত। বটের ক্লিকও কোনো ক্লিক আইডি পায় না।
কলব্যাক সিক্রেট তৈরি করুন
সেল কলব্যাককে একটি কলব্যাক সিক্রেট দিয়ে নিজের পরিচয় দিতে হয়। মালিক আর অ্যাডমিনরা Creator Pro থেকে মেনুর অ্যাকাউন্ট অংশে “কলব্যাক ও API”-এর অধীনে সিক্রেট পরিচালনা করেন।
- “কলব্যাক ও API” খুলুন
- “কলব্যাক সিক্রেট” কার্ডে “+ নতুন সিক্রেট তৈরি করুন”-এ ক্লিক করুন
- চাইলে একটি নাম লিখুন, যেমন “শপ কলব্যাক”
- “সিক্রেট তৈরি করুন”-এ ক্লিক করুন
- সিক্রেটটি সাথে সাথে কপি করুন: এটি শুধু একবারই দেখানো হয়
- “সম্পাদনা করুন”
- নাম আর স্ট্যাটাস (সক্রিয় বা নিষ্ক্রিয়) বদলান। নিষ্ক্রিয় সিক্রেট প্রত্যাখ্যান করা হয়।
- “↺ রোটেট করুন”
- একটি নতুন সিক্রেট তৈরি করে। পুরোনোটি সাথে সাথে কাজ করা বন্ধ করে – তাই নতুনটি তখনই আপনার শপে বসিয়ে দিন।
- “মুছুন”
- নিশ্চিতকরণের পর সিক্রেটটি সরিয়ে দেয়।
- “সর্বশেষ কলব্যাক:”
- সিক্রেটটি শেষ কবে ব্যবহার হয়েছে তা দেখায়, নইলে “এখনো ব্যবহৃত হয়নি”।
প্রতি ওয়ার্কস্পেসে সর্বোচ্চ ৫টি কলব্যাক সিক্রেট তৈরি করতে পারেন।
সেল কলব্যাক পাঠান
আপনার সার্ভার LinkHarbor API-তে একটি POST রিকোয়েস্ট পাঠায়। সিক্রেটটি যায় X-Callback-Secret হেডারে।
curl -X POST https://dock.at-harbor.com/v1/callbacks/sale \
-H "Content-Type: application/json" \
-H "X-Callback-Secret: YOUR_CALLBACK_SECRET" \
-d '{
"click_id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a23",
"order_id": "B-10042",
"amount": "49.90",
"currency": "EUR"
}' - click_id
- আবশ্যক। lt_click_id থেকে পাওয়া ক্লিক আইডি (১০–৩৬ অক্ষর)।
- order_id
- আবশ্যক। আপনার অর্ডার নম্বর (১–১২৮ অক্ষর)। প্রতি অর্ডার নম্বরে একটিই কনভার্সন গোনা হয়, তাই একই কলব্যাক আবার এলে দ্বিতীয়টি তৈরি হয় না।
- amount
- আবশ্যক। দশমিক সংখ্যা হিসেবে পরিমাণ।
- currency
- আবশ্যক। ৩ অক্ষরের মুদ্রা কোড, যেমন EUR।
- occurred_at, meta
- ঐচ্ছিক। কেনাকাটার সময় আর অতিরিক্ত তথ্যসহ সর্বোচ্চ ৫০টি নিজস্ব কী (প্রতিটি ১–৬৪ অক্ষর)। একটি মান হতে পারে সর্বোচ্চ ৫০০ অক্ষরের টেক্সট, একটি সংখ্যা, true/false বা null; নেস্টেড অবজেক্ট API প্রত্যাখ্যান করে।
রেসপন্স
| স্ট্যাটাস | অর্থ |
|---|---|
| 200 | কনভার্সন সংরক্ষিত হয়েছে; রেসপন্সে conversion_id থাকে |
| 403 | সিক্রেট ভুল বা নিষ্ক্রিয় – অথবা workspace_id না পাঠালে ক্লিক আইডি অজানা |
| 404 | ক্লিক আইডি অজানা (শুধু আপনার workspace_id পাঠালে) |
| 413 | বডি ১ MB-এর চেয়ে বড় (request_too_large) |
| 422 | একটি আবশ্যক ফিল্ড নেই বা ভুল ফরম্যাটে আছে, যেমন meta-তে খুব লম্বা বা নেস্টেড মান |
| 429 | একই IP ঠিকানা থেকে প্রতি মিনিটে ১২০টির বেশি কলব্যাক |
ডেভেলপারদের জন্য সব ফিল্ড আর ত্রুটি কোড আছে বিক্রি ও নিজস্ব ডেটা পাঠানো-এ।
কনভার্সন বিশ্লেষণ
- ড্যাশবোর্ড: “কনভার্সন” আর “CVR” টাইল এবং UTM সোর্স ও মিডিয়াম অনুযায়ী “কনভার্সন” কার্ড
- পেজের পরিসংখ্যান: “মোট CVR”, “ইউনিক CVR” আর “বিশ্লেষণ”-সহ “কনভার্সন” কার্ড
- মোট CVR = কনভার্সনকে ক্লিক দিয়ে ভাগ; ইউনিক CVR = কনভার্সনকে ইউনিক ক্লিক দিয়ে ভাগ
এগুলোও কাজে আসতে পারে
কিছু খুঁজে পাননি?
আপনার কী দরকার তা আমাদের জানান, আমাদের সাপোর্ট টিম ব্যক্তিগতভাবে আপনাকে সাহায্য করবে।