इस गाइड में बताया गया है कि 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
: इवेंट आइटम का कलेक्शन. एक अनुरोध में, एक से ज़्यादा इवेंट शामिल किए जा सकते हैं.रीयलटाइम जैसी रिपोर्ट में उपयोगकर्ता गतिविधि को दिखाने के लिए,
engagement_time_msec
औरsession_id
कोevent
के लिए,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 या उससे कम वर्ण होने चाहिए. इनमें सिर्फ़ ऐल्फ़ा-न्यूमेरिक वर्ण और अंडरस्कोर हो सकते हैं. साथ ही, इनकी शुरुआत अक्षर से होनी चाहिए.
- पैरामीटर वैल्यू में आइटम पैरामीटर वैल्यू भी शामिल होती हैं. इन वैल्यू में 100 या कम वर्ण होने चाहिए.
- आइटम पैरामीटर में ज़्यादा से ज़्यादा 10 कस्टम पैरामीटर हो सकते हैं.
- पोस्ट का मुख्य भाग 130kB से छोटा होना चाहिए.
- मेज़रमेंट प्रोटोकॉल इवेंट से मिला इवेंट-लेवल एट्रिब्यूशन, हाल ही में टैग किए गए ऑनलाइन इवेंट के 63 दिन बाद तक काम करता है. इस सुविधा की मदद से विज्ञापनों और दूसरे मीडिया इंटिग्रेशन में कन्वर्ज़न एक्सपोर्ट किया जा सकता है. भले ही, कन्वर्ज़न इवेंट की कन्वर्ज़न विंडो 63 दिन से ज़्यादा की हो. वहीं दूसरी ओर, ऑनलाइन इवेंट को टैग करने के लिए इवेंट-लेवल एट्रिब्यूशन, पूरी कन्वर्ज़न विंडो के लिए काम करता है.
- रीमार्केटिंग के लिए, मेज़रमेंट प्रोटोकॉल इवेंट में शामिल हुआ जा सकता है. ऐसा किसी कुकी या डिवाइस आईडी से, सबसे हाल ही के ऑनलाइन इवेंट के बाद इतने दिनों तक किया जा सकता है:
- वेब स्ट्रीम: 30 दिन
- ऐप्लिकेशन स्ट्रीम: 42 दिन
- Google Analytics 4 को भेजे गए ऐप्लिकेशन मेज़रमेंट प्रोटोकॉल इवेंट, ऐप्लिकेशन के उपयोगकर्ताओं के लिए Google Ads में, सर्च ऑडियंस में अपने-आप जानकारी नहीं दिखाते.