কনভার্সন API
ব্রাউজারের বদলে আমাদের সার্ভার থেকে Meta, LinkedIn, TikTok ও Google Ads-কে আপনার লক্ষ্য পূরণের খবর দিন — শুধু নেটওয়ার্কের নিজের দেওয়া ক্লিক পরিচয়চিহ্ন দিয়ে মেলানো হয়।
1. সার্ভারভিত্তিক কেন?
কনভার্সনের খবর দেওয়ার আগে ব্রাউজার পিক্সেলকে তিনটি বাধা পার হতে হয়: অ্যাডব্লকার, ট্র্যাকিং প্রতিরোধের সেটিং এবং পিক্সেল চলার আগেই দর্শকের ট্যাব বন্ধ করা। সার্ভারভিত্তিক কল তিনটিই পার হয়, কারণ ব্রাউজারে ঘটেই না।
আপনার কোনো লক্ষ্য পূরণ হলে MousePlayer ইতিমধ্যেই জানে — লক্ষ্য সে জন্যই। কনভার্সন API শুধু সেই তথ্য সার্ভার থেকে বিজ্ঞাপন নেটওয়ার্কে পাঠায়।
এটি আপনার পিক্সেলের বিকল্প নয়। সেটি রাখুন। প্রতিটি নেটওয়ার্ক দুটিকে মিলিয়ে পুনরাবৃত্তি বাদ দেয়, এবং তার জন্য প্রয়োজনীয় পরিচয়চিহ্ন আমরা পাঠাই।
2. যা পাঠাই — যা কখনো পাঠাই না
এই কলে দর্শককে চেনায় শুধু নেটওয়ার্কের নিজের বসানো কুকি বা ক্লিক পরিচয়চিহ্ন। ব্যক্তি সম্পর্কে আর কিছু সার্ভার ছাড়ে না।
| নেটওয়ার্ক | ব্যবহৃত পরিচয়চিহ্ন | উৎস |
|---|---|---|
| Meta | _fbp, _fbc | Meta পিক্সেলের বসানো ফার্স্ট-পার্টি কুকি |
li_fat_id | LinkedIn Insight Tag-এর বসানো ফার্স্ট-পার্টি কুকি | |
| TikTok | _ttp, ttclid | _ttp একটি কুকি, ttclid আসে বিজ্ঞাপনে ক্লিকের URL থেকে |
| Google Ads | gclid, wbraid, gbraid | বিজ্ঞাপনে ক্লিকের URL থেকে, অথবা পরে এই _gcl_aw কুকি থেকে |
| Microsoft Advertising | msclkid | বিজ্ঞাপনে ক্লিকের URL থেকে, অথবা এই _uetmsclkid কুকি থেকে, যা UET ট্যাগ লেখে |
কখনো পাঠানো হয় না: ইমেইল ঠিকানা, ফোন নম্বর, নাম বা IP ঠিকানা — হ্যাশ করেও নয়। দর্শকের ক্লিক পরিচয়চিহ্ন না থাকলে কিছুই পাঠানো হয় না। নির্দিষ্ট দর্শকের সঙ্গে মেলেনি এমন কনভার্সনের চেয়ে সঠিক গণনা আপনার বেশি কাজে লাগে।
শুধু সম্মতিসহ
প্রতিটি কল রেকর্ডিংয়ের মতো একই সম্মতির নিয়ন্ত্রণের অধীনে। প্রকল্পের সেটিংসের সুইচ যাই হোক, সম্মতিহীন সেশন কনভার্সনের খবর পাঠায় না।
3. Google Ads-এর পরিচয়চিহ্ন তিনটি, একটি নয়
এটি মানুষকে অবাক করে, তাই স্পষ্ট বলা দরকার। Google ব্যবহার করে gclid একক বিজ্ঞাপনে ক্লিকের জন্য। Apple-এর ট্র্যাকিং প্রতিরোধে একক ক্লিকের উৎস চেনা না গেলে Google পাঠায় wbraid অথবা gbraid , যা ক্লিকের গোষ্ঠী বোঝায়।
তিনটি একসঙ্গে থাকতে পারে না — দুটো থাকা কনভার্সন Google প্রত্যাখ্যান করে। আমরা ঠিক একটি পাঠাই, এবং gclid একাধিক থাকলে অগ্রাধিকার পায়, কারণ সেটি সবচেয়ে নির্ভুল।
URL-এ শুধু একবার থাকে
পরিচয়চিহ্ন ঠিকানায় দেখায় শুধু প্রথম পৃষ্ঠায়, বিজ্ঞাপনে ক্লিকের পরে। এরপর Google ট্যাগ সেটি রাখে এই _gcl_aw কুকিতে। আমরা বিকল্প হিসেবে কুকি পড়ি — তা ছাড়া ভিজিটের তৃতীয় পৃষ্ঠার কনভার্সনে কোনো পরিচয়চিহ্নই পাওয়া যেত না।
4. সেট আপ করা
Meta, LinkedIn ও TikTok
প্রতিটিতে দুটি ঘর: পিক্সেল বা কনভার্সন নিয়মের ID এবং নেটওয়ার্কের নিজস্ব ইন্টারফেসে তৈরি অ্যাক্সেস টোকেন। দুটিই AES-256-GCM এনক্রিপশনে থাকে এবং সংরক্ষণের পরে আর দেখানো হয় না।
Google Ads-এ ছয়টি দরকার
Google ব্যতিক্রম, এবং শুরু করার আগে কারণটি জানা ভালো: অন্য তিনটির মতো Google সহজ অ্যাক্সেস টোকেন দেয় না। রিফ্রেশ টোকেনসহ OAuth দিয়ে প্রবেশ হয়, এবং Ads API-এর আরও প্রয়োজন একটি ডেভেলপার টোকেন।
| ঘর | কোথায় পাবেন |
|---|---|
| গ্রাহক ID | Google Ads-এর ওপরের ডান কোণায়। শুধু সংখ্যা, হাইফেন ছাড়া। |
| কনভার্সন অ্যাকশন ID | লক্ষ্য ও কনভার্সন বিভাগে, তারপর যে অ্যাকশনে এটি গণনা করতে চান সেখানে। |
| ডেভেলপার টোকেন | আপনার Google Ads ম্যানেজার অ্যাকাউন্টের API Center-এ। |
| OAuth ক্লায়েন্ট ID ও সিক্রেট | Google Cloud Console-এর Credentials-এ, “desktop app” ধরনের OAuth ক্লায়েন্ট। |
| রিফ্রেশ টোকেন | এই স্কোপের জন্য একবার নিজে তৈরি করেন: adwords। |
LinkedIn-এর পথ দুটি, সংক্ষিপ্তটিই আপনার দরকার
Campaign Manager-এ: ডেটা, Signals Manager, Direct API, অ্যাক্সেস টোকেন তৈরি করুন। নিজের ডেটা পাঠানো বিজ্ঞাপনদাতাদের জন্য এই পথ — ডেভেলপার অ্যাপ বা পর্যালোচনা দরকার নেই। টোকেনের মেয়াদ শেষ হয় না, আর Campaign Manager দ্বিতীয়বার দেখাবে না, তাই সঙ্গে সঙ্গে কপি করুন।
অন্য পথ, LinkedIn Developer Portal দিয়ে চাওয়া ডেভেলপার অ্যাপ, বহু বিজ্ঞাপনদাতার হয়ে পাঠানো প্ল্যাটফর্মের জন্য। কোম্পানির পৃষ্ঠা যাচাই ও অনুমোদিত ব্যবহারের উদ্দেশ্য দরকার, এখানে যার কোনোটিই আপনার লাগবে না।
Microsoft Advertising সহজটি
Google Ads-এর পরে একই ঝামেলা আশা করেন — OAuth, ডেভেলপার টোকেন, অনুমোদনের ধাপ। আসলে উল্টো: দুটি ঘর। ব্রাউজারে ইতিমধ্যে ব্যবহার করা UET ট্যাগ ID এবং Microsoft Advertising-এ UET ট্যাগের নিচে “Use Conversions API”, “Copy Token” থেকে কপি করা টোকেন। কোনো আবেদন করতে হবে না।
ব্যবহার করুন একই ট্যাগ ID, যা ব্রাউজারের ট্যাগে আছে। এতে Microsoft সার্ভারের ইভেন্ট ও ব্রাউজারের ইভেন্টকে দুইটির বদলে একটি কনভার্সন হিসেবে চেনে।
ডেভেলপার টোকেনে Google-এর অনুমোদন দরকার (“Basic access”), কয়েক দিন লাগে। এক মিনিটে শেষ করা যায় না এমন একমাত্র ধাপ এটি, তাই আগে শুরু করুন। আপনার Google পাসওয়ার্ড কখনো দেখি না — শুধু রিফ্রেশ টোকেন, যা যেকোনো সময় প্রত্যাহার করতে পারেন।
5. কখন কনভার্সনের খবর যায়
প্রতি লক্ষ্য ও সেশনে ঠিক একবার। কল যাওয়ার আগেই MousePlayer পুনরাবৃত্তি বাদ দেয়, এবং পেলোডে অতিরিক্ত ID থাকে যাতে নেটওয়ার্ক নিজের দিকেও আবার বাদ দিতে পারে। দর্শক কার্টে পাঁচটি পণ্য যোগ করলে একটি কনভার্সন হয়, পাঁচটি নয়।
বিজ্ঞাপন অ্যাকাউন্টে যা দেখবেন
কনভার্সনে লক্ষ্যের নাম, নির্ধারণ করে থাকলে মূল্য ও মুদ্রা, এবং ঘটার সময় থাকে। সাধারণভাবে এক মিনিটের মধ্যে পৌঁছায়।
কিছু না এলে
- ক্লিক পরিচয়চিহ্ন নেই। দর্শক ওই নেটওয়ার্কের বিজ্ঞাপন দিয়ে আসেননি, অথবা পিক্সেল কুকি বসানোর আগে এসেছেন। কিছু পাঠানো হয় না — প্রত্যাশিত আচরণ, ত্রুটি নয়।
- সম্মতি নেই। আগে সম্মতির নিয়ন্ত্রণ প্রযোজ্য হয়েছে।
- নেটওয়ার্ক কল নিয়েছে, কিন্তু কনভার্সন প্রত্যাখ্যান করেছে। Google, TikTok ও অন্য অনেকেই HTTP 200 দেয় এবং রেসপন্স বডির ভেতরে ত্রুটি রাখে। আমরা শুধু স্ট্যাটাস নয়, বডিও পড়ি, এবং কারণ ডেলিভারি লগে দেখায়।
এখানে উল্লিখিত সব ট্রেডমার্ক নিজ নিজ মালিকের। এই সেবাদাতাদের সঙ্গে MousePlayer-এর ব্যবসায়িক সম্পর্ক নেই।