gtag.js की कुकी और उपयोगकर्ता की पहचान

gtag.js, सभी ब्राउज़िंग सेशन में यूनीक उपयोगकर्ताओं की पहचान करने के लिए, कुकी का इस्तेमाल करता है. इस पेज पर कुकी की सेटिंग को पसंद के मुताबिक बनाने का तरीका बताया गया है.

ध्यान दें: gtag.js कुकी का इस्तेमाल कैसे करता है, इस बारे में जानकारी के लिए कुकी के इस्तेमाल की गाइड देखें.

कुकी फ़ील्ड की सेटिंग कॉन्फ़िगर करना

नीचे दी गई टेबल में, gtag.js में इस्तेमाल किए गए डिफ़ॉल्ट कुकी फ़ील्ड वैल्यू दिखाई गई हैं:

फ़ील्ड का नाम	वैल्यू टाइप	डिफ़ॉल्ट संख्या
cookie_domain	string	auto
cookie_expires	integer	63072000 (दो साल, सेकंड में)
cookie_prefix	string	_ga
cookie_update	boolean	true
cookie_flags	string

इनमें से किसी भी वैल्यू को बदलने के लिए, अपनी प्रॉपर्टी के config में बदलाव करें, ताकि वे पैरामीटर सूची में शामिल हो सकें. उदाहरण के लिए:

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_prefix': 'MyCookie',
  'cookie_domain': 'blog.example.com',
  'cookie_expires': 28 * 24 * 60 * 60  // 28 days, in seconds
});

कुकी के डोमेन का कॉन्फ़िगरेशन

डिफ़ॉल्ट रूप से, gtag.js में अपने-आप कुकी डोमेन कॉन्फ़िगरेशन चालू होता है. इसे चालू करने पर, gtag.js, कुकी को सबसे ऊंचे लेवल के डोमेन पर सेट कर देगा. उदाहरण के लिए, अगर आपकी वेबसाइट का पता blog.example.com है, तो gtag.js, example.com डोमेन पर कुकी सेट करेगा. अगर gtag.js को यह पता चलता है कि आप एक सर्वर चला रहे हैं (जैसे, localhost), तो यह अपने-आप cookie_domain को 'none' पर सेट कर देता है. इससे, gtag.js, दस्तावेज़ की जगह से पूरे डोमेन का इस्तेमाल करके कुकी सेट करता है.

अपने-आप कुकी डोमेन कॉन्फ़िगरेशन को बंद करने के लिए, अपनी प्रॉपर्टी के लिए config अपडेट करें, ताकि cookie_domain पैरामीटर की वैल्यू तय की जा सके:

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_domain': 'blog.example.com'
});

ध्यान दें: जब आप अपने-आप कुकी डोमेन कॉन्फ़िगरेशन का इस्तेमाल करते हैं, तो गतिविधि को बिना किसी अतिरिक्त कॉन्फ़िगरेशन के सबडोमेन में मेज़र किया जाएगा.

चेतावनी: cookie_domain, मौजूदा डोमेन के पूर्वज होना चाहिए, नहीं तो कुकी सेट नहीं होगी. उदाहरण के लिए, अगर आपका डोमेन one.two.three.root.com है, तो आप कुकी को कॉन्फ़िगर कर सकते हैं. इसे root.com पर सेट किया जाना चाहिए, लेकिन someotherdomain.com पर नहीं. गलत कुकी डोमेन सेट करने पर, Google Analytics को कोई हिट नहीं मिलेगा.

कुकी का प्रीफ़िक्स

दूसरी कुकी के साथ टकराव से बचने के लिए, आपको कुकी का प्रीफ़िक्स बदलना पड़ सकता है.इसे कुकी के ज़रिए सेट की गई कुकी से पहले जोड़ा जाएगा. उदाहरण के लिए, Google Analytics में आईडी कुकी का डिफ़ॉल्ट नाम _ga है. इस कोड की वजह से कुकी का नाम example_ga हो जाएगा:

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_prefix': 'example'
});

चेतावनी: अगर टैग की गई साइट, gtag.js या Google Analytics की मदद से टैग की गई है और उपयोगकर्ता के साइट पर आने के बाद cookie_prefix बदल जाती है, तो वे उपयोगकर्ता gtag.js और Google Analytics पर आने वाले नए लोगों के तौर पर दिखेंगे, क्योंकि बिना प्रीफ़िक्स वाली कुकी में स्टोर किया गया संदर्भ खो जाएगा. इसलिए, अगर आप कुकी का प्रीफ़िक्स इस्तेमाल करना चाहते हैं, तो हमारा सुझाव है कि आप साइट को टैग करते समय ही इसका इस्तेमाल करें.

