टैग के लिए, इलाके के हिसाब से सेटिंग चालू करें

यह लेख उन डेवलपर के लिए है जो अपने सर्वर से Google स्क्रिप्ट पब्लिश करते हैं. हमारा सुझाव है कि टैग के लिए, देश/इलाके के हिसाब से काम करने की सुविधा चालू करें. इससे आपको ऐडवांस सहमति मोड जैसी सुविधाएं मिलेंगी. साथ ही, इससे आपको यह कंट्रोल करने में मदद मिलेगी कि आपके उपयोगकर्ताओं के देश/इलाके के हिसाब से टैग कैसे काम करें.

अगर पहले पक्ष के डोमेन से कोई स्क्रिप्ट दिखाई जाती है, तो आपको अनुरोध हेडर में उपयोगकर्ता की भौगोलिक जगह की जानकारी देनी चाहिए, ताकि event_location.country और event_location.region पैरामीटर का इस्तेमाल किया जा सके. अगर अनुरोध हेडर में आईपी पता मौजूद है, तो भौगोलिक स्थान का पता लगाने के लिए आईपी पते को प्राथमिकता दी जाती है. इसके अलावा, event_location.country और event_location.region पैरामीटर का इस्तेमाल, देश और इलाके की जानकारी भेजने के लिए किया जाता है.

का इस्तेमाल किया जा सकता है.

शुरू करने से पहले

इस गाइड में यह माना गया है कि आपने ये काम कर लिए हैं:

पहला चरण: अनुरोध हेडर सेट अप करना

आपको कुछ खास अनुरोध हेडर भेजने होंगे. इनमें उपयोगकर्ता के इलाके की जानकारी शामिल होती है. इसके बारे में यहां बताया गया है.

अगर:

  • App Engine का इस्तेमाल किया जा रहा हो. App Engine, भौगोलिक जानकारी वाले हेडर अपने-आप भेजता है.
  • आपने नीचे दी गई कंपनियों के अलावा, किसी दूसरी कंपनी की बुनियादी सेवाओं का इस्तेमाल किया हो. आपको कस्टम हेडर सेट अप करने होंगे.

GCP Load Balancer के साथ Cloud Run

जियोलोकेशन की जानकारी, सभी एचटीटीपी अनुरोध हेडर के साथ या खास अनुरोधों के लिए भेजी जा सकती है. कस्टम अनुरोध हेडर जोड़ने पर, हर 10 लाख अनुरोध के लिए शुल्क लगेगा. इसलिए, हमारा सुझाव है कि Google स्क्रिप्ट दिखाने के अनुरोधों के लिए ही भौगोलिक जानकारी शामिल करें. इस विकल्प को शुरू में ज़्यादा सेटअप करने की ज़रूरत होती है. हालांकि, इससे अपने इन्फ़्रास्ट्रक्चर को कम से कम खर्च में चलाने में मदद मिलती है.

स्क्रिप्ट के अनुरोध

सिर्फ़ स्क्रिप्ट के अनुरोधों के लिए, भौगोलिक जानकारी वाले हेडर शामिल करने के लिए, आपको एक नया बैकएंड सेट अप करना होगा और राउटिंग के नियम बनाने होंगे.

नया बैकएंड बनाने के लिए:

  1. GCP लोड बैलेंसर खोलें
  2. अपने लोड बैलेंसर में, बैकएंड कॉन्फ़िगरेशन सेक्शन खोलें. नई बैकएंड सेवा बनाएं.
    बैकएंड कॉन्फ़िगरेशन की सेटिंग का स्क्रीनशॉट
  3. अपनी नई बैकएंड सेवा कॉन्फ़िगर करें:
    • बैकएंड टाइप: वह नेटवर्क एंडपॉइंट ग्रुप टाइप चुनें जिसका इस्तेमाल आपका ऐप्लिकेशन करता है. Cloud Run का इस्तेमाल करने पर, Serverless network endpoint group चुनें.
    • नया बैकएंड में, सर्वर-साइड Tag Manager डिप्लॉयमेंट का नेटवर्क एंडपॉइंट ग्रुप चुनें.
      नई बैकएंड सेवा का स्क्रीनशॉट
  4. ऐडवांस कॉन्फ़िगरेशन सेक्शन खोलें. कस्टम अनुरोध हेडर जोड़ें.
    हेडर का नाम हेडर की वैल्यू
    X-Gclb-Country {client_region}
    X-Gclb-Region {client_region_subdivision}
  5. नई बैकएंड सेवा सेव करें.

