मेज़रमेंट प्रोटोकॉल का इस्तेमाल करके, GA4 को वेब इवेंट भेजना

1. परिचय

पिछली बार अपडेट किया गया: 30-04-2019

आपको क्या बनाना होगा

• इस कोडलैब में, मेज़रमेंट प्रोटोकॉल का इस्तेमाल करके GA4 को बाहरी इवेंट भेजने का तरीका बताया गया है.
• यह कोडलैब यह मानकर चलता है कि आपके पास पहले से ही कोई ऐसा वेबपेज/साइट है जिस पर Google Analytics 4 पहले से लागू है.

आपको इनके बारे में जानकारी मिलेगी

• पहली बार किसी सदस्य के तौर पर कॉल करने का तरीका
• कॉल के लिए ज़रूरी पैरामीटर को समझें
• टेस्ट कॉल भेजें और उसकी पुष्टि करें
• कॉल करने के लिए, Python में सैंपल स्क्रिप्ट बनाएं

आपको इन चीज़ों की ज़रूरत होगी

• वेबसाइट/वेबपेज
• बदलाव करने के लिए कोई भी IDE
• GA4 खाता
• ज़रूरी नहीं - Python डेवलपमेंट एनवायरमेंट (या Colab)

2. ज़रूरी फ़ील्ड इकट्ठा करें

GA4 में एपीआई सीक्रेट बनाना

GA4 पर जाएं और नया एपीआई सीक्रेट बनाने के लिए, एडमिन > डेटा स्ट्रीम > अपनी स्ट्रीम चुनें > मेज़रमेंट प्रोटोकॉल > कुछ लिखने या तैयार करने में मदद पाएँ

कोई भी निकनेम दिया जा सकता है. इससे सीक्रेट वैल्यू दिखेगी, जिसका इस्तेमाल कॉल में किया जा सकता है

client_id इकट्ठा करें

अपने client_id को इकट्ठा करने के लिए, आप नीचे दिए गए किसी भी तरीके का इस्तेमाल कर सकते हैं.

1. gTag की मदद से डेटा इकट्ठा करना

इन दोनों के बारे में नीचे ज़्यादा जानकारी दी गई है

gTag की मदद से डेटा इकट्ठा करना

आप इसका इस्तेमाल करके अपनी वेबसाइट के ज़रिए client_id को फिर से पा सकते हैं :

gtag('get', 'UA-XXXXXXXX-Y', 'client_id', (clientID) => {
  Do something with clientID)
}

आपके इन्फ़्रास्ट्रक्चर के हिसाब से, यहां कुछ और लिंक दिए गए हैं

• gtag.js(‘get')

3. कॉल तैयार करना

GA4 में इवेंट बिल्डर का इस्तेमाल करके, सैंपल कॉल बनाया जा सकता है. (इसके लिए आपको लॉगिन करना होगा और कुकी चालू करनी होंगी). पक्का करें कि टॉगल "gtag.js" पर सेट हो

आपको नीचे दिए गए फ़ील्ड भरने होंगे

• api_secret - GA4 पर पहले ही बनाया जा चुका है
• मेज़रमेंट_id- इसे पाने के लिए, एडमिन > डेटा स्ट्रीम > अपनी स्ट्रीम चुनें . इसे इस तरह से दिखाया जाना चाहिए

• client_id - आपने यह मान पहले ही लिया है
• user_id ज़रूरी नहीं है. फ़िलहाल, इसे खाली छोड़ा जा सकता है
• कैटगरी - इसे "पसंद के मुताबिक" में बदलें ड्रॉपडाउन मेन्यू से, अपनी पसंद के किसी भी इवेंट का नाम डालें. अपने-आप इकट्ठा होने वाले किसी इवेंट का इस्तेमाल न करें. यहां हम "test_from_codelab" का इस्तेमाल कर रहे हैं

इसके अलावा, नीचे दिए गए बटन पर क्लिक करके इवेंट पैरामीटर और/या उपयोगकर्ता प्रॉपर्टी भी उपलब्ध कराई जा सकती है

सब कुछ भर देने के बाद, आपको "इवेंट की पुष्टि करें" बटन के साथ कुछ ऐसा दिखाई देगा

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

अब इस बटन पर क्लिक किया जा सकता है. इससे GA4 को टेस्ट इवेंट भेजना चाहिए

4. GA4 में इवेंट की पुष्टि करना

इवेंट भेजने के बाद, अपने GA4 खाते में जाकर रीयलटाइम देखें. आपको इवेंट शुरू होते ही दिखेगा

इवेंट को रीयल टाइम व्यू से असल इवेंट रिपोर्टिंग टैब में लागू होने में करीब 24 घंटे लग सकते हैं. इसलिए, अगर आपको नियमित इवेंट रिपोर्टिंग में तुरंत यह न दिखे, तो चिंता करने की कोई ज़रूरत नहीं है!

5. Python स्क्रिप्ट बनाना

आपने इसकी जांच कर ली है. अब Python (या अपनी पसंद की किसी भी भाषा में) में ऐसा ही आर्किटेक्चर बनाने के लिए, एपीआई कॉल और इवेंट पेलोड की जांच की जा सकती है. इससे यह कॉल किया जा सकता है. इसके बाद, इसे अपनी पसंद के हिसाब से शेड्यूल करके, प्रोसेस किया जा सकता है. इस हिस्से के लिए, अपनी पसंद के किसी भी ऐसे IDE का इस्तेमाल किया जा सकता है जो Python के साथ काम करता है या सिर्फ़ Google Colab notebook का इस्तेमाल करें. इसके लिए, आपके डिवाइस पर किसी भी तरह के IDE की ज़रूरत नहीं होती है

GA4 इवेंट बिल्डर के बारे में बताने पर, आपको दिखेगा कि एंडपॉइंट नीचे दिया गया है

POST /mp/collect?measurement_id=XXXX&api_secret=XXXX 
HTTP/1.1
Host: www.google-analytics.com

इवेंट का पेलोड नीचे दिया गया था

{
  "client_id": XXXX,
  "non_personalized_ads": false,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}

आप इस तरह की सुविधा का इस्तेमाल करके इसका अनुवाद Python में कर सकते हैं

import requests
import json
url = "https://www.google-analytics.com/mp/collect?measurement_id=XXXX&api_secret=XXXX"
payload = {
  "client_id": XXXX,
  "non_personalized_ads": false,
  "events": [
    {
      "name": "test_from_codelab",
      "params": {
        "test_param": "test_123"
      }
    }
  ]
}
r = requests.post(url,data=json.dumps(payload),verify=True)
print(r.status_code)

इसे सही वैल्यू के साथ एक्ज़ीक्यूट करने के बाद, आपको GA4 में भी रीयलटाइम में इवेंट दिखेगा.

6. बधाई हो

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

आपने सीखा

• एमपी कॉल करने के लिए, सही वैरिएबल कैसे इकट्ठा करें
• टेस्ट इवेंट भेजने और उनकी पुष्टि करने का तरीका
• MP कॉल भेजने के लिए स्क्रिप्ट कैसे बनाएं

पहचान फ़ाइलें

• मेज़रमेंट प्रोटोकॉल - रेफ़रंस
• GA4 मेज़रमेंट प्रोटोकॉल - इवेंट बिल्डर
• मेज़रमेंट प्रोटोकॉल - खास जानकारी