कस्टम डोमेन कॉन्फ़िगरेशन

यह लेख उन डेवलपर के लिए है जो अपनी वेबसाइट के फ़र्स्ट पार्टी कॉन्टेक्स्ट में, सर्वर साइड टैगिंग को होस्ट करना चाहते हैं. सेम-ऑरिजन सर्विंग सबसे सही तरीका है. इससे आपको सर्वर पर सेट होने वाली कुकी से जुड़ी सुरक्षा और उसके लंबे समय तक सर्वर पर स्टोर रहने से जुड़े फ़ायदे मिलते हैं. यहां दिए गए निर्देश, एक ही ऑरिजिन से विज्ञापन दिखाने की सुविधा सेट अप करने के लिए लागू होते हैं. भले ही, आपकी साइट पर gtag.js या gtm.js, दोनों में से कोई भी Google टैग डिप्लॉय किया गया हो.

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

नीचे दी गई टेबल में बताया गया है कि पैरंट वेबसाइट को www.example.com पर होस्ट करने पर, टैग करने वाले सर्वर को कैसे होस्ट किया जा सकता है:

	एक ही ऑरिजिन (सबसे सही तरीका)	सबडोमेन	डिफ़ॉल्ट डोमेन
यूआरएल का उदाहरण	https://www.example.com/metrics	https://metrics.example.com	https://metrics.run.app
सर्वर से सेट की गई कुकी का ऐक्सेस	सुरक्षा और लंबे समय तक चलने से जुड़े फ़ायदों का पूरा ऐक्सेस.	सुरक्षा और लंबे समय तक चलने से जुड़े फ़ायदों का पूरा ऐक्सेस.	कोई नहीं. सिर्फ़ JavaScript कुकी सेट की जा सकती हैं.
सेटअप करने में लगने वाला समय	अनुरोधों को फ़ॉरवर्ड करने के लिए, सीडीएन या लोड बैलेंसर को कॉन्फ़िगर करें. डीएनएस एंट्री अपडेट करने की ज़रूरत पड़ सकती है.	डीएनएस एंट्री अपडेट करें.	यह पहले से कॉन्फ़िगर किया गया होता है.

शुरू करने के लिए, लागू करने का विकल्प चुनें.

सबडोमेन एक ही ऑरिजिन

ज़रूरी शर्तें

इस गाइड में यह माना गया है कि:

• Tag Manager में सर्वर कंटेनर सेट अप करना
• टैग करने वाला सर्वर सेट अप करना
• ऐसा सीडीएन या लोड बैलेंसर जो अनुरोधों को फ़ॉरवर्ड कर सकता है.
• अगर App Engine का इस्तेमाल किया जा रहा है, तो टैग करने वाले सर्वर पर 2.2.0 या इसके बाद का वर्शन होना चाहिए. टैग करने वाले सर्वर को आने वाले समय के हिसाब से अप-टू-डेट रखने के लिए, Cloud Run पर माइग्रेट करें.

कस्टम डोमेन कॉन्फ़िगर करना

अपने सर्वर कंटेनर को उसी डोमेन के पाथ पर चलने के लिए सेट अप किया जा सकता है जिस पर आपकी वेबसाइट है. उदाहरण के लिए, अगर आपकी वेबसाइट का पाथ www.example.com है, तो अपने सर्वर कंटेनर के लिए, www.example.com/metrics जैसा कोई पाथ रिज़र्व रखें.

1. टैग करने वाले सर्वर के लिए इस्तेमाल करने के लिए, अपने डोमेन का कोई पाथ चुनें

यह पाथ, पहले पक्ष की सेवा लागू करने के लिए रिज़र्व किया जाएगा. पक्का करें कि आपने ऐसा पाथ चुना हो जिसका इस्तेमाल पहले न किया गया हो.

ऐसे पाथ के उदाहरण जिनका इस्तेमाल किया जा सकता है: /collect, /metrics, /data

इस पाथ स्ट्रिंग को नोट करें. आपको इसे अगले सभी चरणों में, /metrics के बजाय इस्तेमाल करना होगा. यह आपको यहां दिखेगा: /metrics

चेतावनी: सेटअप करने के इस तरीके से, चुने गए पाथ के साथ प्रीफ़िक्स वाला सारा ट्रैफ़िक, टैग करने वाले सर्वर पर भेजा जाता है. अपनी वेबसाइट के ट्रैफ़िक पर असर न पड़े, इसके लिए कोई ऐसा पाथ चुनें जिसका इस्तेमाल पहले न किया गया हो. पाथ में /gtm नहीं होना चाहिए.

2. ट्रैफ़िक को टैग करने वाले सर्वर पर भेजें

अगर आपकी वेबसाइट पहले से ही ऐसे सीडीएन या लोड बैलेंसर के साथ सेट अप की गई है जो ट्रैफ़िक को पाथ के हिसाब से रूट करने की सुविधा देता है, तो सीधे चौथे चरण पर जाएं.

