Meta Conversions API (CAPI) इंटीग्रेशन

आपके पार्टनर्स का हर अप्रूव्ड कन्वर्ज़न सर्वर से सर्वर आपके Meta डेटासेट पर भेजें — ताकि ब्राउज़र Pixel ब्लॉक होने पर भी Meta की ऐड डिलीवरी असली ख़रीद पर ऑप्टिमाइज़ हो।

ओवरव्यू

Meta Pixel ख़रीदार के ब्राउज़र में चलता है, जहाँ ऐड ब्लॉकर, iOS की प्राइवेसी सेटिंग और कंसेंट के विकल्प कई इवेंट रोक देते हैं। Conversions API यही इवेंट सर्वर से भेजता है। AffClix यह काम आपके लिए करता है: जब कोई कन्वर्ज़न अप्रूव होता है, तो वह आपके डेटासेट (पिक्सेल) पर एक सर्वर इवेंट भेजता है — आपके मैप किए इवेंट नाम, बिक्री की वैल्यू और आपके अनुमति दिए पहचान सिग्नल के साथ।

सेटअप में कुछ मिनट लगते हैं: Facebook कनेक्ट करें, लिस्ट से डेटासेट चुनें और अपने AffClix गोल को Meta के स्टैंडर्ड इवेंट से मैप करें। अगर साइट पर Pixel भी चलता है, तो Meta हर कन्वर्ज़न का एक ही इवेंट रखता है, क्योंकि AffClix कन्वर्ज़न ID को इवेंट ID के रूप में भेजता है।

यह इंटीग्रेशन क्यों ज़रूरी है

  • छूटे कन्वर्ज़न वापस पाएँ — जो ख़रीद Pixel ने कभी देखी ही नहीं, ब्लॉकर, iOS या अस्वीकार की गई कुकी की वजह से, वह भी Meta तक पहुँचती है।
  • बेहतर ऑप्टिमाइज़ेशन — Advantage+ और कन्वर्ज़न कैंपेन आपके पार्टनर्स की असली बिक्री से सीखते हैं।
  • सिर्फ़ अप्रूव्ड कन्वर्ज़न — पेंडिंग, रिजेक्टेड और कटबैक कन्वर्ज़न कभी नहीं भेजे जाते, इसलिए Meta उसी रेवेन्यू पर ऑप्टिमाइज़ करता है जो आपके पास रहता है।
  • असली वैल्यू — हर इवेंट में बिक्री की रकम और करेंसी जाती है, ताकि वैल्यू ऑप्टिमाइज़ेशन और ROAS सही रहें।
  • Pixel के साथ डुप्लिकेट नहीं — AffClix कन्वर्ज़न ID इवेंट ID के रूप में जाता है, इसलिए Pixel और सर्वर दोनों रिपोर्ट करें तब भी Meta एक ही ख़रीद गिनता है।
  • क्या शेयर हो, यह आप तय करें — चुनें कि कौन-से पहचान सिग्नल AffClix से बाहर जाएँ; लोकेशन और एक्सटर्नल ID भेजने से पहले SHA-256 से हैश किए जाते हैं।
  • पूरा ऑडिट ट्रेल — हर कोशिश Meta के जवाब के साथ CAPI Delivery रिपोर्ट में दर्ज होती है।

ज़रूरी शर्तें

  • ऐसा AffClix प्लान जिसमें Conversions API शामिल हो — Integrations → Conversions API मेनू।
  • Events Manager में एक Meta डेटासेट (पिक्सेल)। वही इस्तेमाल करें जिस पर साइट के ब्राउज़र इवेंट पहले से आते हैं, ताकि सर्वर और ब्राउज़र इवेंट साथ मिलें।
  • उस डेटासेट के ऐक्सेस वाला Facebook अकाउंट — उसके मालिक Business Manager में एक व्यक्ति के रूप में, या पार्टनर असाइनमेंट के ज़रिए।
  • पोस्टबैक, पिक्सेल या ई-कॉमर्स इंटीग्रेशन से AffClix तक पहुँचने वाले कन्वर्ज़न, जो अप्रूव हों।
  • वैकल्पिक: Events Manager → आपका डेटासेट → Test events से एक टेस्ट इवेंट कोड, ताकि असली ट्रैफ़िक से पहले सेटअप जाँच सकें।

चरण 1: Meta Events Manager में अपना डेटासेट तैयार करें

AffClix को जो चाहिए वह सब Events Manager में पहले से मौजूद है; बस यह पता होना चाहिए कि कौन-सा डेटासेट इस्तेमाल करना है।

01

Events Manager खोलें

Meta Business Suite में Events Manager → Data sources खोलें और वेबसाइट का डेटासेट (पिक्सेल) चुनें।

02

डेटासेट ID नोट करें

