gtag.js स्निपेट के बारे में जानकारी
अगर आपकी मौजूदा Universal Analytics प्रॉपर्टी के लिए analytics.js का इस्तेमाल हो रहा है, तो अपनी नई Google Analytics 4 प्रॉपर्टी के लिए gtag.js स्निपेट जोड़ना होगा. gtag.js स्निपेट का स्ट्रक्चर यहां बताया गया है:
01: <script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></script>
02: <script>
03: window.dataLayer = window.dataLayer || [];
04: function gtag(){dataLayer.push(arguments);}
05: gtag('js', new Date());
06:
07: gtag('config', '<Some Property ID A>');
08:
09: gtag('config', '<Some Property ID B>');
10:
11: gtag('event', 'sign_up', { 'method': 'email' });
12:
13: gtag('event', 'view_video', { 'send_to': '<Some Property ID B>' });
14:
15: </script>
लाइन 7: gtag "config" डायरेक्टिव, <प्रॉपर्टी आईडी A> से जुड़ी प्रॉपर्टी में डेटा इकट्ठा करने की सुविधा चालू करता है. उदाहरण के लिए, किसी Google Analytics 4 प्रॉपर्टी के टैग आईडी के साथ, यह डायरेक्टिव जोड़ने से उस प्रॉपर्टी को page_view इवेंट भेजे जाएंगे.
प्रॉपर्टी आईडी में UA प्रॉपर्टी ("UA-XXXXXXXX"), Google Analytics 4 प्रॉपर्टी ("G-XXXXXXXX"), Google Ads ("AW-XXXXXXXX") या Floodlight ("DC-XXXXXXXX) जैसे अलग-अलग Google प्रॉडक्ट शामिल हो सकते हैं.
लाइन 11: gtag "इवेंट" निर्देश एक इवेंट भेजेगा. ऐसे स्निपेट जहां एक से ज़्यादा प्रॉपर्टी के लिए एक से ज़्यादा "config" निर्देश मौजूद हैं वहां इवेंट सभी प्रॉपर्टी पर भेजा जाएगा.
इस उदाहरण में, "sign_up" पैरामीटर ही इवेंट का नाम है. आखिरी पैरामीटर वह ऑब्जेक्ट है जिसमें इवेंट पैरामीटर का सेट मौजूद होता है. इस मामले में, "method" एक पैरामीटर है जिसकी वैल्यू "email" है.
लाइन 13: यहां दिए गए इवेंट का पैरामीटर "send_to" है. यह एक खास पैरामीटर है, जो इससे जुड़े इवेंट को किसी खास प्रॉपर्टी में "रूट" करता है. दूसरे शब्दों में, यह इवेंट सिर्फ़ <प्रॉपर्टी आईडी B> से दिखने वाली प्रॉपर्टी को भेजा जाएगा.
किसी Google Analytics 4 प्रॉपर्टी के लिए बुनियादी डेटा इकट्ठा करने की सुविधा, gtag के "config" डायरेक्टिव की मदद से चालू की जाती है. साथ ही, जब यह टैग किसी पेज पर लोड होता है, तब page_view इवेंट अपने-आप इकट्ठा होने वाले इवेंट के तौर पर इकट्ठा होने लगते हैं.
पेज व्यू हिट या page_view इवेंट को खास पैरामीटर का इस्तेमाल करके, बदला या ब्लॉक किया जा सकता है.
प्रॉपर्टी आइडेंटिफ़ायर
Universal Analytics प्रॉपर्टी आईडी, "UA-XXXXXXXX" फ़ॉर्मैट में होते हैं. इसे कभी-कभी ट्रैकिंग आईडी भी कहा जाता है. इस गाइड में, इसे UA प्रॉपर्टी आईडी कहा जाएगा.
Google Analytics 4 प्रॉपर्टी के लिए, वेबसाइट की डेटा स्ट्रीम, "G-XXXXXXXX" फ़ॉर्मैट वाले टैग आईडी का इस्तेमाल करती हैं.
कोड के कुछ उदाहरणों और दस्तावेज़ों में, आपको दोनों "TAG_ID" के तौर पर दिख सकते हैं.
बुनियादी डेटा इकट्ठा करना
किसी Google Analytics 4 प्रॉपर्टी के लिए बुनियादी डेटा इकट्ठा करने की सुविधा चालू करके, ये चीज़ें भी इकट्ठा की जा सकती हैं:
- page_view इवेंट
- अपने-आप इकट्ठा होने वाले इवेंट
- बेहतर मेज़रमेंट वाले इवेंट (यूज़र इंटरफ़ेस (यूआई) में चालू होने पर)
अपनी Google Analytics 4 प्रॉपर्टी के लिए बुनियादी डेटा इकट्ठा करने की सुविधा चालू करने के लिए, हर पेज के <head> सेक्शन में gtag.js स्निपेट (Google टैग) जोड़ें.
analytics.js स्निपेट की तुलना में gtag.js स्निपेट
Google Analytics 4 प्रॉपर्टी के लिए, gtag.js स्निपेट वही काम करता है जो analytics.js स्निपेट, Universal Analytics प्रॉपर्टी के लिए करता है.
इन दो स्निपेट के बीच का सबसे बड़ा अंतर यह है कि analytics.js कोड में एक अलग "send pageview" कॉल होता है, वहीं gtag.jss कोड में ऐसा नहीं होता है. gtag.js में, पेज व्यू, "कॉन्फ़िगरेशन" निर्देश के साथ भेजा गया अपने-आप इकट्ठा होने वाला इवेंट है.
Universal Analytics प्रॉपर्टी (analytics.js)
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'TAG_ID', 'auto');
ga('send', 'pageview');
</script>
Google Analytics 4 प्रॉपर्टी (gtag.js)
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'TAG_ID');
</script>
gtag.js की कॉन्फ़िगरेशन सेटिंग
डेटा इकट्ठा करने की सेटिंग को कंट्रोल करने के लिए, बुनियादी gtag.js स्निपेट को कॉन्फ़िगर किया जा सकता है. इसमें analytics.js से मिलती-जुलती सेटिंग, जैसे कि आईपी की पहचान छिपाना, कुकी कस्टमाइज़ेशन, और 'Google सिग्नल' को कंट्रोल करना शामिल है. gtag.js में ऐसा करने के लिए, "config" या "set" डायरेक्टिव का इस्तेमाल करें. वहीं, analytics.js में "set", "create", और "require" डायरेक्टिव का इस्तेमाल करें.
Google Analytics 4 ("G-XXXXXXXX") प्रॉपर्टी, gtag.js से मिलता-जुलता कॉन्फ़िगरेशन सेटिंग लागू करती हैं. Universal Analytics और Google Analytics 4 प्रॉपर्टी के लिए, ये सेटिंग अलग-अलग होती हैं. इन बातों का ध्यान रखें:
- Google Analytics 4 प्रॉपर्टी में आईपी की पहचान छिपाने की सुविधा को "true" पर सेट किया गया है. इसमें बदलाव नहीं किया जा सकता. इस तरह, Google Analytics 4 प्रॉपर्टी ("G-XXXXXXXX") के स्टैंडर्ड इवेंट के साथ आईपी पता अपने-आप मास्क हो जाता है.
- जब कॉन्फ़िगर की गई सभी प्रॉपर्टी पर ग्लोबल सेटिंग को लागू करना हो, तब सभी टैग आईडी और/या प्रॉपर्टी आईडी पर gtag.js में "set" कमांड का इस्तेमाल करें.
- Analytics.js में, विज्ञापन और दिलचस्पी के मुताबिक विज्ञापन दिखाने जैसी सुविधाओं पर खास ध्यान दें. आम तौर पर, इन सुविधाओं को "set" लाइन का इस्तेमाल करके लागू किया जाता है.
अगर मौजूदा analytics.js को लागू करने के लिए, "set", "create", और "require" जैसे डायरेक्टिव का इस्तेमाल किया जा रहा है, तो पता करें कि Google Analytics 4 प्रॉपर्टी में कौनसे डायरेक्टिव अपने-आप सेट हो जाते हैं और किन्हें Google Analytics 4 प्रॉपर्टी के कोड में डालना पड़ता है (पैरामीटर मैपिंग).
Analytics.js (UA प्रॉपर्टी के लिए) और gtag.js (Google Analytics 4 प्रॉपर्टी के लिए) में कोड के नमूने के साथ कॉन्फ़िगरेशन के कुछ उदाहरण यहां दिए गए हैं:
बुनियादी डेटा इकट्ठा करने की प्रोसेस चालू करना; यूज़र आईडी कॉन्फ़िगर करना
analytics.js
ga('create', 'TAG_ID', 'auto', {
userId: USER_ID
});
ga('send', 'pageview');
gtag.js
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID'
});
कुकी सेटिंग कॉन्फ़िगर करना
analytics.js
ga('create', 'TAG_ID', {
'cookieName': 'gaCookie',
'cookieDomain': 'blog.example.co.uk',
'cookieExpires': 60 * 60 * 24 * 28 // सेकंड में समय.
});
gtag.js
gtag('config', 'TAG_ID', {
'cookie_prefix': 'MyCookie',
'cookie_domain': 'blog.example.com',
'cookie_expires': 28 * 24 * 60 * 60 // 28 दिन, सेकंड में
});
page_view इवेंट को ब्लॉक करना
अगर कॉन्फ़िगरेशन कोड लोड होने पर किसी page_view इवेंट को भेजने की ज़रूरत नहीं है (उदाहरण के लिए, अगर iframe लोड हो रहा है), तो page_view इवेंट को ब्लॉक करने के लिए, कॉन्फ़िगरेशन सेटिंग में बदलाव करें. ऐसा मामला सोचिए जहां page_view इवेंट भेज दिया गया है और इसके बाद उपयोगकर्ता ने साइट में लॉग इन किया. लॉगिन इंटरैक्शन के लिए, आपको यूज़र आईडी सेट करने के लिए "config" डायरेक्टिव का इस्तेमाल करना है, लेकिन दूसरा page_view इवेंट नहीं भेजना. इस मामले में, यहां दिया गया कोड बताता है कि page_view इवेंट को भेजे जाने से कैसे रोका जा सकता है.
gtag('config', 'TAG_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
टैग के नाम
analytics.js में, अलग-अलग Universal Analytics प्रॉपर्टी को डेटा भेजने के लिए, टैग के नाम का इस्तेमाल होता है. इन्हें, "ट्रैकर" भी कहा जाता है. analytics.js में, ट्रैकर तय करते हैं कि आप किस प्रॉपर्टी में डेटा भेजना चाहते हैं. शुरुआती "create" हिट डायरेक्टिव के बाद के हिट की जानकारी के लिए, Universal Analytics प्रॉपर्टी का आईडी बताने की ज़रूरत नहीं होती है. उन्हें सिर्फ़ ट्रैकर के नाम की जानकारी देनी होती है.
gtag.js में, Google Analytics 4 या Universal Analytics प्रॉपर्टी, दोनों के लिए ट्रैकर उपलब्ध नहीं होते हैं. अगर सभी हिट को एक से ज़्यादा प्रॉपर्टी में भेजना है (Google Analytics 4 प्रॉपर्टी में अलग-अलग डेटा स्ट्रीम), तो आपको "config" की लाइन में सभी टैग या प्रॉपर्टी आईडी डालने होंगे.
इवेंट
इवेंट को दूसरी जगह भेजने से जुड़ी गाइड पढ़ें.कस्टम डाइमेंशन और मेट्रिक
कस्टम डाइमेंशन और मेट्रिक का इस्तेमाल, वेबसाइट पर मापी जाने वाली जानकारी बढ़ाने और ऑफ़लाइन डेटा इंपोर्ट करने के लिए किया जा सकता है. उदाहरण के लिए, ग्राहक प्रबंधन (सीआरएम) से डेटा इंपोर्ट करना. Universal Analytics प्रॉपर्टी ("UA-XXXXXXXX") में, कस्टम डाइमेंशन और मेट्रिक, यूज़र इंटरफ़ेस (यूआई) में बनाए जाने चाहिए. साथ ही, आईडी देने के बाद ही उन्हें लागू या इंपोर्ट किया जा सकता है. उन्हें चार अलग-अलग दायरों का इस्तेमाल करके बनाया जा सकता है: हिट, सेशन, उपयोगकर्ता, प्रॉडक्ट.
Google Analytics 4 प्रॉपर्टी ("G-XXXXXXXX") में, कस्टम डाइमेंशन और मेट्रिक के इस्तेमाल के उदाहरण को अलग-अलग तरीके से लागू किया जाता है. Analytics.js से लागू की गई UA प्रॉपर्टी के कस्टम डाइमेंशन और मेट्रिक मेज़रमेंट को Google Analytics 4 प्रॉपर्टी में पैरामीटर के तौर पर फिर से लागू करना होगा.
यूनिवर्सल Analytics प्रॉपर्टी के लिए कस्टम डाइमेंशन, analytics.js से इस तरह लागू किया जा सकता है:
ga('send', 'event', 'category_value', 'action_name', {'dimension5': 'custom data'
});
या
ga('set', 'dimension5', 'custom data');
इन कस्टम डाइमेंशन को gtag.js की मदद से Google Analytics 4 प्रॉपर्टी में इस तरह बदला जा सकता है:
gtag('event', 'action_name', {'eventCategory': 'category_value',
'dimension5': 'custom data'
});
या
gtag('set', {'dimension5': 'custom data'});
दो चेतावनियां हैं:
- रिपोर्ट में दिखने के लिए, पैरामीटर का यूज़र इंटरफ़ेस में रजिस्टर होना ज़रूरी है. यह यूनिवर्सल Analytics में कस्टम डाइमेंशन को रजिस्टर करने जैसा ही है (सीमाएं लागू होती हैं). सिर्फ़ एक्सपोर्ट किया गया डेटा देखने या ऑडियंस की सेटिंग चालू करने के लिए पैरामीटर का इस्तेमाल करने पर, आपको उन्हें रजिस्टर करने की ज़रूरत नहीं है.
- कस्टम पैरामीटर का दायरा, हिट के दायरे की तुलना में, हमेशा इवेंट-लेवल पर होता है. यह उन कस्टम डाइमेंशन पर भी लागू होता है जो मूल कस्टम डाइमेंशन के दायरे की सेटिंग से अलग, पैरामीटर (gtag.jss "UA-XXXXXXXX" लागू करने के लिए) में अपने-आप बदल जाते हैं.
कस्टम मेट्रिक के लिए भी इसी तरह की मैपिंग और खास बातें लागू होती हैं. हालांकि, जब उन्हें रिपोर्टिंग के लिए रजिस्टर किया जाता है, तब वे टेक्स्ट पैरामीटर सीमाओं के बजाय, अंक पैरामीटर सीमाओं के तौर पर गिने जाते हैं.
सैद्धान्तिक तौर पर, यूनिवर्सल Analytics प्रॉपर्टी में अलग-अलग दायरों वाले कस्टम डाइमेंशन और मेट्रिक, Google Analytics 4 प्रॉपर्टी में इस तरह से मैप होते हैं:
- हिट के स्कोप वाला कस्टम डाइमेंशन: पैरामीटर (डेटा इकट्ठा करने के समय, हर इवेंट के लिए कुल 25 पैरामीटर लॉग किए जाते हैं; ज़्यादा से ज़्यादा 50 कस्टम मेट्रिक के लिए 50 कस्टम डाइमेंशन)
कृपया ध्यान रखें कि हो सकता है किअपने-आप इकट्ठा होने वाले इवेंट और पैरामीटर में, इस्तेमाल के ऐसे उदाहरण पहले से शामिल हों जिनमें पहले हिट के स्कोप वाले कस्टम डाइमेंशन का इस्तेमाल हो रहा था - उपयोगकर्ता के स्कोप वाला कस्टम डाइमेंशन: उपयोगकर्ता-प्रॉपर्टी यूज़र इंटरफ़ेस (यूआई) से रिपोर्ट करने के लिए, ज़्यादा से ज़्यादा 25 को रजिस्टर किया जा सकता है. अपने-आप इकट्ठा होने वाले उपयोगकर्ता डाइमेंशन को इस सीमा में नहीं गिना जाता.
- सेशन के स्कोप वाला कस्टम डाइमेंशन: Google Analytics 4 प्रॉपर्टी में उपलब्ध नहीं है. इसके बजाय, कस्टम पैरामीटर या उपयोगकर्ता प्रॉपर्टी का इस्तेमाल करें.
उपयोगकर्ता प्रॉपर्टी के लिए सबसे सही तरीके
उपयोगकर्ता प्रॉपर्टी, अलग-अलग प्लैटफ़ॉर्म (जैसे कि हर तरह के डेटा स्ट्रीम) पर उपयोगकर्ता से जुड़ी होती हैं. इनका इस्तेमाल तभी किया जाना चाहिए, जब डेटा को उपयोगकर्ता के लेवल पर लागू करना हो. उपयोगकर्ता प्रॉपर्टी का इस्तेमाल सेशन लेवल के डेटा या डिवाइस लेवल के डेटा के लिए नहीं किया जाना चाहिए (जैसे कि स्क्रीन का साइज़).
Google Analytics 4 प्रॉपर्टी का उदाहरण
gtag('set', 'user_properties', {
favorite_composer: 'Mahler',
favorite_instrument: 'double bass',
season_ticketholder: 'true'
});