সংক্ষেপে উত্তর
এই লেখায় যা আছে (13)
- Conversion API কী
- কেন দরকার: Pixel একা কোথায় দুর্বল
- CAPI event-এ কী কী থাকে
- Deduplication: একই order যেন দুইবার না গোনা হয়
- চালু করার উপায়
- ১. Platform বা partner integration
- ২. Conversions API Gateway
- ৩. Server-side Tag Manager
- ৪. সরাসরি integration (custom website)
- ধাপে ধাপে CAPI setup (সরাসরি integration)
- Event Match Quality বাড়ানো
- সাধারণ ভুল
- পরের করণীয়
Pixel বসিয়েছেন, কিন্তু Ads Manager-এর purchase সংখ্যা আপনার আসল order-এর চেয়ে বেশ কম দেখাচ্ছে। অথবা Events Manager-এ Meta পরামর্শ দিচ্ছে "Conversions API চালু করুন"। প্রশ্ন হলো — এটা আসলে কী, আপনার ব্যবসার জন্য দরকার কি না, আর চালু করলে duplicate event-এর ঝামেলা কীভাবে এড়াবেন।
এই গাইডে Conversion API (সংক্ষেপে CAPI) সহজ ভাষায় বোঝানো হয়েছে: কীভাবে কাজ করে, চালু করার উপায়গুলো, deduplication কেন জরুরি, আর Event Match Quality কীভাবে বাড়াবেন। Developer-কে কী বলবেন, সেটাও পরিষ্কার হবে।
Conversion API কী
Meta Pixel কাজ করে customer-এর browser থেকে: পাতা খুললে browser Meta-কে event পাঠায়। Conversion API একই event পাঠায় আপনার server থেকে — অর্থাৎ আপনার website-এর backend সরাসরি Meta-র সাথে কথা বলে।
দুটো একসাথে চালানোই Meta-র সুপারিশ। Pixel দ্রুত browser-এর আচরণ ধরে, আর CAPI নিশ্চিত করে যে browser-এর সমস্যায় event হারালেও server থেকে সেটা পৌঁছাবে।
কেন দরকার: Pixel একা কোথায় দুর্বল
- Ad blocker ও browser privacy: কিছু browser ও extension Pixel-এর code আটকে দেয়।
- iOS ও cookie-র সীমাবদ্ধতা: browser-ভিত্তিক tracking-এ কিছু তথ্য হারিয়ে যায়।
- ধীর mobile data: ঢাকার বাইরে দুর্বল নেটওয়ার্কে Pixel-এর code load হওয়ার আগেই customer পাতা ছেড়ে দিতে পারে, বা payment gateway থেকে thank-you পাতায় না ফিরতে পারে।
- Server-এ ঘটা ঘটনা: Phone-এ confirm হওয়া order বা পরে delivered হওয়া order-এর তথ্য browser জানে না, কিন্তু server জানে।
ফলে CAPI থাকলে Meta বেশি সম্পূর্ণ তথ্য পায়, যা report ও optimization দুটোকেই সাহায্য করে। তবে এটা কোনো জাদু নয় — ভুল setup-এ duplicate বা ভুল event গিয়ে উল্টো ক্ষতিও হতে পারে।
CAPI event-এ কী কী থাকে
প্রতিটি server event-এ মোটামুটি তিন ধরনের তথ্য থাকে:
| অংশ | উদাহরণ | মন্তব্য |
|---|---|---|
| Event-এর মূল তথ্য | event_name, event_time, event_id, action_source, event_source_url | Website-এর জন্য action_source হবে "website" |
| Customer তথ্য (user_data) | email, phone, নাম, শহর, external_id, fbp, fbc, IP ও user agent | Email, phone, নাম ইত্যাদি SHA-256 দিয়ে hash করে পাঠাতে হয়; fbp, fbc, IP ও user agent hash করা হয় না |
| Order তথ্য (custom_data) | value, currency, content_ids, num_items | Pixel-এর মতোই |
fbp ও fbc হলো Pixel-এর বানানো cookie-র মান (fbc বিজ্ঞাপনে click-এর তথ্য বহন করে)। Server event-এর সাথে এগুলো পাঠালে Meta সহজে বুঝতে পারে কোন মানুষ কোন বিজ্ঞাপনে click করেছিল।
Deduplication: একই order যেন দুইবার না গোনা হয়
Pixel আর CAPI দুটোই যদি একই Purchase পাঠায়, Meta-কে বলতে হবে যে এ দুটো আসলে একই ঘটনা। নাহলে একটা order দুটো purchase হিসেবে গোনা হবে এবং ROAS ভুলভাবে দ্বিগুণ দেখাবে।
নিয়মটা সহজ: browser ও server — দুই জায়গা থেকে একই event_name এবং একই event_id পাঠান। Pixel-এ এটা যায় eventID হিসেবে, CAPI-তে event_id হিসেবে। প্রথম event পৌঁছানোর ৪৮ ঘণ্টার মধ্যে একই নাম ও ID-র দ্বিতীয় event এলে Meta দুটো মিলিয়ে একটি রাখে। fbp বা external_id দিয়েও কিছু ক্ষেত্রে deduplication হয়, তবে সেটা কম নির্ভরযোগ্য — event_id-ই মূল উপায়।
চালু করার উপায়
১. Platform বা partner integration
WooCommerce, Shopify-এর মতো platform-এ Meta-র integration থেকে কয়েকটি click-এ CAPI চালু করা যায়। Deduplication সাধারণত নিজে থেকেই সামলানো হয়, তবু যাচাই করে নিন।
২. Conversions API Gateway
Meta-র একটি সমাধান, যেখানে আলাদা cloud server-এ gateway চালিয়ে Pixel-এর event server-পথেও পাঠানো হয়। Meta এর জন্য আলাদা fee নেয় না, তবে cloud hosting বা partner-এর খরচ আর রক্ষণাবেক্ষণ আপনার দায়িত্ব।
৩. Server-side Tag Manager
যারা আগে থেকে Google Tag Manager-এর server container ব্যবহার করেন, তারা সেখান থেকে CAPI পাঠাতে পারেন।
৪. সরাসরি integration (custom website)
Laravel বা অন্য custom website-এ developer Meta-র Graph API-তে সরাসরি event পাঠায় (Meta-র Business SDK ব্যবহার করেও করা যায়)। নিয়ন্ত্রণ সবচেয়ে বেশি — চাইলে confirmed বা delivered order-এর জন্য আলাদা event-ও পাঠানো যায়। কোন platform-এ এ ধরনের কাজ সহজ, তার আলোচনা আছে WooCommerce vs Laravel লেখায়।
ধাপে ধাপে CAPI setup (সরাসরি integration)
- 1আগে নিশ্চিত হোন Pixel ও standard events ঠিক আছে — Meta Pixel setup গাইড অনুযায়ী।
- 2Events Manager-এ আপনার Pixel/dataset-এর settings থেকে Conversions API-র জন্য access token তৈরি করুন; এটা শুধু server-এ রাখুন, website-এর frontend-এ কখনো নয়।
- 3Pixel-এর প্রতিটি গুরুত্বপূর্ণ event-এ (অন্তত Purchase) একটি অনন্য eventID যোগ করুন, যেমন order নম্বর।
- 4Server থেকে একই event_name ও একই event_id দিয়ে CAPI event পাঠান।
- 5user_data-তে SHA-256 hash করা email/phone (phone দেশের code সহ, যেমন 880 দিয়ে শুরু), external_id (hash করা Meta-র সুপারিশ), এবং hash ছাড়া IP, user agent, fbp ও fbc দিন।
- 6custom_data-তে value, currency ও content_ids দিন — Pixel-এর সাথে মিল রেখে।
- 7Events Manager-এর Test events থেকে test event code নিয়ে পরীক্ষামূলক event পাঠিয়ে দেখুন server event আসছে কি না।
- 8কয়েকদিন পর Events Manager-এ দেখুন browser ও server event দুটোই আসছে এবং deduplication ঠিকমতো হচ্ছে কি না।
- 9প্রতিটি event-এর Event Match Quality দেখে কোন তথ্য যোগ করলে ভালো হয় তা ঠিক করুন।
Event Match Quality বাড়ানো
Events Manager প্রতিটি event-এর জন্য Event Match Quality নামে একটা score দেখায় — Meta আপনার পাঠানো তথ্য দিয়ে কতটা ভালোভাবে মানুষকে Facebook/Instagram account-এর সাথে মেলাতে পারছে। বাংলাদেশে checkout-এ সাধারণত phone নম্বর নেওয়া হয়, email কম। তাই phone সঠিকভাবে পাঠানো সবচেয়ে গুরুত্বপূর্ণ।
- Phone থেকে space, dash, "+" সরিয়ে দেশের code যোগ করুন: 01712-XXXXXX → 8801712XXXXXX, তারপর hash করুন।
- Email ছোট হাতের অক্ষরে ও space ছাড়া hash করুন।
- fbp ও fbc cookie server-এ ধরে পাঠান — এগুলো অনেক সাহায্য করে।
- Logged-in customer থাকলে আপনার customer ID external_id হিসেবে দিন।
সাধারণ ভুল
পরের করণীয়
প্রথমে শুধু Purchase event দিয়ে CAPI চালু করে deduplication ঠিক হচ্ছে কি না নিশ্চিত হোন, তারপর InitiateCheckout, AddToCart ও ViewContent যোগ করুন। Duplicate, missing event বা কম match quality-র সমস্যা হলে Conversion API সমস্যা সমাধান গাইডটি দেখুন। Tracking ঠিক হওয়ার পরও বিজ্ঞাপনে ফল না এলে campaign-এর দিক যাচাই করুন Facebook Ads-এ conversion আসছে না গাইডে।
Checklist: Meta Conversion API (CAPI): কেন দরকার, কীভাবে চালু করবেন