1. अपनी वेबसाइट पर ले जाने वाला ऑरिजिन या बैकएंड जोड़ें.
2. होस्ट हेडर को बदलकर वेबसाइट का होस्टनेम डालें, जैसे कि example.com
3. सभी कुकी और क्वेरी स्ट्रिंग को फ़ॉरवर्ड करने की अनुमति दें. अगर प्लैटफ़ॉर्म पर यह विकल्प उपलब्ध नहीं है, तो इसका मतलब है कि डिफ़ॉल्ट रूप से ऐसा किया जाता है.
4. आपकी वेबसाइट को टैग करने वाले सर्वर पर ले जाने वाला दूसरा ऑरिजिन या बैकएंड जोड़ें. यह क्लाउड सेवा देने वाली कंपनी का डोमेन हो सकता है, जैसे कि metrics.run.app
5. होस्ट हेडर को बदलें, ताकि यह पहले से सेट किए गए डोमेन पर पॉइंट करे. सभी कुकी और क्वेरी स्ट्रिंग को फ़ॉरवर्ड करने की अनुमति दें.
6. टैग करने वाले सर्वर पर ट्रैफ़िक को भेजने के लिए, पाथ का कोई नियम जोड़ें, जैसे कि /metrics/*.
7. रिज़र्व किए गए सर्वर साइड टैगिंग पाथ को इस तरह से कॉन्फ़िगर करें, ताकि उसे डिफ़ॉल्ट नियम से पहले प्राथमिकता दी जाए.
8. अगर आपने अभी तक अपने डीएनएस को अपडेट नहीं किया है, तो इसे सीडीएन या लोड बैलेंसर पर पॉइंट करने के लिए अपडेट करें. डीएनएस अपडेट लागू होने में कुछ समय लग सकता है.
9. आपने अभी जो डोमेन सेट अप किया है उसके /healthy एंडपॉइंट पर जाएं, जैसे कि https://example.com/metrics/healthy. आपको ok दिखेगा.

3. Google Tag Manager में सर्वर यूआरएल अपडेट करना

आपको अपने सर्वर कंटेनर कॉन्फ़िगरेशन को अपडेट करना होगा, ताकि वह पाथ प्रीफ़िक्स की पहचान कर सके और अनुरोधों को सही तरीके से प्रोसेस कर सके.

नए एंडपॉइंट पर अपडेट करने के लिए:

1. Google Tag Manager खोलें
2. वह सर्वर कंटेनर खोलें जो वेबसाइट के उसी ऑरिजिन पर सेट अप किया गया है.
3. एडमिन टैब > कंटेनर सेटिंग में जाकर, सभी पिछले यूआरएल हटाएं. ऐसा करना ज़रूरी है, क्योंकि सभी सर्वर कंटेनर यूआरएल का एक ही पाथ होना चाहिए.
4. यूआरएल जोड़ें पर क्लिक करें और पाथ प्रीफ़िक्स के साथ अपना यूआरएल डालें.
5. सेव करें और अपने फ़ाइल फ़ोल्डर पर वापस जाएं.
6. नया डीबग सेशन शुरू करने के लिए, झलक देखें बटन पर क्लिक करें और अलग टैब पर अनुरोध भेजें.
7. भेजे गए अनुरोध पर क्लिक करें. पक्का करें कि आपके क्लाइंट ने आने वाले अनुरोध पर दावा किया हो.

अक्सर होने वाली समस्याएं हल करना

1. झलक में, आने वाले अनुरोध नहीं दिखते
   1. अपने क्लाउड प्रोजेक्ट के लॉग एक्सप्लोरर पर जाएं. पुष्टि करें कि सर्वर साइड टैगिंग डिप्लॉयमेंट को ट्रैफ़िक मिल रहा है. अगर ऐसा नहीं है, तो पहले चरण में दिए गए निर्देशों का पालन करें.
   2. पुष्टि करें कि सीडीएन या लोड बैलेंसर, कुकी फ़ॉरवर्ड कर रहा है.
   3. पुष्टि करें कि आपके पास एक ही झलक सर्वर है और टैग करने वाले सर्वर में PREVIEW_SERVER_URL सेट है.
   4. PREVIEW_SERVER_URL + /healthy पर जाकर, पुष्टि करें कि प्रीव्यू सर्वर काम कर रहा है. आपको ok दिखेगा.
2. क्लाइंट, अनुरोधों पर दावा नहीं कर रहे हैं - रिज़र्व किए गए पाथ का इस्तेमाल करने के लिए, कंटेनर की सेटिंग में यूआरएल अपडेट करें. अगर यूआरएल में पाथ शामिल नहीं है या दोनों अलग-अलग हैं, तो क्लाइंट सही तरीके से काम नहीं करेंगे.