इस दस्तावेज़ में, सर्वर-साइड कंटेनर को इवेंट भेजने के अलग-अलग तरीकों के बारे में बताया गया है. अगर आपको इस बारे में ज़्यादा जानकारी चाहिए, तो सर्वर-साइड टैगिंग कैसे काम करती है लेख पढ़ें.
इस दस्तावेज़ में, इन कामों को करने का तरीका बताया गया है:
- किसी वेबसाइट से अपने सर्वर-साइड कंटेनर में डेटा भेजना
- किसी सर्वर कंटेनर को अतिरिक्त डेटा भेजना
- अपने सर्वर साइड कंटेनर में डेटा पाना
- वेबसाइटों के अलावा अन्य सोर्स से डेटा भेजना
शुरू करने से पहले
इस गाइड में यह माना गया है कि आपके पास पहले से ही:
1. किसी वेबसाइट से अपने सर्वर साइड कंटेनर में डेटा भेजना
Tag Manager या gtag.js की मदद से, सर्वर-साइड सेटअप करके डेटा को रूट किया जा सकता है. लागू करने का विकल्प चुनें.
ज़रूरी नहीं: हर इवेंट के साथ अतिरिक्त पैरामीटर भेजें
दो तरह के अतिरिक्त पैरामीटर भेजे जा सकते हैं: कॉन्फ़िगरेशन-लेवल के पैरामीटर और इवेंट-लेवल के पैरामीटर. कॉन्फ़िगरेशन पैरामीटर से यह तय होता है कि आपका Google टैग या Google Analytics डेस्टिनेशन टैग कैसे काम करेगा. इन्हें सिर्फ़ Google टैग या Google Analytics डेस्टिनेशन टैग लेवल पर सेट किया जा सकता है.
इवेंट पैरामीटर, किसी इवेंट के बारे में अतिरिक्त जानकारी देते हैं. इन्हें सभी इवेंट, चुने गए इवेंट या page_view इवेंट के लिए सेट किया जा सकता है.
सेटअप से जुड़े सुझाव
हमारा सुझाव है कि सर्वर कंटेनर में डेटा भेजने के लिए, वेब पेज पर Google Analytics टैग का इस्तेमाल करें. यह टैग, इवेंट की डिलीवरी रेट को बेहतर बनाने के लिए, डेटा ट्रांसफ़र करने के अलग-अलग तरीके इस्तेमाल कर सकता है. इन तरीकों में ये शामिल हैं. हालांकि, इनके अलावा और भी तरीके हो सकते हैं
- इमेज पिक्सल
- Fetch API
- एक्सएचआर
- सर्विस वर्कर, जो आपके सर्वर कंटेनर डोमेन से लोड किए गए iframe में चलता है.
यह पक्का करने के लिए कि सभी तरीके काम कर रहे हैं, यहां दी गई जानकारी देखें:
कॉन्टेंट की सुरक्षा के लिए नीति (सीएसपी)
| डायरेक्टिव | कॉन्टेंट | मकसद |
| img-src | [SERVER_CONTAINER_URL] | मेज़रमेंट के अनुरोध |
| connect-src | [SERVER_CONTAINER_URL] | मेज़रमेंट के अनुरोध |
| frame-src | [SERVER_CONTAINER_URL] | सर्विस वर्कर को लागू करना |
इसके अलावा, X-Frame-Options को सर्वर कंटेनर यूआरएल से iframe लोड करने पर पाबंदी नहीं लगानी चाहिए.
हर प्रॉडक्ट के लिए खास नीतियां जानने के लिए, https://developers.google.com/tag-platform/security/guides/csp पर जाएं.
2. अपने सर्वर साइड कंटेनर में डेटा पाना
जब सर्वर कंटेनर को एचटीटीपी अनुरोध भेजा जाता है, तो क्लाइंट को उस अनुरोध पर दावा करना होता है.
उपलब्ध क्लाइंट की सूची देखने के लिए:
अपना सर्वर कंटेनर खोलें.
बाईं ओर मौजूद नेविगेशन बार में, क्लाइंट पर क्लिक करें. Google Analytics क्लाइंट, आपके सर्वर-साइड कंटेनर में डिफ़ॉल्ट रूप से पहले से इंस्टॉल होता है.
जानकारी देखने या उसमें बदलाव करने के लिए, क्लाइंट के नाम पर क्लिक करें.
क्लाइंट की वैकल्पिक सेटिंग
ज़्यादातर मामलों में, क्लाइंट को कोई बदलाव करने की ज़रूरत नहीं होगी. हालांकि, आपके इस्तेमाल का उदाहरण अलग हो सकता है और आपको इनमें से किसी एक सेटिंग में बदलाव करना पड़ सकता है:
प्राथमिकता: इससे यह तय होता है कि क्लाइंट किस क्रम में चलेंगे. ज़्यादा नंबर वाले क्लाइंट पहले चलते हैं. साथ ही, आने वाले अनुरोध से मैच करने वाला पहला क्लाइंट, उस अनुरोध के लिए ऐक्टिव क्लाइंट बन जाएगा.
चालू करने के लिए ज़रूरी शर्तें: चालू करने के लिए ज़रूरी शर्तों से यह तय होता है कि क्लाइंट अनुरोधों का जवाब कब देगा:
- कुछ चुनिंदा आईडी के लिए डिफ़ॉल्ट gtag.js पाथ: इस सेटिंग का इस्तेमाल करके, अपने सर्वर कंटेनर यूआरएल की मदद से लागू किए जा रहे gtag.js JavaScript को चालू करें. चालू होने पर, डिफ़ॉल्ट gtag.js अनुरोध पाथ के अनुरोधों के जवाब में, यह क्लाइंट चालू हो जाएगा. उदाहरण के लिए,
/gtag/js?id=TAG_ID. एक या उससे ज़्यादा डेस्टिनेशन आईडी जोड़ने के लिए, मेज़रमेंट आईडी जोड़ें पर क्लिक करें.
- कुछ चुनिंदा आईडी के लिए डिफ़ॉल्ट gtag.js पाथ: इस सेटिंग का इस्तेमाल करके, अपने सर्वर कंटेनर यूआरएल की मदद से लागू किए जा रहे gtag.js JavaScript को चालू करें. चालू होने पर, डिफ़ॉल्ट gtag.js अनुरोध पाथ के अनुरोधों के जवाब में, यह क्लाइंट चालू हो जाएगा. उदाहरण के लिए,
ज़रूरी नहीं: सर्वर साइड Tag Manager में अतिरिक्त डेटा पाना
अगर आपको अतिरिक्त पैरामीटर भेजने हैं, तो आपको अपने सर्वर कंटेनर में Google Analytics क्लाइंट सेट अप करना होगा. इससे अतिरिक्त पैरामीटर को पार्स किया जा सकेगा और उनसे इवेंट डेटा बनाया जा सकेगा.
सर्वर के कुछ टैग, बिना किसी सेटअप के अपने आउटबाउंड अनुरोधों में अतिरिक्त पैरामीटर शामिल करेंगे. उन पैरामीटर को बाहर रखने के लिए, वैल्यू हटाने के लिए ट्रांसफ़ॉर्मेशन बनाएं.
अन्य टैग में अतिरिक्त पैरामीटर इस्तेमाल करने के लिए:
- अपने सर्वर कंटेनर में, बाईं ओर मौजूद नेविगेशन में जाकर वैरिएबल पर क्लिक करें.
- उपयोगकर्ता के हिसाब से तय किया गया नया वैरिएबल बनाएं.
- वैरिएबल कॉन्फ़िगरेशन में, वैरिएबल टाइप इवेंट डेटा चुनें.
- कुंजी का पाथ में, पैरामीटर का नाम डालें.
- वैरिएबल को नाम देकर सेव करें.
अब अपने सर्वर कंटेनर में मौजूद किसी भी अन्य टैग में, इवेंट पैरामीटर का इस्तेमाल किया जा सकता है.
3. ज़रूरी नहीं: वेबसाइटों के अलावा अन्य सोर्स से डेटा भेजना
Google Analytics मेज़रमेंट प्रोटोकॉल का इस्तेमाल, मोबाइल ऐप्लिकेशन और सर्वर-टू-सर्वर ऐप्लिकेशन जैसे सोर्स से सर्वर-साइड टैगिंग की सुविधा चालू करने के लिए किया जा सकता है. इस विकल्प की मदद से, मेज़रमेंट प्रोटोकॉल फ़ॉर्मैट में अपने कंटेनर को इवेंट भेजे जा सकते हैं. कंटेनर, उन इवेंट को Google Analytics पर भेजता है. इसके लिए, वह उसी तरीके का इस्तेमाल करता है जिसका इस्तेमाल सभी sGTM इवेंट के लिए किया जाता है.
इस विकल्प में, मेज़रमेंट प्रोटोकॉल एंडपॉइंट की सभी सुविधाएं काम नहीं करती हैं. जैसे, टैगिंग इवेंट से जगह और डिवाइस की जानकारी पाना.
मोबाइल ऐप्लिकेशन
अपने Android या iOS ऐप्लिकेशन से सर्वर कंटेनर को डेटा भेजने के लिए, आपको एक कस्टम इमेज टैग बनाना होगा. साथ ही, उसे मेज़रमेंट प्रोटोकॉल का इस्तेमाल करने के लिए कॉन्फ़िगर करना होगा:
- अपने मोबाइल कंटेनर (Android या iOS) में, टैग > नया पर क्लिक करें.
- टैग कॉन्फ़िगरेशन में जाकर, कस्टम इमेज टैग टाइप चुनें.
- इमेज यूआरएल की वैल्यू को सर्वर कंटेनर पर मौजूद पिक्सल इमेज पर सेट करें. यह इमेज, मेज़रमेंट प्रोटोकॉल क्लाइंट में उस पाथ पर मौजूद होनी चाहिए जिसे आपने पहले तय किया था.
अपने पिक्सल यूआरएल के आखिर में, अपनी पसंद के मुताबिक कोई भी मेज़रमेंट प्रोटोकॉल पैरामीटर जोड़ें:
https://custom.example.com/app?v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home - कैश बस्टिंग चालू करें से चुनें का निशान हटाएं.
- टैग को सेव करें और कंटेनर को पब्लिश करें.
- अपने सर्वर-साइड कंटेनर में, क्लाइंट > नया पर क्लिक करें.
- क्लाइंट कॉन्फ़िगरेशन में, मेज़रमेंट प्रोटोकॉल क्लाइंट टाइप चुनें.
- चालू करने का पाथ को अपने ऐप्लिकेशन के कलेक्शन एंडपॉइंट के पाथ पर सेट करें.
- क्लाइंट कॉन्फ़िगरेशन को सेव करें और सर्वर-साइड कंटेनर को पब्लिश करें.
सर्वर-टू-सर्वर ऐप्लिकेशन
अपने सर्वर कंटेनर को मेज़रमेंट प्रोटोकॉल डेटा भेजने के लिए, www.google-analytics.com होस्टनेम की जगह अपने सर्वर कंटेनर का डोमेन नेम डालें. उदाहरण के लिए:
POST /batch HTTP/1.1
Host: collection.example.com
v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home
मेज़रमेंट प्रोटोकॉल हिट पाने के लिए, मेज़रमेंट प्रोटोकॉल क्लाइंट की मदद से, सर्वर साइड Tag Manager इंस्टॉलेशन को कॉन्फ़िगर करें:
- अपने सर्वर-साइड कंटेनर में, क्लाइंट > नया पर क्लिक करें.
- क्लाइंट कॉन्फ़िगरेशन में, मेज़रमेंट प्रोटोकॉल क्लाइंट टाइप चुनें.
- ऐक्टिवेशन पाथ को अपने सर्वर के एंडपॉइंट के पाथ पर सेट करें.
- क्लाइंट कॉन्फ़िगरेशन को सेव करें और कंटेनर को पब्लिश करें.
अगले चरण
पहले पक्ष के कॉन्टेक्स्ट में डेटा भेजने के लिए, आपको अपने सर्वर से Google स्क्रिप्ट, जैसे कि Google Analytics लाइब्रेरी को चलाना होगा.