1 परिचय
अंतिम अद्यतन: 2021-06-08
आप क्या बनाएंगे
इस कोडलैब में, आप सीखेंगे कि मापन प्रोटोकॉल का उपयोग करके बाहरी घटनाओं को GA4 पर कैसे भेजा जाए।
यह कोडलैब मानता है कि आपके पास पहले से ही फायरबेस के लिए Google Analytics वाला एक ऐप लागू है। यदि आप सीखना चाहते हैं कि फायरबेस के लिए Google Analytics के साथ कैसे एकीकृत किया जाए, तो कृपया पहले इस कोडलैब को देखें। यदि आप सीखना चाहते हैं कि फायरबेस के साथ ऐप कैसे बनाया जाए, तो कृपया फायरबेस एंड्रॉइड कोडेलैब-बिल्ड फ्रेंडली चैट देखें।
आप क्या सीखेंगे
- अपना पहला एमपी कॉल करने के चरण
- कॉल के लिए आवश्यक पैरामीटर समझें
- अपना परीक्षण कॉल भेजें और सत्यापित करें
- कॉल करने के लिए पायथन में एक नमूना स्क्रिप्ट बनाएं
आपको किस चीज़ की ज़रूरत पड़ेगी
- आपका Android या iOS ऐप
- परिवर्तन करने के लिए कोई भी आईडीई
- GA4 खाता
- वैकल्पिक - पायथन विकास वातावरण (या कोलाब )
2. अनिवार्य फ़ील्ड एकत्रित करें
GA4 में एपीआई सीक्रेट बनाएं
GA4 पर नेविगेट करें और एडमिन > डेटा स्ट्रीम > अपनी स्ट्रीम चुनें > मापन प्रोटोकॉल > क्रिएट पर नेविगेट करके अपना नया एपीआई रहस्य बनाएं
आप कोई भी उपनाम प्रदान कर सकते हैं, और गुप्त मूल्य प्रदर्शित किया जाएगा, जिसे आप अपने कॉल में उपयोग कर सकते हैं
यदि आप सुनिश्चित नहीं हैं कि GA4 तक कैसे पहुंचें, तो आप अपने फायरबेस प्रोजेक्ट पर जा सकते हैं, प्रोजेक्ट सेटिंग्स> इंटीग्रेशन> Google Analytics की जांच कर सकते हैं और "प्रबंधित करें" पर क्लिक कर सकते हैं। Google Analytics कनेक्शन दृश्यमान होना चाहिए, और आप वहां से सीधे नेविगेट भी कर सकते हैं
ऐप_इंस्टेंस_आईडी एकत्र करें
आप अपना ऐप_इंस्टेंस_आईडी एकत्र करने के लिए नीचे दिए गए किसी भी तरीके का उपयोग कर सकते हैं।
- BigQuery निर्यात का उपयोग करना
- आपके ऐप सोर्स कोड में मूल रूप से लाया जा रहा है
इन दोनों के बारे में नीचे विस्तार से बताया गया है
- BigQuery निर्यात का उपयोग करना
यदि आपके पास BigQuery निर्यात सक्षम है, तो आप नीचे दिए गए चरणों का पालन कर सकते हैं
- फायरबेस में साइन इन करें
- प्रोजेक्ट सेटिंग्स > एकीकरण > BigQuery पर नेविगेट करें
- डेटासेट के पास "BigQuery में देखें" पर क्लिक करें
ध्यान दें: डेटासेट लगभग 24-48 घंटों के लिए टॉगल सक्षम होने के बाद ही उपलब्ध होगा
- BigQuery में, आप तालिका में user_pseudo_id की जांच कर सकते हैं। यह ऐप_इंस्टेंस_आईडी है जिसे आप अपने कॉल में उपयोग कर सकते हैं
- आपके ऐप सोर्स कोड में मूल रूप से लाया जा रहा है
यदि आपका ऐप जावा का उपयोग करके बनाया गया है, तो आप ऐप_इंस्टेंस_आईडी को पुनः प्राप्त करने के लिए कुछ इस तरह का उपयोग कर सकते हैं
FirebaseAnalytics.getInstance(this).getAppInstanceId().addOnCompleteListener(new OnCompleteListener<String>() {
@Override
public void onComplete(@NonNull Task<String> task) {
if (task.isSuccessful()) {
String user_pseudo_id = task.getResult();
}
}
});
कोटलिन के लिए, आप नीचे आज़मा सकते हैं
Thread {
Firebase.analytics.appInstanceId.addOnSuccessListener { user_pseudo_id ->
Log.d("Firebase", "user_pseudo_id using appInstanceId is $user_pseudo_id")
/*
Store the value to your server or do something with the retrieved id
*/
}
}.start()
यदि आपके पास iOS ऐप है, तो आप स्विफ्ट में निम्नलिखित का उपयोग कर सकते हैं
let user_pseudo_id = Analytics.appInstanceID()
print("user_pseudo_id = \(user_pseudo_id)")
/*
Store the value to your server or do something with the retrieved id
*/
आपके बुनियादी ढांचे के आधार पर नीचे अधिक लिंक दिए गए हैं
3. कॉल का निर्माण
आप GA4 में इवेंट बिल्डर का उपयोग करके एक नमूना कॉल बना सकते हैं। (इसके लिए आपको लॉगिन करना होगा और कुकीज़ सक्षम करनी होंगी)। सुनिश्चित करें कि टॉगल "फ़ायरबेस" पर सेट है
आपको निम्नलिखित फ़ील्ड भरने की आवश्यकता होगी
- api_secret - GA4 पर पहले ही बनाया जा चुका है
- firebase_app_id - इसे प्राप्त करने के लिए, आप एडमिन > डेटा स्ट्रीम > अपनी स्ट्रीम चुनें पर नेविगेट कर सकते हैं। इसे नीचे के रूप में प्रदर्शित किया जाना चाहिए
- ऐप_इंस्टेंस_आईडी - आपने यह मान पहले ही प्राप्त कर लिया है
- user_id अनिवार्य नहीं है. आप इसे अभी खाली छोड़ सकते हैं
- श्रेणी - इसे ड्रॉपडाउन से "कस्टम" में बदलें, और अपनी पसंद का कोई भी ईवेंट नाम डालें (किसी भी ऑटो एकत्रित ईवेंट का उपयोग न करें)। यहां हम "test_from_codelab" का उपयोग कर रहे हैं
वैकल्पिक रूप से, आप नीचे दिए गए बटनों पर क्लिक करके ईवेंट पैरामीटर और/या उपयोगकर्ता गुण प्रदान करना भी चुन सकते हैं
एक बार जब आप सब कुछ भर देते हैं, तो आपको "घटना मान्य करें" बटन के साथ कुछ इस तरह दिखना चाहिए
एक बार जब आप यहां पहुंच जाएं, तो नारंगी रंग में हाइलाइट किए गए बटन "VALIDATE EVENT" पर क्लिक करें। इसे नीचे संदेश प्रदर्शित करना चाहिए, जिसमें यह निर्दिष्ट किया गया हो कि ईवेंट वैध है, और आपको अब "SEND TO GA" बटन दिखाई देगा। इस बिंदु पर, यदि ईवेंट अमान्य के रूप में सामने आता है, तो टूल आपको सटीक फ़ील्ड बताएगा जहां कोई समस्या है, और आप उसे ठीक कर सकते हैं और पुनः प्रयास कर सकते हैं
अब आप बटन पर क्लिक कर सकते हैं, और इसे GA4 पर एक परीक्षण ईवेंट भेजना चाहिए
4. GA4 में घटनाओं को मान्य करना
एक बार ईवेंट भेजने के बाद, आप अपने GA4 खाते पर नेविगेट कर सकते हैं और रीयलटाइम जांच सकते हैं। आपको घटना को घटित होते हुए देखना चाहिए
इवेंट को वास्तविक समय दृश्य से वास्तविक इवेंट रिपोर्टिंग टैब तक प्रसारित होने में लगभग 24 घंटे लग सकते हैं, इसलिए यदि आपको यह नियमित इवेंट रिपोर्टिंग में तुरंत नहीं दिखाई देता है, तो चिंता करने की कोई आवश्यकता नहीं है!
यदि आप समस्याओं या विसंगतियों का सामना कर रहे हैं, तो यहां मापन प्रोटोकॉल की ज्ञात सीमाओं की जांच करना उपयोगी हो सकता है
5. पायथन स्क्रिप्ट का निर्माण
अब जब आपने इसका परीक्षण कर लिया है, तो आप पायथन (या अपनी पसंद की किसी भी भाषा में) में एक समान आर्किटेक्चर बनाने के लिए एपीआई कॉल और इवेंट पेलोड की जांच कर सकते हैं जो यह कॉल कर सकता है। फिर आप इसे अपनी इच्छित आवृत्ति पर शेड्यूल कर सकते हैं और इसे क्रियान्वित कर सकते हैं। इस भाग के लिए, आप या तो अपनी पसंद के किसी भी आईडीई का उपयोग कर सकते हैं जो पायथन का समर्थन करता है या केवल Google Colab नोटबुक का उपयोग कर सकता है जिसे आपके डिवाइस पर किसी इंस्टॉलेशन की आवश्यकता नहीं है
GA4 इवेंट बिल्डर का संदर्भ लेते हुए, आप देखेंगे कि समापन बिंदु नीचे दिया गया है
POST /mp/collect?firebase_app_id=XXXX&api_secret=XXXX
HTTP/1.1
Host: www.google-analytics.com
इवेंट पेलोड इस प्रकार था
{
"app_instance_id": XXXX,
"non_personalized_ads": false,
"events": [
{
"name": "test_from_codelab",
"params": {
"test_param": "test_123"
}
}
]
}
आप कुछ इस तरह का उपयोग करके इसे पायथन में अनुवाद कर सकते हैं
import requests
import json
url = "https://www.google-analytics.com/mp/collect?firebase_app_id=XXXX&api_secret=XXXX"
payload = {
"app_instance_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 से जुड़ने और इन घटनाओं को रूपांतरण के रूप में आयात करने का भी सुझाव देते हैं। आप इस पर विस्तृत निर्देशों के लिए इस कोडलैब में चरण 6 का संदर्भ ले सकते हैं। रूपांतरण ट्रैकिंग उद्देश्यों के लिए, Google विज्ञापन केवल वही डेटा दिखाएगा जो पिछले 60 दिनों के भीतर फायरबेस एसडीके से एकत्र किए गए आईडीएफए या डिवाइस आईडी से जुड़ा है। ध्यान रखें कि यह अभी भी एक अल्फा एपीआई है और यहां सूचीबद्ध सीमाओं से गुजरना सुनिश्चित करें जिन्हें पूर्ण लॉन्च से पहले संबोधित किया जाना चाहिए
आपने सीखा है
- एमपी कॉल करने के लिए सही वेरिएबल कैसे एकत्र करें
- परीक्षण ईवेंट कैसे भेजें और सत्यापित करें
- एमपी कॉल भेजने के लिए स्क्रिप्ट कैसे बनाएं