कुकी के खत्म होने की अवधि की सेटिंग

हर पेज लोड होने पर, कुकी के खत्म होने की अवधि को मौजूदा समय पर अपडेट किया जाता है. साथ ही, cookie_expires फ़ील्ड की वैल्यू को भी अपडेट किया जाता है. इसका मतलब है कि अगर cookie_expires को एक हफ़्ते के लिए सेट किया गया है और कोई उपयोगकर्ता पांच दिन के अंदर उसी ब्राउज़र का इस्तेमाल करके आता है, तो कुकी एक और हफ़्ते के लिए उपलब्ध होगी और Google Analytics में वह वेबसाइट पर आने वाले उसी व्यक्ति के तौर पर दिखेगी. अगर मूल कुकी की समयसीमा खत्म होने के बाद वही उपयोगकर्ता विज़िट करता है, तो नई कुकी बनाई जाएगी और उसकी पहली और दूसरी विज़िट, Google Analytics में अलग-अलग विज़िटर की तरह दिखेगी.

अगर cookie_expires वैल्यू को 0 (शून्य) सेकंड पर सेट किया जाता है, तो कुकी सेशन आधारित कुकी में बदल जाती है और मौजूदा ब्राउज़र सेशन के खत्म होने पर खत्म हो जाती है.

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_expires': 0
});

चेतावनी: अगर कुकी को बहुत जल्दी खत्म होने के लिए सेट किया जाता है, तो उपयोगकर्ता की संख्या बढ़ जाएगी और मेज़रमेंट की क्वालिटी कम हो जाएगी.

कुकी अपडेट करने की सेटिंग

जब cookie_update को true (डिफ़ॉल्ट वैल्यू) पर सेट किया जाता है, तब gtag.js हर पेज लोड होने पर कुकी अपडेट करेगा. इससे कुकी की समयसीमा खत्म हो जाएगी और वह साइट पर सबसे हाल में आने वाले लोगों के लिए सेट हो जाएगी. उदाहरण के लिए, अगर कुकी की समयसीमा खत्म होने की तारीख एक हफ़्ते पर सेट है और उपयोगकर्ता हर पांच दिन में एक ही ब्राउज़र का इस्तेमाल करके वेबसाइट पर आता है, तो कुकी की समयसीमा खत्म होने की तारीख पर हर बार अपडेट किया जाएगा. इसलिए, कुकी की समयसीमा कभी खत्म नहीं होगी.

false पर सेट होने पर, हर पेज लोड होने पर कुकी अपडेट नहीं होती हैं. इससे, कुकी की समयसीमा खत्म होने का असर, उस उपयोगकर्ता से पहली बार साइट पर आने पर पड़ता है.

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_update': false
});

कुकी फ़्लैग

सेट होने पर कुकी में और फ़्लैग जोड़ दिए जाते हैं. फ़्लैग को सेमीकॉलन से अलग किया जाना चाहिए.

gtag('set', {
  'cookie_flags': 'SameSite=None;Secure'
});

सावधानी: samesite को None पर सेट करने और HTTP के ज़रिए Secure के फ़्लैग या साइट को हटाने से, मेज़रमेंट पर बुरा असर पड़ता है.

यूज़र आईडी सेट करें

User-ID एक यूनीक, स्थायी, और व्यक्तिगत पहचान से जुड़ी आईडी वाली स्ट्रिंग होती है जो किसी उपयोगकर्ता के बारे में बताती है. इससे सभी डिवाइस पर सेशन के ग्रुप का विश्लेषण किया जा सकता है. यूज़र आईडी लागू करने की वजह जानने के लिए, यूज़र आईडी की सुविधा का इस्तेमाल करने के फ़ायदे देखें.

gtag.js से User-ID को लागू करने के लिए, अपनी प्रॉपर्टी के लिए config को अपडेट करके 'User-ID' सेट करें:

gtag('config', 'GA_MEASUREMENT_ID', {
  'user_id': 'USER_ID'
});

सहमति के आधार पर टैग के व्यवहार में बदलाव करना

उपयोगकर्ता से सहमति मिलने तक, gtag.js को कुकी को पढ़ने या लिखने के लिए कॉन्फ़िगर नहीं किया जा सकता. ज़्यादा जानने के लिए, सहमति के आधार पर टैग के व्यवहार में बदलाव करना देखें