डेटासेट ID उसके नाम के नीचे दिखने वाला नंबर है। आम तौर पर आप इसे AffClix में लिस्ट से चुनेंगे, पर सही डेटासेट पता होना मददगार है।

03

टेस्ट इवेंट कोड कॉपी करें (वैकल्पिक)

डेटासेट का Test events टैब खोलें और कोड कॉपी करें, जैसे TEST12345। AffClix इसे सिर्फ़ Send test event बटन के लिए इस्तेमाल करता है — असली कन्वर्ज़न में यह कभी नहीं जाता।

04

अपना ऐक्सेस जाँचें

पक्का करें कि जिस Facebook अकाउंट को आप कनेक्ट करेंगे, वह इस डेटासेट को मैनेज कर सकता है। अगर डेटासेट किसी क्लाइंट के बिज़नेस का है, तो उनसे इसे आपको या आपकी एजेंसी के बिज़नेस को असाइन करने को कहें।

Business Manager का ऐक्सेस नहीं है?

आप Conversions API ऐक्सेस टोकन पेस्ट करके भी कनेक्ट कर सकते हैं: Events Manager → आपका डेटासेट → Settings → Conversions API → Generate access token। चरण 2 देखें।

चरण 2: AffClix में Facebook कनेक्ट करें

01

Conversions API खोलें

Integrations → Conversions API पर जाएँ और Add destination पर क्लिक करें।

02

Meta CAPI चुनें

Meta CAPI टाइल चुनें और डेस्टिनेशन को कोई नाम दें, जैसे Meta – Main dataset। सभी कैंपेन के कन्वर्ज़न भेजने के लिए Campaign ID ख़ाली छोड़ें, या एक कैंपेन का ID डालें।

नए कन्वर्ज़न डेस्टिनेशन फ़ॉर्म में प्लेटफ़ॉर्म पिकर, जिसमें Meta CAPI टाइल है।
Meta CAPI चुनें; नीचे का फ़ॉर्म उसी के लिए बनता है।
03

Facebook कनेक्ट करें

Connect Facebook पर क्लिक करें और उस Facebook अकाउंट से साइन इन करें जो डेटासेट मैनेज करता है। Meta जो अनुमतियाँ माँगे, उन्हें दें — इवेंट भेजने के लिए AffClix को ऐड अनुमति चाहिए। AffClix आपका पासवर्ड कभी नहीं देखता।

Meta क्रेडेंशियल कार्ड, जिसमें Connect Facebook बटन, “Get these from Meta first” चेकलिस्ट और ऐक्सेस टोकन फ़ील्ड है।
Facebook कनेक्ट करें, या ऐक्सेस टोकन पेस्ट करके वेरिफ़ाई करें।
04

डेटासेट चुनें

AffClix में लौटने पर आपको Facebook connected दिखेगा। Pixel / Dataset ID में डेटासेट चुनें। अगर वह लिस्ट में नहीं है, तो उसी फ़ील्ड में उसका ID टाइप करें।

05

या ऐक्सेस टोकन पेस्ट करें

अगर Connect Facebook नहीं दिखता, या आप अपना System User टोकन इस्तेमाल करना चाहते हैं, तो उसे Access token में पेस्ट करें, Verify token & load pixels पर क्लिक करें, फिर डेटासेट चुनें। स्टेप इंडिकेटर Paste access token → Verify token → Choose dataset दिखाता है।

Facebook लॉगिन लगभग 60 दिन चलता है

Meta कनेक्टेड लॉगिन लगभग 60 दिन के लिए देता है और इसे अपने-आप रिन्यू नहीं करता। इसके ख़त्म होने से पहले डेस्टिनेशन खोलें और Reconnect Facebook पर क्लिक करें — डेटासेट और मैपिंग वैसे ही रहेंगे। अगर Meta इवेंट रिजेक्ट करने लगे, तो AffClix आपको अलर्ट भी करता है।

चरण 3: अपने गोल को Meta इवेंट से मैप करें

Meta के लिए इवेंट का नाम मायने रखता है: Meta उसी इवेंट पर रिपोर्ट और ऑप्टिमाइज़ करता है। जहाँ भी फ़िट हो, Meta के स्टैंडर्ड इवेंट नाम इस्तेमाल करें।

01

हर गोल मैप करें

Event Mapping & Matching में Your goal के नीचे गोल चुनें और Platform event में Meta इवेंट डालें — जैसे सेल गोल → Purchase, लीड → Lead, साइन-अप → CompleteRegistration।

Event Mapping & Matching कार्ड, जिसमें गोल Meta इवेंट से मैप हैं और मैच की के विकल्प हैं।
गोल को Meta के स्टैंडर्ड इवेंट से मैप करें और चुनें कि कौन-से सिग्नल शेयर हों।
02

