इस गाइड में बताया गया है कि किसी Google Analytics सर्वर पर, Google Analytics मेज़रमेंट प्रोटोकॉल वेब और ऐप्लिकेशन स्ट्रीम इवेंट कैसे भेजा जा सकता है, ताकि Google Analytics रिपोर्ट में मेज़रमेंट प्रोटोकॉल इवेंट देखे जा सकें.
वह प्लैटफ़ॉर्म चुनें जिसे आपको इस गाइड में देखना है:
अनुरोध को फ़ॉर्मैट करना
Google Analytics 4 के लिए मेज़रमेंट प्रोटोकॉल सिर्फ़ एचटीटीपी POST
अनुरोधों के साथ काम करता है.
इवेंट भेजने के लिए, इस फ़ॉर्मैट का इस्तेमाल करें:
POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
<payload_data>
आपको अनुरोध के यूआरएल में यह जानकारी देनी होगी:
api_secret
: Google Analytics के यूज़र इंटरफ़ेस (यूआई) में जनरेट किया गया एपीआई सीक्रेट.नया सीक्रेट बनाने के लिए, एडमिन > डेटा स्ट्रीम > अपनी स्ट्रीम चुनें > मेज़रमेंट प्रोटोकॉल > बनाएं पर जाएं.
firebase_app_id
: Firebase का ऐप्लिकेशन आईडी, जो प्रोजेक्ट सेटिंग > सामान्य > आपके ऐप्लिकेशन > ऐप्लिकेशन आईडी में Firebase कंसोल में मिलता है.firebase_app_id
औरapp_instance_id
अलग-अलग हैं.firebase_app_id
आपके ऐप्लिकेशन की पहचान करता है, जबकिapp_instance_id
सिर्फ़ एक ऐप्लिकेशन को इंस्टॉल करने की पहचान करता है.
पूरी जानकारी के लिए, क्वेरी पैरामीटर देखें.
आपको अनुरोध के मुख्य हिस्से में यह जानकारी देनी होगी:
app_instance_id
: Firebase ऐप्लिकेशन इंस्टेंस के लिए यूनीक आइडेंटिफ़ायर. यह वेबclient_id
से अलग है:
user_id
: ज़रूरी नहीं. उपयोगकर्ता के लिए यूनीक आइडेंटिफ़ायर. इसमें सिर्फ़ utf-8 वर्ण हो सकते हैं. इस आइडेंटिफ़ायर के बारे में ज़्यादा जानकारी के लिए, क्रॉस-प्लैटफ़ॉर्म विश्लेषण के लिए User-ID देखें.consent
: ज़रूरी नहीं. सहमति की सेटिंग सेट करने का तरीका जानें.events
: इवेंट आइटम का कलेक्शन. एक अनुरोध में कई इवेंट शामिल किए जा सकते हैं.रीयलटाइम जैसी रिपोर्ट में उपयोगकर्ता गतिविधि दिखाने के लिए,
event
के लिएengagement_time_msec
औरsession_id
की जानकारी,params
के हिस्से के तौर पर दी जानी चाहिए.engagement_time_msec
पैरामीटर से, इवेंट के जुड़ाव का समय मिलीसेकंड में दिखना चाहिए.यहां एक उदाहरण दिया गया है:
{
"app_instance_id": "12345678901234567890123456789012",
"events": [
{
"name": "campaign_details",
"params": {
"campaign_id": "google_1234",
"campaign": "Summer_fun",
"source": "google",
"medium": "cpc",
"term": "summer+travel",
"content": "logolink",
"session_id": "123",
"engagement_time_msec": "100"
}
}
]
}
session_start
एक इवेंट का नाम है,
लेकिन नया session_id
बनाने पर, नया सेशन बन जाता है. इसके लिए,
session_start
भेजने की ज़रूरत नहीं होती. सेशन की गिनती
करने का तरीका समझें.
इसे आज़माएं
यहां एक उदाहरण दिया गया है. इसका इस्तेमाल, अपने Google Analytics सर्वर को tutorial_begin
इवेंट भेजने के लिए किया जा सकता है:
const firebase_app_id = `1:1234567890:android:321abc456def7890`;
const api_secret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?firebase_app_id=${firebase_app_id}&api_secret=${api_secret}`, {
method: "POST",
body: JSON.stringify({
app_instance_id: 'app_instance_id',
events: [{
name: 'tutorial_begin',
params: {},
}]
})
});
firebase_app_id
का फ़ॉर्मैट, प्लैटफ़ॉर्म के हिसाब से होता है. Firebase कॉन्फ़िगरेशन फ़ाइलें और ऑब्जेक्ट में जाकर, ऐप्लिकेशन आईडी देखें.
सीमाएं
Google Analytics को मेज़रमेंट प्रोटोकॉल इवेंट भेजने पर ये सीमाएं लागू होती हैं:
- अनुरोधों में ज़्यादा से ज़्यादा 25 इवेंट हो सकते हैं.
- इवेंट में ज़्यादा से ज़्यादा 25 पैरामीटर हो सकते हैं.
- इवेंट में ज़्यादा से ज़्यादा 25 उपयोगकर्ता प्रॉपर्टी हो सकती हैं.
- उपयोगकर्ता प्रॉपर्टी के नामों में 24 या इससे कम वर्ण होने चाहिए.
- उपयोगकर्ता प्रॉपर्टी की वैल्यू में 36 या इससे कम वर्ण होने चाहिए.
- इवेंट के नामों में 40 या इससे कम वर्ण होने चाहिए. इनमें सिर्फ़ ऐल्फ़ा-न्यूमेरिक (अक्षर और अंक) वर्ण और अंडरस्कोर हो सकते हैं. साथ ही, इनकी शुरुआत अक्षर से होनी चाहिए.
- आइटम पैरामीटर के साथ-साथ, पैरामीटर के नामों में 40 या इससे कम वर्ण होने चाहिए. इनमें सिर्फ़ ऐल्फ़ा-न्यूमेरिक वर्ण और अंडरस्कोर हो सकते हैं. साथ ही, इनकी शुरुआत अक्षर से होनी चाहिए.
- आइटम की पैरामीटर वैल्यू वाले पैरामीटर की वैल्यू में, स्टैंडर्ड Google Analytics 4 प्रॉपर्टी के लिए 100 या इससे कम वर्ण होने चाहिए. साथ ही, Google Analytics 360 प्रॉपर्टी के लिए पैरामीटर वैल्यू में 500 या उससे कम वर्ण होने चाहिए.
- आइटम पैरामीटर में ज़्यादा से ज़्यादा 10 कस्टम पैरामीटर हो सकते हैं.
- पोस्ट का मुख्य भाग 130kB से कम होना चाहिए.
- मेज़रमेंट प्रोटोकॉल इवेंट से इवेंट-लेवल एट्रिब्यूशन को Google Ads में कन्वर्ज़न एक्सपोर्ट करने और दूसरे मीडिया इंटिग्रेशन के लिए, सबसे हाल की टैगिंग के ऑनलाइन इवेंट के बाद तक 63 दिनों तक काम किया जा सकता है. भले ही, कन्वर्ज़न इवेंट के लिए कन्वर्ज़न विंडो 63 दिनों से ज़्यादा की हो. वहीं दूसरी ओर, ऑनलाइन इवेंट को टैग करने के लिए इवेंट-लेवल का एट्रिब्यूशन, पूरी कन्वर्ज़न विंडो पर काम करता है.
- रीमार्केटिंग के मकसद से, किसी जुड़ी हुई कुकी या डिवाइस आईडी के साथ सबसे हाल के ऑनलाइन इवेंट के बाद के दिनों में, मेज़रमेंट प्रोटोकॉल इवेंट में शामिल हुआ जा सकता है:
- वेब स्ट्रीम: 30 दिन
- ऐप्लिकेशन स्ट्रीम: 42 दिन
- Google Analytics 4 को भेजे गए ऐप्लिकेशन मेज़रमेंट प्रोटोकॉल इवेंट, ऐप्लिकेशन के उपयोगकर्ताओं के लिए Google Ads में सर्च ऑडियंस को नहीं दिखाते.