लागू करना
खास जानकारी
कन्वर्ज़न ट्रैकिंग लागू करने के तीन चरण होते हैं:
-
लैंडिंग पेज / ऐप्लिकेशन के एंट्री पॉइंट से
rwg_token
को इकट्ठा करना. -
सही एट्रिब्यूशन विंडो के लिए,
rwg_token
को बनाए रखना - चेकआउट के समय कन्वर्ज़न इवेंट भेजना
इस कन्वर्ज़न ट्रैकिंग को लागू करने के लिए, आपको Google Analytics या तीसरे पक्ष के किसी भी JavaScript का इस्तेमाल करने की ज़रूरत नहीं है.
कन्वर्ज़न ट्रैकिंग लागू करने से पहले, आपको यह तय करना चाहिए कि आपको डिवाइस लेवल पर कन्वर्ज़न ट्रैक करने हैं या उपयोगकर्ता लेवल पर:
- डिवाइस लेवल में ब्राउज़र कुकी, लोकल स्टोरेज, ऐप्लिकेशन का लोकल स्टोरेज या 30 दिन की एट्रिब्यूशन विंडो के लिए टोकन को बनाए रखने वाला कोई भी अन्य तरीका शामिल है. टोकन, उपयोगकर्ता के डिवाइस पर लोकल स्टोरेज में सेव किया जाता है. इसलिए, अगर उपयोगकर्ता अपना डिवाइस बदलता है, अपना लोकल स्टोरेज/कुकी मिटाता है या निजी ब्राउज़िंग या गुप्त मोड का इस्तेमाल करता है, तो हो सकता है कि कन्वर्ज़न इवेंट को सही तरीके से एट्रिब्यूट न किया जा सके. डिवाइस लेवल पर कन्वर्ज़न ट्रैकिंग का इस्तेमाल करते समय, आपको इसे हर उस प्लैटफ़ॉर्म पर फिर से लागू करना होगा जिस पर यह काम करता है. इसमें मोबाइल भी शामिल है.
- उपयोगकर्ता लेवल में, सर्वर साइड के आंकड़ों के सिस्टम या अन्य सर्वर साइड सिस्टम की मदद से, इसे अपने ऐप्लिकेशन के डेटाबेस में सेव करना शामिल है. टोकन को सर्वर साइड पर सेव किया जाएगा. इसलिए, अगर उपयोगकर्ता अपना डिवाइस बदलता है, अपना लोकल स्टोरेज/कुकी मिटाता है या निजी ब्राउज़िंग या गुप्त मोड का इस्तेमाल करता है, तो उपयोगकर्ता के फिर से लॉग इन करने के बाद भी कन्वर्ज़न इवेंट को एट्रिब्यूट किया जाएगा. उपयोगकर्ता लेवल पर कन्वर्ज़न ट्रैकिंग का इस्तेमाल करते समय, आपके सिस्टम के आर्किटेक्चर के आधार पर, इसे अपने सर्वर साइड पर एक बार लागू किया जा सकता है. साथ ही, इसे उन सभी प्लैटफ़ॉर्म पर फिर से इस्तेमाल किया जा सकता है जिन पर यह काम करता है.
rwg_token
इकट्ठा करना
जब भी Google, फ़ीड के ज़रिए आपके दिए गए action_link
को दिखाएगा, तो उस यूआरएल में बदलाव किया जाएगा, ताकि उसमें एक यूनीक क्वेरी पैरामीटर शामिल किया जा सके: rwg_token
. rwg_token
वैल्यू, एन्क्रिप्ट (सुरक्षित) की गई स्ट्रिंग होती है. इसमें, उस लिंक के बारे में कुछ मेटाडेटा होता है जिस पर उपयोगकर्ता ने क्लिक किया है. आपको इस टोकन को सेव करना होगा और इसे कन्वर्ज़न इवेंट के हिस्से के तौर पर वापस भेजना होगा.
आपको हर लैंडिंग पेज / ऐप्लिकेशन एंट्री पॉइंट पर, rwg_token
क्वेरी पैरामीटर के लिए सेट की गई वैल्यू को पार्स करके सेव करना होगा. इस पैरामीटर को सेव करने की ज़रूरी शर्तों के बारे में, rwg_token
को सेव करने के चरण में बताया गया है.
ब्राउज़र के ज़रिए डिवाइस लेवल पर ट्रैकिंग के लिए, इस टोकन को पार्स करने का उदाहरण यहां दिया गया है. इसके अलावा, अनुरोध का जवाब देते समय, इस टोकन को सर्वर साइड पर भी इकट्ठा किया जा सकता है:
<script> var query = location.search.substring(1); var params = query.split('&'); var rwgToken = undefined; for (var i = 0; i < params.length; ++i) { var pair = params[i].split('='); if (pair[0] == 'rwg_token') { rwgToken = decodeURIComponent(pair[1]); break; } } </script>
rwg_token
को बनाए रखना
आपको rwg_token
यूआरएल पैरामीटर को बनाए रखना होगा. इसे आपके दिए गए सभी ऐक्शन लिंक में, 30 दिनों तक जोड़ दिया जाएगा. rwg_token
की वैल्यू को बिना किसी बदलाव के सेव और दिखाया जाना चाहिए.
अगर पिछली विज़िट से कोई मौजूदा टोकन सेव है, तो उस टोकन को बदल दिया जाना चाहिए और स्टोरेज के लिए 30 दिन की विंडो को रीसेट कर दिया जाना चाहिए.
टोकन को सेव करते समय, आपके पास टोकन को डिवाइस के लेवल पर या उपयोगकर्ता के लेवल पर सेव करने का विकल्प होता है:
- डिवाइस लेवल में ब्राउज़र कुकी, लोकल स्टोरेज, ऐप्लिकेशन का लोकल स्टोरेज या 30 दिन की एट्रिब्यूशन विंडो के लिए टोकन को बनाए रखने वाला कोई भी अन्य तरीका शामिल है.
- उपयोगकर्ता लेवल में, सर्वर साइड के आंकड़े वाले सिस्टम या अन्य सर्वर साइड सिस्टम की मदद से, इसे अपने ऐप्लिकेशन डेटाबेस में सेव करना शामिल है.
यहां डिवाइस लेवल पर कन्वर्ज़न ट्रैकिंग का उदाहरण दिया गया है. इसमें, पहले पक्ष की कुकी की मदद से, वेब ब्राउज़र में टोकन को सेव किया गया है. इस उदाहरण में यह माना गया है कि आपने ऊपर दिए गए उदाहरण की तरह, टोकन की वैल्यू को वैरिएबल में पार्स किया है. इस उदाहरण का इस्तेमाल करने के लिए, आपको “rootdomain” को अपने डोमेन पर अपडेट करना होगा.
<script> if (typeof rwg_token !== 'undefined') { document.cookie = "_rwg_token=" + rwg_token + ";max-age=2592000;domain=rootdomain.com;path=/"; } </script>
उपयोगकर्ता-लेवल कन्वर्ज़न ट्रैकिंग का इस्तेमाल करते समय, rwg_token
को
सर्वर पर सेव किया जाना चाहिए और उपयोगकर्ता से जोड़ा जाना चाहिए.
कन्वर्ज़न डेटा भेजना
जब कोई उपयोगकर्ता किसी ऐसे लेन-देन को पूरा करता है जिसे Google Place ऐक्शन लिंक से एट्रिब्यूट किया जाता है, तो आपको कन्वर्ज़न एंडपॉइंट पर एचटीटीपी पोस्ट अनुरोध भेजना होगा. दो एंडपॉइंट होते हैं, एक प्रोडक्शन एनवायरमेंट के लिए और एक सैंडबॉक्स एनवायरमेंट के लिए.
- प्रोडक्शन:
https://www.google.com/maps/conversion/collect
- सैंडबॉक्स:
https://www.google.com/maps/conversion/debug/collect
पोस्ट का मुख्य हिस्सा, इस फ़ॉर्मैट में JSON कोड में बदला गया ऑब्जेक्ट होना चाहिए:
{ 'conversion_partner_id': partnerId, 'rwg_token': <rwg_token_val> }
सैंडबॉक्स और प्रोडक्शन, दोनों एनवायरमेंट में आपको कन्वर्ज़न इवेंट भेजते समय,
मान्य rwg_token
देना होगा.
सैंडबॉक्स एनवायरमेंट में टेस्ट करने के लिए, यहां दिए गए
टेस्ट टोकन का इस्तेमाल किया जा सकता है.
AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==
इस पोस्ट अनुरोध को बनाने का तरीका बताने के लिए, यहां डिवाइस लेवल पर कन्वर्ज़न ट्रैकिंग (उपयोगकर्ता के डिवाइस पर कुकी का इस्तेमाल करके) का पूरा उदाहरण दिया गया है. यह उदाहरण, JavaScript में दिया गया है:
const partnerId = XXXXXXXXXX; const endpoint = `https://www.google.com/maps/conversion/collect`; const rwgTokenCookie = document.cookie .split('; ') .find(row => row.startsWith('_rwg_token=')); if (typeof rwgTokenCookie !== 'undefined') { const rwgTokenVal = rwgTokenCookie.split('=')[1]; fetch(endpoint, { method: "POST", body: JSON.stringify({ conversion_partner_id: partnerId, rwg_token: rwgTokenVal }) }); }
उपयोगकर्ता लेवल की कन्वर्ज़न ट्रैकिंग का इस्तेमाल करते समय, आपको अपने सर्वर साइड स्टोरेज के तरीके से, उपयोगकर्ता से जुड़ा टोकन वापस पाना चाहिए. भले ही, वह किसी भी प्लैटफ़ॉर्म पर हो. साथ ही, उसी प्रोडक्शन या सैंडबॉक्स एंडपॉइंट का इस्तेमाल करके टोकन भेजना चाहिए.
कन्वर्ज़न एट्रिब्यूशन से जुड़ी ज़रूरी शर्तें
Google के मुताबिक, कन्वर्ज़न एट्रिब्यूशन के लिए ज़रूरी स्टैंडर्ड, किसी भी स्टोर में जगह के लिंक के साथ किसी भी इंटरैक्शन के लिए 30 दिन की एट्रिब्यूशन विंडो है.
इस एट्रिब्यूशन विंडो का मतलब है कि हम उम्मीद करते हैं कि इनमें से किसी भी स्थिति में कन्वर्ज़न इवेंट भेजा जाएगा:
- कोई उपयोगकर्ता, जगह की जानकारी के लिए दिए गए लिंक पर क्लिक करता है और उसी सेशन में ऑर्डर देता है
- कोई उपयोगकर्ता, प्लेस ऐक्शन के लिंक पर क्लिक करता है और फिर ऑर्डर देने के लिए, 30 दिन की विंडो के अंदर किसी दूसरे चैनल से वापस आता है.
- कोई उपयोगकर्ता, जगह की जानकारी देने वाले लिंक पर क्लिक करता है. इसके बाद, वह 30 दिन की विंडो के अंदर, उसी सेशन या किसी दूसरे सेशन में किसी दूसरे स्टोर से ऑर्डर करता है.
इसके अलावा, हमें उम्मीद है कि कन्वर्ज़न इवेंट उन सभी प्लैटफ़ॉर्म से भेजे जाएंगे जहां उपयोगकर्ता, प्लेस ऐक्शन लिंक से पहुंच सकता है. इसमें ये शामिल हैं:
- डेस्कटॉप या मोबाइल वेब ऐप्लिकेशन
- मोबाइल ऐप्लिकेशन, ऐप्लिकेशन के डीप लिंक या आपके डोमेन के लिए रजिस्टर किए गए ऐप्लिकेशन इंटेंट के ज़रिए
अगर टोकन को उपयोगकर्ता लेवल पर सेव किया गया है (टोकन को सेव करना देखें), तो उम्मीद है कि आप क्रॉस-डिवाइस एट्रिब्यूशन उपलब्ध कराएंगे. इसका मतलब है कि अगर कोई उपयोगकर्ता, डेस्कटॉप से किसी ऐक्शन लिंक पर जाता है और फिर उसी उपयोगकर्ता खाते का इस्तेमाल करके मोबाइल पर लेन-देन पूरा करता है, तो एक कन्वर्ज़न इवेंट ट्रिगर होना चाहिए.
अगर टोकन सिर्फ़ डिवाइस लेवल पर सेव किया जाता है, जैसे कि ब्राउज़र कुकी में, तो हो सकता है कि आप क्रॉस-डिवाइस एट्रिब्यूशन न दें. इस मामले में, अगर उपयोगकर्ता ने उस डिवाइस पर किसी ऐक्शन लिंक का इस्तेमाल किया है, तो हर डिवाइस पर एक अलग टोकन सेव रहेगा. साथ ही, हर डिवाइस पर एट्रिब्यूशन के नियम अलग-अलग लागू होंगे.