Conversions API
ब्राउज़र के बजाय हमारे सर्वर से अपने लक्ष्य Meta, LinkedIn, TikTok और Google Ads को भेजें — केवल नेटवर्क के अपने क्लिक पहचानकर्ता से मिलान।
1. सर्वर से क्यों?
रूपांतरण बताने से पहले ब्राउज़र पिक्सेल को तीन बाधाएँ पार करनी हैं: विज्ञापन अवरोधक, ट्रैकिंग रोकने की सेटिंग और पिक्सेल चलने से पहले टैब बंद होना। सर्वर कॉल तीनों से बचता है क्योंकि ब्राउज़र में होता ही नहीं।
MousePlayer को पहले से पता है लक्ष्य कब पूरा हुआ — लक्ष्य इसी लिए हैं। Conversions 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 से या UET टैग की लिखी कुकी से: _uetmsclkid |
कभी नहीं भेजते: ईमेल, फ़ोन, नाम या 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 अपवाद है और शुरुआत से कारण जानें: बाकी तीन के विपरीत आसान एक्सेस टोकन नहीं देता। OAuth और रीफ़्रेश टोकन से पहुँच है; Ads API को अतिरिक्त चाहिए: डेवलपर टोकन।
| फ़ील्ड | कहाँ मिलता है |
|---|---|
| ग्राहक ID | Google Ads में ऊपर दाईं ओर। केवल अंक, डैश बिना। |
| रूपांतरण क्रिया ID | लक्ष्य और रूपांतरण, फिर वह क्रिया जिसमें दर्ज करना है। |
| डेवलपर टोकन | आपके Google Ads मैनेजर खाते का API Center। |
| OAuth क्लाइंट ID और सीक्रेट | Google Cloud Console, क्रेडेंशियल, "डेस्कटॉप ऐप" प्रकार का OAuth क्लाइंट। |
| रीफ़्रेश टोकन | इसे एक बार खुद बनाएँ इस स्कोप के लिए: adwords। |
LinkedIn के दो रास्ते, छोटा वाला चुनें
Campaign Manager में: डेटा, Signals Manager, Direct API, एक्सेस टोकन बनाएँ। अपना डेटा भेजने वाले विज्ञापनदाता का रास्ता — डेवलपर ऐप या समीक्षा नहीं। टोकन समाप्त नहीं होता और दोबारा नहीं दिखता, इसलिए तुरंत कॉपी करें।
LinkedIn Developer Portal से डेवलपर ऐप वाला दूसरा रास्ता कई विज्ञापनदाताओं की ओर से भेजने वाले प्लेटफ़ॉर्म के लिए है। कंपनी पृष्ठ सत्यापन और स्वीकृत उपयोग चाहिए; यहाँ ज़रूरत नहीं।
Microsoft Advertising आसान है
Google Ads के बाद OAuth, डेवलपर टोकन और स्वीकृति जैसे बोझ की उम्मीद होगी। उलटा है: दो फ़ील्ड। ब्राउज़र वाला UET टैग ID और Microsoft Advertising में UET टैग, "Conversions API उपयोग करें", "टोकन कॉपी करें" से टोकन। आवेदन नहीं।
ब्राउज़र टैग वाली वही ID उपयोग करें। इसी से Microsoft सर्वर और ब्राउज़र इवेंट को दो के बजाय एक रूपांतरण पहचानता है।
डेवलपर टोकन को Google की स्वीकृति चाहिए ("Basic access"), कुछ दिन लगते हैं। एक मिनट में न होने वाला यही चरण पहले शुरू करें। आपका Google पासवर्ड कभी नहीं देखते — केवल रीफ़्रेश टोकन, जिसे कभी भी रद्द कर सकते हैं।
5. रूपांतरण कब भेजता है
हर लक्ष्य और सत्र पर ठीक एक बार। भेजने से पहले MousePlayer दोहराव रोकता है; पेलोड ID से नेटवर्क अपनी ओर भी रोकता है। पाँच वस्तु कार्ट में डालने वाला एक रूपांतरण देता है, पाँच नहीं।
विज्ञापन खाते में क्या दिखेगा
रूपांतरण में लक्ष्य नाम, तय हो तो मूल्य और मुद्रा तथा समय आता है। सामान्य रूप से एक मिनट में पहुँचता है।
कुछ न आए तो
- क्लिक पहचानकर्ता नहीं। आगंतुक उस नेटवर्क के विज्ञापन से नहीं आया या पिक्सेल की कुकी से पहले आया। कुछ नहीं जाता — अपेक्षित है, त्रुटि नहीं।
- सहमति नहीं। अवरोध पहले था।
- नेटवर्क ने कॉल स्वीकारा, रूपांतरण नहीं। Google, TikTok और कई अन्य HTTP 200 के साथ बॉडी में त्रुटि देते हैं। हम केवल स्थिति नहीं, बॉडी पढ़ते हैं और कारण डिलीवरी लॉग में आता है।
यहाँ बताए ट्रेडमार्क संबंधित स्वामियों के हैं। MousePlayer का इन प्रदाताओं से व्यावसायिक संबंध नहीं।