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

1. परिचय

पिछले अपडेट की तारीख: 30-04-2019

आपको क्या बनाने को मिलेगा

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

आपको क्या सीखने को मिलेगा

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

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

• वेबसाइट/वेबपेज
• बदलाव करने के लिए कोई भी आईडीई
• 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 पर पहले ही बनाया जा चुका है
• measurement_id- इसे पाने के लिए, एडमिन > डेटा स्ट्रीम > अपनी स्ट्रीम चुनें पर जाएं . इसे इस तरह दिखाया जाना चाहिए

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

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

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

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

अब बटन पर क्लिक करें. इससे GA4 को एक टेस्ट इवेंट भेजा जाएगा

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

इवेंट भेजने के बाद, अपने GA4 खाते पर जाएं और रीयलटाइम रिपोर्ट देखें. आपको इवेंट दिखना चाहिए

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

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

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

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 से कनेक्ट करने और इन इवेंट को कन्वर्ज़न के तौर पर इंपोर्ट करने का भी सुझाव देते हैं.

आपने सीखा

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

रेफ़रंस दस्तावेज़

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