gtag.js स्निपेट और प्रॉपर्टी आईडी के बारे में जानकारी
यूनिवर्सल Analytics प्रॉपर्टी और Google Analytics 4 प्रॉपर्टी के लिए, 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>
लाइन 1: अगर आपने gtag.js से कोई यूनिवर्सल Analytics प्रॉपर्टी लागू की है, तो शायद आपकी साइट पर पहले से ही कोड की यह लाइन मौजूद हो. आपको <Some Property ID A> के बजाय, "UA-" के साथ अंकों की एक सीरीज़ दिखेगी. अगर आपने Google Ads या Google Marketing Platform के किसी दूसरे प्रॉडक्ट के लिए gtag.js लागू किया है, तो आपकी वेबसाइट पर भी कोड की यह लाइन हो सकती है. हालांकि, <Some Property ID A>, "AW-" या "DC-" से शुरू होगा.
<Some Property ID A> से दिखने वाला प्रॉपर्टी आईडी (या Google Analytics 4 प्रॉपर्टी का टैग आईडी), इस gtag.js स्निपेट को "कंट्रोल करता है". ऐसा इसलिए ज़रूरी है:
- अगर यह लाइन पहले से ही मौजूद है, तो इसे दूसरी बार लागू करने की ज़रूरत नहीं. टैग आईडी बताने के लिए, आपको सिर्फ़ "कॉन्फ़िगरेशन" लाइन जोड़नी होगी.
- इस लाइन का प्रॉपर्टी आईडी, gtag.js स्निपेट का "कंट्रोलर" है. अगर यूनिवर्सल Analytics प्रॉपर्टी आईडी ("UA-XXXXXXXX") टैग को कंट्रोल करता है, तो Google Analytics 4 प्रॉपर्टी को मेज़रमेंट डेटा भेजने के लिए कनेक्ट किए गए साइट टैग का इस्तेमाल किया जा सकता है. इसके लिए, आपको पेज में कोई नया कोड भी नहीं जोड़ना होगा.
लाइन 7: The gtag "config" निर्देश, <Some Property ID A> से जुड़ी प्रॉपर्टी के लिए डेटा इकट्ठा करता है. उदाहरण के लिए, Google Analytics 4 प्रॉपर्टी में, टैग आईडी के साथ इस निर्देश को जोड़ने से, उस प्रॉपर्टी को page_view इवेंट भेज दिए जाएंगे.
प्रॉपर्टी आईडी में Google के अलग-अलग तरह के प्रॉडक्ट का मेज़रमेंट दिख सकता है. इनमें यूनिवर्सल Analytics प्रॉपर्टी ("UA-XXXXXXXX"), Google Analytics 4 प्रॉपर्टी ("G-XXXXXXXX"), Google Ads ("AW-XXXXXXXX") या फ़्लडलाइट ("DC-XXXXXXXX") शामिल हैं.
लाइन 11: gtag "इवेंट" डायरेक्टिव एक इवेंट भेजेगा. ऐसे स्निपेट जहां एक से ज़्यादा प्रॉपर्टी के लिए एक से ज़्यादा "config" निर्देश मौजूद हैं वहां इवेंट सभी प्रॉपर्टी पर भेजा जाएगा.
इस उदाहरण में, "sign_up" पैरामीटर ही इवेंट का नाम है. आखिरी पैरामीटर वह ऑब्जेक्ट है जिसमें इवेंट पैरामीटर का सेट मौजूद होता है. इस मामले में, "method" एक पैरामीटर है जिसकी वैल्यू "email" है.
लाइन 13: यहां दिए गए इवेंट का पैरामीटर "send_to" है. यह एक खास पैरामीटर है, जो इससे जुड़े इवेंट को किसी खास प्रॉपर्टी में भेजता है. दूसरे शब्दों में, यह इवेंट सिर्फ़ <Some Property ID B> से दिखने वाली प्रॉपर्टी में भेजा जाएगा.
The gtag कॉन्फ़िगर कमांड, बुनियादी मेज़रमेंट को चालू करता है.
- यूनिवर्सल Analytics प्रॉपर्टी के लिए, यूनिवर्सल Analytics प्रॉपर्टी आईडी वाला "config", पेज व्यू हिट भेजता है.
- किसी Google Analytics 4 प्रॉपर्टी के लिए, टैग आईडी वाला "config", page_view इवेंट (अपने-आप इकट्ठा होने वाले इवेंट के तौर पर) इकट्ठा करता है. ऐसा तब होता है, जब यह किसी पेज पर लोड होता है.
प्रॉपर्टी आइडेंटिफ़ायर
यूनिवर्सल Analytics प्रॉपर्टी आईडी, "UA-XXXXXXXX" फ़ॉर्मैट में होते हैं. इसे कभी-कभी ट्रैकिंग आईडी भी कहा जाता है. इस गाइड में, इसे UA प्रॉपर्टी आईडी माना जाएगा.
Google Analytics 4 प्रॉपर्टी के वेब डेटा स्ट्रीम में, "G-XXXXXXXX" फ़ॉर्मैट वाले टैग आईडी का इस्तेमाल होता है.
कुछ कोड के उदाहरणों और दस्तावेज़ों में, आपको दोनों "TAG_ID" के तौर पर दिख सकते हैं.
बुनियादी डेटा इकट्ठा करना
किसी Google Analytics 4 प्रॉपर्टी के लिए बुनियादी डेटा इकट्ठा करने की सुविधा चालू करके, ये चीज़ें इकट्ठा की जा सकती हैं:
- page_view इवेंट
- अपने-आप इकट्ठा होने वाले इवेंट
- बेहतर मेज़रमेंट वाले इवेंट (यूज़र इंटरफ़ेस (यूआई) में चालू होने पर)
अगर आपकी मौजूदा यूनिवर्सल Analytics प्रॉपर्टी, लागू किए गए gtag.js का इस्तेमाल करती है, तो अपनी Google Analytics 4 प्रॉपर्टी के लिए, बुनियादी डेटा इकट्ठा करने वाली सुविधा को इनमें से किसी भी एक तरीके से चालू किया जा सकता है:
- पहला विकल्प: सही टैग आईडी के साथ एक नया "कॉन्फ़िगर" निर्देश जोड़कर
या - दूसरा विकल्प: कनेक्ट किए गए साइट टैग को चालू करके (अगर आपका लागू किया गया मौजूदा gtag.js ज़रूरी शर्तों को पूरा करता है)
आप चाहे कोई भी विकल्प चुनें, आपकी मौजूदा यूनिवर्सल Analytics प्रॉपर्टी में कोई बदलाव नहीं होगा. वह डेटा इकट्ठा करने का काम करती रहेगी.
पहला विकल्प: एक नया "config" निर्देश जोड़कर
अगर पेज पर पहले से ही gtag.js कोड मौजूद है, तो बस सही Google Analytics 4 प्रॉपर्टी के मेज़रमेंट आईडी के साथ एक और "config" निर्देश जोड़ें. नीचे दिए गए उदाहरण में, लागू किए गए मौजूदा gtag.js में आठवीं लाइन को जोड़ा गया है. यह Google Analytics 4 प्रॉपर्टी के मेज़रमेंट आईडी का रेफ़रंस देता है. इससे, page_view इवेंट को उस Google Analytics 4 प्रॉपर्टी को भेज दिया जाएगा. यह Google Analytics 4 प्रॉपर्टी में अपने-आप इकट्ठा हुए इवेंट और बेहतर मेज़रमेंट वाले इवेंट को लागू करता है (अगर आपने बेहतर मेज़रमेंट को चालू किया हुआ है).1: <script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></script>
2: <script>
3: window.dataLayer = window.dataLayer || [];
4: function gtag(){dataLayer.push(arguments);}
5: gtag('js', new Date());
6:
7: gtag('config', '<Some Property ID A>');
8: gtag('config', 'G-XXXXXXXX');
9: </script>
दूसरा विकल्प: कनेक्ट किए गए साइट टैग को चालू करके
आप कनेक्ट किए गए साइट टैग का इस्तेमाल कर सकते हैं, अगर:
- पेज पर पहले से मौजूद gtag.js स्निपेट (जहां आप उपयोगकर्ता के इंटरैक्शन को मापना चाहते हैं) को यूनिवर्सल Analytics प्रॉपर्टी से "कंट्रोल" किया जाता है (जैसे कि gtag.js स्निपेट की इस लाइन में इस्तेमाल किया गया आईडी "UA-" से शुरू होता है):
<script async src="https://www.googletagmanager.com/gtag/js?id=<Some Property ID A>"></script>
(अगर मौजूदा gtag.js स्निपेट, Google Analytics 4 प्रॉपर्टी से कंट्रोल होता है, तब भी कनेक्ट किए गए साइट टैग काम करेंगे. हालांकि, आपको यह स्थिति तभी दिखेगी, जब Google Analytics 4 प्रॉपर्टी पहले ही लागू की जा चुकी हो.)
- और आपके पास स्निपेट में आईडी से पहचाने जाने वाली यूनिवर्सल Analytics प्रॉपर्टी का एडमिन ऐक्सेस होता है.
gtag.js की कॉन्फ़िगरेशन सेटिंग
डेटा इकट्ठा करने की सेटिंग को कंट्रोल करने के लिए, बुनियादी gtag.js स्निपेट कॉन्फ़िगर किया जा सकता है. इसमें आईपी की पहचान छिपाना, कुकी कस्टमाइज़ेशन, और 'Google सिग्नल' को कंट्रोल करने जैसी सेटिंग शामिल हैं. आप gtag.js में "config" या "set" डायरेक्टिव की मदद से ऐसा करते हैं.
यूनिवर्सल Analytics ("UA-XXXXXXXX") और Google Analytics 4 ("G-XXXXXXXX") प्रॉपर्टी, दोनों ही gtag.js से इन कॉन्फ़िगरेशन सेटिंग को लागू करने की सुविधा देती हैं. हालांकि, यूनिवर्सल Analytics और Google Analytics 4 प्रॉपर्टी के लिए, ये सेटिंग अलग-अलग होती हैं.
- आईपी की पहचान छिपाने की सुविधा को "सही" पर सेट किया गया है. इसे Google Analytics 4 प्रॉपर्टी में कॉन्फ़िगर नहीं किया जा सकता. इस तरह, Google Analytics 4 प्रॉपर्टी ("G-XXXXXXXX") के स्टैंडर्ड इवेंट के साथ, आईपी पता अपने-आप मास्क हो जाता है.
- जब कॉन्फ़िगर की गई सभी प्रॉपर्टी पर ग्लोबल सेटिंग को लागू किया जाना ज़रूरी हो, तो सभी मेज़रमेंट आईडी और/या प्रॉपर्टी आईडी पर लागू करने के लिए, "set" निर्देश का इस्तेमाल होना चाहिए. इनमें कनेक्ट किए गए साइट टैग से लागू हुए मेज़रमेंट/प्रॉपर्टी आईडी भी शामिल हैं.
- दिलचस्पी के मुताबिक विज्ञापन दिखाने की सुविधाओं को बंद करने पर खास ध्यान दें. इन सुविधाओं को आम तौर पर, "config" लाइन के साथ लागू किया जाता है.
- कनेक्ट किए गए साइट टैग का इस्तेमाल करते समय: "config" का इस्तेमाल करके, gtag.js कोड में किया गया कोई भी कॉन्फ़िगरेशन सिर्फ़ उस कोड की लाइन में मौजूद मेज़रमेंट आईडी से जुड़ी प्रॉपर्टी पर लागू होता है; ये कनेक्ट की गई Google Analytics 4 प्रॉपर्टी पर अपने-आप नहीं भेजे जाएंगे. अगर आप चाहते हैं कि कॉन्फ़िगरेशन, कनेक्ट की गई Google Analytics 4 प्रॉपर्टी पर लागू हो, तो
- एक अलग "config" निर्देश बनाएं और मेज़रमेंट आईडी का इस्तेमाल करके, सही Google Analytics 4 प्रॉपर्टी में लागू करें
या - "set" निर्देश का इस्तेमाल करके, सेटिंग कॉन्फ़िगर करें. इस स्थिति में, कॉन्फ़िगरेशन, सभी कॉन्फ़िगर की गई प्रॉपर्टी पर लागू होगा.
- एक अलग "config" निर्देश बनाएं और मेज़रमेंट आईडी का इस्तेमाल करके, सही Google Analytics 4 प्रॉपर्टी में लागू करें
कॉन्फ़िगरेशन के उदाहरण
बुनियादी डेटा इकट्ठा करने की प्रोसेस चालू करना; यूज़र आईडी कॉन्फ़िगर करना
gtag('config', 'GA_MEASUREMENT_ID', {
'user_id': 'USER_ID'
});
कुकी सेटिंग कॉन्फ़िगर करना
gtag('config', 'GA_MEASUREMENT_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', 'MEASUREMENT_ID', {
'user_id': 'USER_ID',
'send_page_view': false
});
इवेंट
इवेंट को दूसरी जगह भेजने से जुड़ी गाइड देखें.
कस्टम डाइमेंशन और मेट्रिक
कस्टम डाइमेंशन और मेट्रिक का इस्तेमाल, जानकारी बढ़ाने और ऑफ़लाइन डेटा इंपोर्ट करने के लिए किया जा सकता है. उदाहरण के लिए, सीआरएम सिस्टम से डेटा इंपोर्ट करना.
अगर कनेक्ट किए गए साइट टैग या Google Analytics 4 प्रॉपर्टी (जैसे, “G-XXXXXXXX”) का इस्तेमाल किया जाता है, तो Google टैग (gtag.js) वाले कस्टम डाइमेंशन और मेट्रिक के मेज़रमेंट अपने-आप पैरामीटर में बदल जाते हैं.
कस्टम डाइमेंशन और मेट्रिक के बारे में ज़्यादा जानें.