कार्यान्वयन
खास जानकारी
कन्वर्ज़न ट्रैकिंग को तीन तरह से लागू किया जाता है:
- लैंडिंग पेज / ऐप्लिकेशन के एंट्री पॉइंट से
rwg_token
औरmerchant_id
इकट्ठा करना. - सही एट्रिब्यूशन विंडो के लिए,
rwg_token
औरmerchant_id
को बनाए रखना. - कन्वर्ज़न के समय, मौजूदा
merchant_id
औरmerchant_id
की तुलना करें (बुकिंग पूरी हुई). - कन्वर्ज़न के समय कन्वर्ज़न इवेंट भेजना (बुकिंग पूरी हुई).
कन्वर्ज़न ट्रैकिंग लागू करने की इस प्रोसेस के लिए, आपको Google Analytics या किसी तीसरे पक्ष की JavaScript का इस्तेमाल करने की ज़रूरत नहीं है.
कन्वर्ज़न ट्रैकिंग लागू करने का काम शुरू करने से पहले, आपको यह तय कर लेना चाहिए कि आपको डिवाइस लेवल पर कन्वर्ज़न ट्रैक करने हैं या उपयोगकर्ता के लेवल पर:
- डिवाइस लेवल में ब्राउज़र कुकी, लोकल स्टोरेज, ऐप्लिकेशन का लोकल स्टोरेज या किसी ऐसे अन्य तरीके का इस्तेमाल करना शामिल है जो 30 दिन की एट्रिब्यूशन विंडो के लिए टोकन को बनाए रख सकता है. टोकन, उपयोगकर्ता के डिवाइस पर स्थानीय तौर पर सेव किया जाएगा. इसलिए, अगर उपयोगकर्ता अपने डिवाइस को बदलता है, तो उसका लोकल स्टोरेज या कुकी मिट जाता है. इसके अलावा, अगर निजी ब्राउज़िंग या गुप्त मोड का इस्तेमाल किया जा रहा है, तो हो सकता है कि कन्वर्ज़न इवेंट को सही तरीके से एट्रिब्यूट न किया जाए. डिवाइस लेवल पर कन्वर्ज़न ट्रैकिंग का इस्तेमाल करते समय, आपको इसे हर उस प्लैटफ़ॉर्म (जिसमें मोबाइल भी शामिल है) पर फिर से लागू करना होगा.
- उपयोगकर्ता लेवल में इसे सर्वर साइड ऐनलिटिक्स सिस्टम या दूसरे सर्वर साइड सिस्टम की मदद से, आपके ऐप्लिकेशन के डेटाबेस में बनाए रखना शामिल होता है. टोकन सर्वर साइड पर सेव किया जाता है. इसलिए, अगर उपयोगकर्ता अपने डिवाइस को बदलता है, लोकल स्टोरेज या कुकी को मिटा देता है या निजी ब्राउज़िंग या गुप्त मोड का इस्तेमाल करता है, तो उपयोगकर्ता के फिर से लॉग इन करने के बाद भी कन्वर्ज़न इवेंट को एट्रिब्यूट किया जाएगा. उपयोगकर्ता लेवल पर कन्वर्ज़न ट्रैकिंग का इस्तेमाल करते समय, आपके सिस्टम के आर्किटेक्चर के आधार पर, उसे अपने सर्वर साइड पर एक बार लागू किया जा सकता है. साथ ही, इस्तेमाल किए जा सकने वाले सभी प्लैटफ़ॉर्म पर इसका फिर से इस्तेमाल किया जा सकता है.
rwg_token
इकट्ठा किया जा रहा है
जब भी Google, फ़ीड के ज़रिए दिए गए action_link को दिखाता है, तो उस यूआरएल में एक यूनीक क्वेरी पैरामीटर शामिल करने के लिए बदलाव किया जाता है: rwg_token
. rwg_token
वैल्यू, कोड में बदली गई एक स्ट्रिंग है. इसमें उपयोगकर्ता के क्लिक किए गए लिंक के बारे में कुछ मेटाडेटा होता है, लेकिन उपयोगकर्ता का डेटा मौजूद नहीं होता. आपको इस टोकन को सेव करके
कन्वर्ज़न इवेंट के हिस्से के तौर पर वापस पास करना होगा.
हर लैंडिंग पेज / ऐप्लिकेशन के एंट्री पॉइंट पर, आपको rwg_token
क्वेरी पैरामीटर के लिए सेट की गई वैल्यू को पार्स करना होगा और उसे स्टोर करना होगा. इस पैरामीटर को सेव करने की ज़रूरी शर्तों के बारे में इस चरण में बताया गया है. इसमें rwg_token
को लागू करना भी शामिल है.
नीचे एक उदाहरण दिया गया है, जिसमें बताया गया है कि ब्राउज़र के ज़रिए डिवाइस लेवल पर ट्रैकिंग के लिए, इस टोकन को कैसे पार्स किया जा सकता है. इसके अलावा, अनुरोध को पूरा करते समय सर्वर साइड पर भी इस टोकन को इकट्ठा किया जा सकता है:
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;
}
}
merchant_id
इकट्ठा किया जा रहा है
अगर फ़्रंटएंड में कन्वर्ज़न ट्रैकिंग लॉजिक को लागू किया जाता है, तो लैंडिंग पेज पर आपको एक कस्टम स्क्रिप्ट लागू करनी होगी. यह स्क्रिप्ट, merchant_id
को ढूंढकर कैप्चर करेगी. आम तौर पर, लैंडिंग पेज या यूआरएल में merchant_id
पहले से मौजूद हो सकता है, ताकि आप उसे वहां से कैप्चर कर सकें. अगर ऐसा नहीं है,
तो आपको इसे कहीं दिखाने का तरीका खोजना होगा, ताकि इसे दिखाया जा सके.
इससे, बैकएंड में बदलाव हो सकते हैं.
अगर बैकएंड में कन्वर्ज़न ट्रैकिंग लॉजिक लागू किया जाता है, तो आपको उस डेटा के साथ merchant_id
दिख सकता है जो आपके सिस्टम से फ़्रंटएंड पेज जनरेट करने के लिए क्वेरी करता है.
यह merchant_id
वही होना चाहिए जो आपने अपने फ़ीड में Google के साथ शेयर किया है.
rwg_token
और merchant_id
को बनाए रखा जा रहा है
आपको rwg_token
यूआरएल पैरामीटर को बनाए रखना होगा. इस पैरामीटर को आपके दिए गए सभी कार्रवाई लिंक पर जोड़ा जाएगा. इसे कुल 30 दिनों तक इस्तेमाल करना होगा.
rwg_token
की वैल्यू को सेव किया जाना चाहिए और बिना किसी बदलाव के वापस दिया जाना चाहिए.
rwg_token
के साथ-साथ, आपको कार्रवाई लिंक से जुड़े merchant_id
भी सेव करने होंगे.
अगर पिछली बार वेबसाइट पर आने के बाद भी कोई मौजूदा टोकन सेव रखा गया है, तो उससे पहले के rwg_token
और merchant_id
टोकन को बदला जाना चाहिए. साथ ही, स्टोरेज के लिए 30 दिन की विंडो को रीसेट किया जाना चाहिए.
ऊपर दिए गए पेयर को जारी रखते हुए, इन वैल्यू को डिवाइस या उपयोगकर्ता के लेवल पर सेव किया जा सकता है:
- डिवाइस लेवल में ब्राउज़र कुकी, लोकल स्टोरेज, ऐप्लिकेशन का लोकल स्टोरेज या किसी ऐसे अन्य तरीके का इस्तेमाल करना शामिल है जो 30 दिन की एट्रिब्यूशन विंडो के लिए टोकन को बनाए रख सकता है.
- उपयोगकर्ता लेवल में इसे सर्वर साइड ऐनलिटिक्स सिस्टम या दूसरे सर्वर साइड सिस्टम की मदद से, आपके ऐप्लिकेशन के डेटाबेस में बनाए रखना शामिल होता है.
नीचे डिवाइस लेवल पर कन्वर्ज़न ट्रैकिंग का एक उदाहरण दिया गया है. इसमें पहले पक्ष वाली कुकी का इस्तेमाल करके, इन वैल्यू को वेब ब्राउज़र में स्टोर किया जाता है. इस उदाहरण में यह माना गया है कि आपने टोकन की वैल्यू को ऊपर दिए गए उदाहरण की तरह, वैरिएबल में पार्स किया है. इस उदाहरण का इस्तेमाल करने के लिए, आपको
rootdomain.com
को अपने डोमेन में अपडेट करना होगा.
if (typeof rwg_token !== 'undefined') {
document.cookie =
"_rwg_token=" + rwg_token + ";_merchant_id=" + merchantid + ";max-age=2592000;domain=rootdomain.com;path=/";
}
यूज़र लेवल कन्वर्ज़न ट्रैकिंग का इस्तेमाल करते समय, rwg_token
+ merchant_id
सर्वर पर सेव होना चाहिए और उपयोगकर्ता के साथ जुड़ा होना चाहिए.
कन्वर्ज़न डेटा भेजा जा रहा है
जब कोई उपयोगकर्ता ऐसा लेन-देन पूरा करता है जो 'Google प्लेस ऐक्शन' लिंक के तहत आता है, तो आपको कन्वर्ज़न एंडपॉइंट पर एक एचटीटीपी पोस्ट अनुरोध भेजना होगा. दो एंडपॉइंट होते हैं. एक प्रोडक्शन एनवायरमेंट के लिए और दूसरा सैंडबॉक्स एनवायरमेंट के लिए.
- प्रोडक्शन: 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>,
"merchant_changed": 1|2
}
उदाहरण (पार्टनर 20123456 के लिए टेस्ट टोकन के साथ कारोबारी या कंपनी में कोई बदलाव नहीं हुआ है):
{
"conversion_partner_id": 20123456,
"rwg_token": "AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==",
"merchant_changed": 2
}
व्यापारी/कंपनी/कारोबारी की वैल्यू में बदलाव की वैल्यू का इस्तेमाल यह तय करने के लिए किया जाता है कि शुरुआती रीडायरेक्ट वाले व्यापारी/कंपनी/कारोबारी से, कारोबारी या कंपनी को बदला गया है या नहीं. इसमें दो वैल्यू दी गई हैं, जिन्हें पास किया जा सकता है
मर्चेंट परिवर्तन मान | ज़रूरी शर्त |
---|---|
1 | इस वैल्यू का इस्तेमाल तब करना चाहिए, जब कोई व्यक्ति |
2 | इस वैल्यू का इस्तेमाल तब करना चाहिए, जब ग्राहक ने ओरिजनल इकाई (कारोबारी) के ज़रिए लेन-देन पूरा किया हो. |
सैंडबॉक्स और प्रोडक्शन, दोनों में आपको कन्वर्ज़न इवेंट भेजते समय
एक मान्य rwg_token
देना होगा. टेस्टिंग के लिए, दोनों एनवायरमेंट में नीचे दिए गए टेस्ट टोकन का तब तक इस्तेमाल करें, जब तक कि आप इसे लॉन्च न कर दें:
AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==
सैंडबॉक्स में टेस्ट करने के लिए, आपको अपने सैंडबॉक्स लिंक में मैन्युअल तरीके से ये यूआरएल पैरामीटर जोड़ने होंगे:
rwg_token=AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ%3D%3D
पोस्ट का अनुरोध करने के तरीके के बारे में 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,
merchant_changed: merchantChanged
})
});
}
उपयोगकर्ता लेवल पर कन्वर्ज़न ट्रैकिंग का इस्तेमाल करते समय, आपको उस टोकन को फिर से हासिल करना चाहिए जो आपके सर्वर साइड स्टोरेज सिस्टम से उपयोगकर्ता से जुड़ा होता है (चाहे वे किसी भी प्लैटफ़ॉर्म पर हों). साथ ही, उसी प्रोडक्शन या सैंडबॉक्स एंडपॉइंट का इस्तेमाल करके टोकन भेजना चाहिए.
कन्वर्ज़न एट्रिब्यूशन से जुड़ी ज़रूरी शर्तें
कन्वर्ज़न एट्रिब्यूशन के लिए Google के लिए ज़रूरी स्टैंडर्ड, 30 दिन की एट्रिब्यूशन विंडो है. यह किसी भी स्टोर में, जगह के लिंक के साथ होने वाले किसी भी इंटरैक्शन के लिए है.
इस एट्रिब्यूशन विंडो का मतलब है कि Google को इनमें से किसी भी स्थिति में कन्वर्ज़न इवेंट भेजा जाएगा:
- इस इमेज में दिखाया गया है कि एक उपयोगकर्ता, कार्रवाई करने के लिंक पर जाकर उसी सेशन में एक ही कारोबारी या कंपनी के लिए ऑर्डर करता है. (कारोबारी या कंपनी के बदलाव की वैल्यू = 2 )
- कोई उपयोगकर्ता कार्रवाई करने के लिंक पर क्लिक करके, 30 दिन के अंदर किसी दूसरे चैनल से वापस आकर उसी कारोबारी या कंपनी के लिए ऑर्डर कर सकता है. (कारोबारी या कंपनी का वैल्यू में बदलाव = 2 )
- ऐसा करने के बाद, उपयोगकर्ता कार्रवाई करने के लिंक को फ़ॉलो करके किसी दूसरे स्टोर में ऑर्डर करता है. चाहे वह उसी सेशन में हो या 30 दिन की विंडो के अंदर किसी दूसरे सेशन में. ( मर्चेंट परिवर्तन मान = 1 )
इसके अलावा, Google उम्मीद करता है कि कन्वर्ज़न इवेंट उन सभी प्लैटफ़ॉर्म से भेजे जाएं जहां उपयोगकर्ता कार्रवाई करने वाले लिंक से उपयोगकर्ता जा सकता है. इसमें ये शामिल हैं:
- डेस्कटॉप या मोबाइल वेब ऐप्लिकेशन
- किसी ऐप्लिकेशन डीप लिंक के ज़रिए या आपके डोमेन के लिए रजिस्टर किए गए ऐप्लिकेशन इंटेंट के ज़रिए मोबाइल ऐप्लिकेशन
अगर टोकन को उपयोगकर्ता के लेवल पर सेव किया जाता है (टोकन में बदलाव होता रहता है), तो यह उम्मीद की जाती है कि आपने क्रॉस-डिवाइस एट्रिब्यूशन दिया होगा. इसका मतलब है कि ऐसे उपयोगकर्ता को कन्वर्ज़न इवेंट ट्रिगर करना चाहिए जो डेस्कटॉप पर मौजूद ऐक्शन लिंक को फ़ॉलो करके, मोबाइल पर लेन-देन पूरा करता है.
अगर टोकन को खास तौर पर डिवाइस के लेवल पर सेव किया जाता है, जैसे कि ब्राउज़र कुकी में, तो आपको क्रॉस-डिवाइस एट्रिब्यूशन देने की ज़रूरत नहीं है. इस मामले में, अगर उपयोगकर्ता ने उस डिवाइस पर ऐक्शन लिंक को फ़ॉलो किया है, तो हर डिवाइस के लिए एक अलग टोकन मौजूद होगा. साथ ही, हर डिवाइस, एट्रिब्यूशन के नियमों का अलग-अलग पालन करेगा.