रूटिंग के नियम कॉन्फ़िगर करने के लिए:

  1. अपने लोड बैलेंसर में, राउटिंग के नियम सेक्शन खोलें. ऐडवांस होस्ट पाथ और नियम मोड चुनें.
  2. pathRules पैरामीटर को अपडेट करें, ताकि gtm.js, /gtag/js, और /gtag/destination को नई बैकएंड सेवा से मैप किया जा सके.
    pathRules:
    - paths:
      - /gtm.js
      - /gtag*
      service: projects/project_id/global/backendServices/new backend service
    - paths:
      - /*
      service: projects/project_id/global/backendServices/original backend service
  3. बदलावों को सेव करें.

सभी अनुरोध

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

हेडर का नाम हेडर की वैल्यू
X-Gclb-Country {client_region}
X-Gclb-Country {client_region_subdivision}

GCP लोड बैलेंसर

जियोलोकेशन की जानकारी, सभी एचटीटीपी अनुरोध हेडर के साथ या खास अनुरोधों के लिए भेजी जा सकती है. कस्टम अनुरोध हेडर जोड़ने पर, हर 10 लाख अनुरोध के लिए शुल्क लगेगा. इसलिए, हमारा सुझाव है कि Google स्क्रिप्ट दिखाने के अनुरोधों के लिए ही भौगोलिक जानकारी शामिल करें. इस विकल्प को शुरू में ज़्यादा सेटअप करने की ज़रूरत होती है. हालांकि, इससे अपने इन्फ़्रास्ट्रक्चर को कम से कम खर्च में चलाने में मदद मिलती है.

स्क्रिप्ट के अनुरोध

सिर्फ़ स्क्रिप्ट के अनुरोधों के लिए, भौगोलिक जानकारी वाले हेडर शामिल करने के लिए, आपको एक नया बैकएंड सेट अप करना होगा और राउटिंग के नियम बनाने होंगे.

नया बैकएंड बनाने के लिए:

  1. GCP लोड बैलेंसर खोलें
  2. अपने लोड बैलेंसर में, बैकएंड कॉन्फ़िगरेशन सेक्शन खोलें. नई बैकएंड सेवा बनाएं.
    बैकएंड कॉन्फ़िगरेशन की सेटिंग का स्क्रीनशॉट
  3. अपनी नई बैकएंड सेवा कॉन्फ़िगर करें:
    • बैकएंड टाइप: वह नेटवर्क एंडपॉइंट ग्रुप टाइप चुनें जिसका इस्तेमाल आपका ऐप्लिकेशन करता है. Cloud Run का इस्तेमाल करने पर, Serverless network endpoint group चुनें.
    • नया बैकएंड में, सर्वर-साइड Tag Manager डिप्लॉयमेंट का नेटवर्क एंडपॉइंट ग्रुप चुनें.
      नई बैकएंड सेवा का स्क्रीनशॉट
  4. ऐडवांस कॉन्फ़िगरेशन सेक्शन खोलें. कस्टम अनुरोध हेडर जोड़ें.
    हेडर का नाम हेडर की वैल्यू
    X-Gclb-Country {client_region}
    X-Gclb-Region {client_region_subdivision}
  5. नई बैकएंड सेवा सेव करें.

रूटिंग के नियम कॉन्फ़िगर करने के लिए:

  1. अपने लोड बैलेंसर में, राउटिंग के नियम सेक्शन खोलें. ऐडवांस होस्ट पाथ और नियम मोड चुनें.
  2. pathRules पैरामीटर को अपडेट करें, ताकि gtm.js, /gtag/js, और /gtag/destination को नई बैकएंड सेवा से मैप किया जा सके.
    pathRules:
    - paths:
      - /gtm.js
      - /gtag*
      service: projects/project_id/global/backendServices/new backend service
    - paths:
      - /*
      service: projects/project_id/global/backendServices/original backend service
  3. बदलावों को सेव करें.

सभी अनुरोध

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

हेडर का नाम हेडर की वैल्यू
X-Gclb-Country {client_region}
X-Gclb-Country {client_region_subdivision}

Amazon Web Services (AWS) CloudFront

अनुरोध में CloudFront-Viewer-Country और CloudFront-Viewer-Country-Region हेडर जोड़ने के लिए, ऑरिजिन के अनुरोध से जुड़ी नीति बनाएं.

इससे ये हेडर और उनकी वैल्यू अपने-आप जुड़ जाएंगी:

हेडर का नाम हेडर की वैल्यू
CloudFront-Viewer-Country उपयोगकर्ता का देश
CloudFront-Viewer-Country-Region उपयोगकर्ता का सबडिविज़न
AWS CloudFront में हेडर सेटिंग

Azure Front Door

नियम इंजन का इस्तेमाल करके, बदलाव के अनुरोध का हेडर ऐक्शन के साथ नियमों का एक सेट बनाएं. इसमें यह मैपिंग शामिल करें:

हेडर का नाम हेडर की वैल्यू
X-Azure-Country {geo_country}
Azure Front Door कॉन्फ़िगरेशन का स्क्रीनशॉट

Cloudflare

मैनेज किए गए ट्रांसफ़ॉर्म सेक्शन में जाकर, "विज़िटर की जगह की जानकारी वाले हेडर जोड़ें" सुविधा चालू करें:

इससे, यह हेडर और इसकी वैल्यू अपने-आप जुड़ जाएगी:

हेडर का नाम हेडर की वैल्यू
CF-IPCountry उपयोगकर्ता का देश
Cloudflare कॉन्फ़िगरेशन का स्क्रीनशॉट

दूसरा चरण: Visitor Region वैरिएबल सेट अप करना

अगर आपने ऊपर बताए गए तरीके से जियो हेडर सेट अप किए हैं, तो Tag Manager, एचटीटीपी अनुरोध के हेडर को पढ़कर देश/इलाके का पता अपने-आप लगा लेता है. इसके अलावा, कस्टम हेडर भी सेट अप किए जा सकते हैं.

अपने-आप पहचान होने की सुविधा

  1. Google Tag Manager खोलें
  2. अपना सर्वर कंटेनर खोलें.
  3. वैरिएबल मेन्यू में, बिल्ट-इन वैरिएबल की सूची को कॉन्फ़िगर करें.
  4. विज़िटर का क्षेत्र चुनें.

अब जियो हेडर का इस्तेमाल, विज़िटर क्षेत्र वैरिएबल में किया जा सकेगा.

कस्टम हेडर

  1. Google Tag Manager खोलें
  2. अपना सर्वर कंटेनर खोलें.
  3. वैरिएबल मेन्यू में, विज़िटर क्षेत्र टाइप का, उपयोगकर्ता के हिसाब से तय किया गया कोई नया वैरिएबल बनाएं.
  4. वैरिएबल कॉन्फ़िगरेशन में जाकर, कस्टम वैरिएबल चुनें.
  5. वैरिएबल मेन्यू में, दो नए अनुरोध हेडर वैरिएबल बनाएं: एक आपके देश के लिए और दूसरा सबडिविज़न कोड के लिए. एचटीटीपी अनुरोध के हेडर में मौजूद देश के कोड की वैल्यू डालें.

  6. स्क्रीनशॉट में दिखाए गए तरीके से, बनाए गए वैरिएबल का इस्तेमाल विज़िटर क्षेत्र वैरिएबल में करें.

    वैरिएबल की सेटिंग का स्क्रीनशॉट

  7. वैरिएबल को नाम देकर सेव करें.

तीसरा चरण: अपने क्लाइंट में क्षेत्र के हिसाब से सेटिंग चालू करना

आने वाले एचटीटीपी अनुरोधों को प्रोसेस करने के लिए, वेबसाइट पर आने वाले व्यक्ति के इलाके की जानकारी का इस्तेमाल करने के लिए, आपको इसे अपने क्लाइंट में जोड़ना होगा.

  1. Google Tag Manager: वेब कंटेनर क्लाइंट को चुनें.

  2. क्षेत्र के हिसाब से सेटिंग चालू करें पर सही का निशान लगाएं. पिछले चरण में बनाए गए {{Visitor Region}} वैरिएबल को Region फ़ील्ड में जोड़ें.

  3. अपने क्लाइंट को सेव करें.

चौथा चरण: पुष्टि करें कि क्षेत्र की सेटिंग लागू हो गई हैं

यह जांच करने के लिए कि आपकी सेटिंग काम कर रही हैं या नहीं:

  1. अपने सर्वर कंटेनर के लिए झलक मोड खोलें.
  2. पहले पक्ष की कुकी का इस्तेमाल करते समय, आपकी वेबसाइट लोड होती है.
  3. झलक दिखाने वाली विंडो में, दावा किया गया Google Analytics GA4 क्लाइंट पर क्लिक करें. क्लाइंट का स्क्रीनशॉट
  4. असली क्षेत्र देखने के लिए, डिस्प्ले वैरिएबल रेडियो बटन को वैल्यू पर सेट करें. विज़िटर के इलाके के फ़ील्ड का स्क्रीनशॉट
    • ✅ अगर क्षेत्र प्रॉपर्टी में देश का कोड दिखता है, तो इसका मतलब है कि आपने सही तरीके से लागू किया है.
    • ❌ अगर Region प्रॉपर्टी में undefined दिखता है या यह मौजूद नहीं है, तो इसका मतलब है कि आपके सर्वर को इलाके का कोई डेटा नहीं मिल रहा है. देखें कि सर्वर के एचटीटीपी हेडर, Google Tag Manager के पहले से तय किए गए वैरिएबल के हिसाब से सेट अप किए गए हैं या नहीं. इसके लिए, अनुरोध हेडर सेट अप करना लेख पढ़ें.

अगले चरण