फ़ॉलबैक तय करें

* गोल वाली पंक्ति हर उस गोल को पकड़ती है जिसे आपने मैप नहीं किया। अगर सिर्फ़ लिस्ट किए गए गोल भेजने हैं, तो इसे हटा दें।

03

मैच कीज़ चुनें

Match keys to send में कुछ भी न चुनें ताकि सभी उपलब्ध सिग्नल जाएँ, या सिर्फ़ वही चुनें जिसकी आपकी कंसेंट पॉलिसी इजाज़त देती है। ज़्यादा सिग्नल का मतलब है Events Manager में बेहतर Event Match Quality।

जिस गोल की पंक्ति नहीं, वह नहीं भेजा जाता

अगर किसी गोल की अपनी पंक्ति नहीं है और * पंक्ति भी नहीं है, तो उस गोल के कन्वर्ज़न इस डेस्टिनेशन के लिए छोड़ दिए जाते हैं। इसी तरह आप, उदाहरण के लिए, लीड इवेंट को सिर्फ़-ख़रीद वाले डेटासेट से बाहर रख सकते हैं।

मैच कीज़ एक नज़र में

Click IDs fbclid वाला क्लिक ID भेजता है; fbc / fbp Meta की ब्राउज़र कुकी भेजता है; IP + UA विज़िटर का IP पता और ब्राउज़र भेजता है; Geo शहर, राज्य, पिनकोड और देश (हैश किए हुए) भेजता है; External ID आपका कस्टमर ID (हैश किया हुआ) भेजता है। AffClix ईमेल या फ़ोन नंबर नहीं रखता, इसलिए वे कभी नहीं भेजे जाते।

चरण 4: सेव करें और टेस्ट करें

01

सेव करें

देखें कि Active चालू है और Create destination पर क्लिक करें।

02

टेस्ट इवेंट भेजें

डेस्टिनेशन पर Test event code डालें, सेव करें, फिर Conversions API लिस्ट में Send test event पर क्लिक करें। AffClix एक टेस्ट Purchase भेजता है, जो एक मिनट में Events Manager → आपका डेटासेट → Test events में दिखता है। इस बटन के लिए टेस्ट इवेंट कोड ज़रूरी है।

03

असली इवेंट कन्फ़र्म करें

अगले अप्रूव्ड कन्वर्ज़न के बाद Reports → Delivery Logs → CAPI Delivery में Delivered पंक्ति देखें, और Events Manager → Overview में Conversions API से आने वाले सर्वर इवेंट जाँचें।

असल ज़िंदगी का उदाहरण

एक फ़ैशन ब्रांड Instagram क्रिएटर्स के ज़रिए अपने स्टोर का प्रचार करता है और उसी डेटासेट पर Advantage+ शॉपिंग कैंपेन चलाता है। उसके कई ख़रीदार iPhone इस्तेमाल करते हैं।

  1. एक ख़रीदार Instagram से किसी क्रिएटर के AffClix लिंक पर जाता है। AffClix क्लिक दर्ज करता है, जिसमें Meta का क्लिक ID भी होता है।
  2. ख़रीदार €89 की जैकेट ख़रीदता है, पर Safari की प्राइवेसी सेटिंग की वजह से Pixel ख़रीद रिपोर्ट नहीं कर पाता।
  3. ब्रांड का पोस्टबैक AffClix में बिक्री दर्ज करता है, और बिक्री अप्रूव हो जाती है।
  4. AffClix डेटासेट पर Purchase इवेंट भेजता है — वैल्यू 89, करेंसी EUR, क्लिक ID और हैश की गई लोकेशन के साथ, और कन्वर्ज़न ID इवेंट ID के रूप में।

नतीजा: Meta वह ख़रीद गिनता है जो Pixel से छूट गई थी, उसका श्रेय सही कैंपेन को देता है और असली बिक्री पर डिलीवरी ऑप्टिमाइज़ करता है। जहाँ Pixel उसी इवेंट ID के साथ चला, वहाँ Meta एक ही ख़रीद रखता है।

इंटीग्रेशन को मैनेज और मॉनिटर करना

  • डिलीट किए बिना रोकें — डेस्टिनेशन की पंक्ति का टॉगल इस्तेमाल करें, या Active बंद करें।
  • लॉगिन रिन्यू करें — लगभग 60 दिन का लॉगिन ख़त्म होने से पहले Facebook दोबारा कनेक्ट करें; डेस्टिनेशन का डेटासेट और मैपिंग वैसे ही रहते हैं।
  • क्रेडेंशियल अलर्ट — AffClix हर घंटे हर डेस्टिनेशन जाँचता है। अगर टोकन एक्सपायर या रद्द होने से Meta इवेंट रिजेक्ट करने लगे, तो पंक्ति में Reconnect credentials दिखता है और वर्कस्पेस ओनर को ईमेल जाता है।
  • Event Match Quality — Events Manager हर सर्वर इवेंट को स्कोर देता है। इसे बढ़ाने के लिए ज़्यादा मैच कीज़ की अनुमति दें।
  • हर कन्वर्ज़न पर CAPI स्टेटस — कन्वर्ज़न रिपोर्ट में एक CAPI कॉलम जुड़ जाता है, जिसमें Delivered, Failed या Partial दिखता है।

CAPI Delivery लॉग

हर कोशिश Reports → Delivery Logs → CAPI Delivery में दर्ज होती है। तारीख़, प्लेटफ़ॉर्म, डेस्टिनेशन और स्टेटस से फ़िल्टर करें।

CAPI Delivery रिपोर्ट, जिसमें प्लेटफ़ॉर्म, इवेंट, स्टेटस और रिस्पॉन्स कोड के साथ डिलीवरी की कोशिशें हैं।
Reports → Delivery Logs → CAPI Delivery हर कोशिश दर्ज करता है।
कॉलमयह क्या बताता है
Platform / Eventडेस्टिनेशन और भेजा गया Meta इवेंट, जैसे Purchase।
StatusDelivered, या वजह के साथ Failed।
Response codeMeta का लौटाया HTTP स्टेटस।
Attempts / Retryableकितनी कोशिशें हुईं, और क्या गड़बड़ी अस्थायी थी और दोबारा कोशिश होगी।
ErrorMeta का अपना एरर मैसेज, सपोर्ट के लिए उसके ट्रेस ID के साथ।

समस्या-समाधान

लक्षणसंभावित कारणक्या करें
डेटासेट लिस्ट ख़ाली हैFacebook अकाउंट डेटासेट नहीं देख पाता, या बिज़नेस उसे सिर्फ़ ऐसेट असाइनमेंट से शेयर करता है।फ़ील्ड में डेटासेट ID टाइप करें, या उसके मालिक से उसे आपको असाइन करने को कहें।
“This login did not grant ads_management”Facebook की कंसेंट स्क्रीन पर ऐड अनुमति अस्वीकार की गई।Reconnect Facebook पर क्लिक करें और Meta की माँगी हर अनुमति दें।
Send test event फ़ेल होता हैडेस्टिनेशन पर कोई टेस्ट इवेंट कोड सेट नहीं है।Events Manager → Test events से कोड कॉपी करें, डेस्टिनेशन पर सेव करें और फिर कोशिश करें।
पंक्ति में Reconnect credentials दिख रहा हैFacebook लॉगिन एक्सपायर हो गया (लगभग 60 दिन) या टोकन रद्द हुआ।डेस्टिनेशन खोलें और Reconnect Facebook पर क्लिक करें, या नया टोकन पेस्ट करें।
Meta में ख़रीद दो बार गिनी जा रही हैसाइट का Pixel ख़रीद को अलग इवेंट ID के साथ रिपोर्ट करता है।साइट से AffClix कन्वर्ज़न ID को Pixel के इवेंट ID के रूप में भेजें, या सिर्फ़ सर्वर इवेंट पर निर्भर रहें।
कन्वर्ज़न AffClix में हैं पर Meta में नहींवे अभी अप्रूव नहीं हुए, या उनके गोल की इवेंट मैप में पंक्ति नहीं है और * पंक्ति भी नहीं है।कन्वर्ज़न अप्रूव करें, या गोल के लिए मैपिंग जोड़ें।

निष्कर्ष

Meta कनेक्ट होने पर आपके पार्टनर्स का हर अप्रूव्ड कन्वर्ज़न सर्वर से आपके डेटासेट तक पहुँचता है — सही इवेंट नाम, असली वैल्यू और आपकी अनुमति वाले पहचान सिग्नल के साथ — इसलिए Meta असली बिक्री पर रिपोर्ट और ऑप्टिमाइज़ करता है। हर दो महीने के आसपास Facebook लॉगिन रिन्यू करें और CAPI Delivery रिपोर्ट पर नज़र रखें।

नोट

Meta को सिर्फ़ अप्रूव्ड कन्वर्ज़न भेजे जाते हैं। पेंडिंग, रिजेक्टेड और कटबैक कन्वर्ज़न कभी नहीं भेजे जाते; जो कन्वर्ज़न बाद में अप्रूव होता है, वह अप्रूव होते ही भेज दिया जाता है।

संबंधित लेख: Conversions API ओवरव्यू · Google Ads Conversions API · WebSDK के साथ Meta Ads

इस लेख को रेट करें
★★★★★
रेटिंग के लिए धन्यवाद!

क्या यह लेख उपयोगी था?