मेज़रमेंट प्रोटोकॉल का रेफ़रंस

इस पेज पर, मेज़रमेंट प्रोटोकॉल के लिए ट्रांसपोर्ट मैकेनिज़्म और डेटा पैरामीटर के बारे में बताया गया है.

परिवहन

पूरा डेटा, एचटीटीपीएस POST अनुरोधों का इस्तेमाल करके सुरक्षित तरीके से भेजा जाना चाहिए.

यहां दिए गए एंडपॉइंट पर अनुरोध भेजें:

https://www.google-analytics.com/mp/collect

अगर आपको अपना डेटा ईयू में प्रोसेस करना है, तो इसके बजाय इस एंडपॉइंट का इस्तेमाल करें:

https://region1.google-analytics.com/mp/collect

यहां POST के अनुरोध का एक सैंपल दिया गया है:

POST /mp/collect HTTP/1.1
HOST: www.google-analytics.com
Content-Type: application/json
PAYLOAD_DATA

PAYLOAD_DATA को अनुरोध के Payload से बदलें.

अगर HTTP अनुरोध मिलता है, तो Measurement Protocol 2xx स्टेटस कोड दिखाता है. अगर पेलोड गलत फ़ॉर्मैट में है या डेटा गलत है या Google Analytics उसे प्रोसेस नहीं कर रहा है, तो Measurement Protocol कोई गड़बड़ी कोड नहीं दिखाता.

पेलोड

पेलोड के दो हिस्से होते हैं:

1. क्वेरी पैरामीटर.
2. JSON POST बॉडी.

क्वेरी पैरामीटर

JSON POST बॉडी

सामान्य इवेंट पैरामीटर

मेज़रमेंट प्रोटोकॉल में ये सामान्य इवेंट पैरामीटर होते हैं:

सहमति

consent एट्रिब्यूट, सहमति के टाइप और स्टेटस को कॉन्फ़िगर करता है. अगर आपने consent तय नहीं किया है, तो Google Analytics, क्लाइंट या ऐप्लिकेशन इंस्टेंस के लिए, ऑनलाइन इंटरैक्शन से जुड़ी सहमति की सेटिंग का इस्तेमाल करता है.

भौगोलिक जानकारी

user_location और ip_override एट्रिब्यूट से, भौगोलिक जानकारी मिलती है. user_location को ip_override की जगह प्राथमिकता दी जाती है.

यहां user_location फ़ील्ड का स्ट्रक्चर दिया गया है. ज़्यादा से ज़्यादा एट्रिब्यूट की वैल्यू दें. हमारा सुझाव है कि आप कम से कम country_id और region_id का इस्तेमाल करें.

यहां user_location का एक सैंपल दिया गया है:

"user_location": {
  "city": "Mountain View",
  "region_id": "US-CA",
  "country_id": "US",
  "subcontinent_id": "021",
  "continent_id": "019"
}

ip_override, user_location का विकल्प है. अगर आपने ip_override भेजा है, तो Google Analytics, आईपी पते से भौगोलिक जानकारी का पता लगाता है. अगर user_location भेजा जाता है, तो Google Analytics ip_override को अनदेखा कर देता है.

अगर user_location या ip_override नहीं भेजा जाता है, तो Google Analytics, टैग किए गए इवेंट से भौगोलिक जानकारी का पता लगाता है. इसके लिए, वह client_id.

Google Analytics, अनुरोध पर प्रॉपर्टी की जगह की सटीक जानकारी के डेटा की सेटिंग लागू करता है. भले ही, भौगोलिक जानकारी भेजी गई हो या नहीं.

डिवाइस की जानकारी

डिवाइस की जानकारी भेजने के लिए, device फ़ील्ड का इस्तेमाल करें. यहां device फ़ील्ड का स्ट्रक्चर दिया गया है. ज़्यादा से ज़्यादा एट्रिब्यूट की वैल्यू दें. हमारा सुझाव है कि कम से कम category का टारगेट सेट करें.

यहां दिए गए स्निपेट में, device सेटिंग का एक उदाहरण दिखाया गया है:

"device": {
  "category": "mobile",
  "language": "en",
  "screen_resolution": "1280x2856",
  "operating_system": "Android",
  "operating_system_version": "14",
  "model": "Pixel 9 Pro",
  "brand": "Google",
  "browser": "Chrome",
  "browser_version": "136.0.7103.60"
}

चाहे आपने में से कोई भी विकल्प चुना हो, Google Analytics अनुरोध पर प्रॉपर्टी की डिवाइस के डेटा की ज़्यादा जानकारी वाली सेटिंग लागू करता है.

कस्टम पैरामीटर

मेज़रमेंट प्रोटोकॉल के पेलोड में, उपयोगकर्ता के स्कोप वाले, इवेंट के स्कोप वाले, और आइटम के स्कोप वाले कस्टम पैरामीटर शामिल किए जा सकते हैं.

• user_properties में उपयोगकर्ता के स्कोप वाले कस्टम पैरामीटर शामिल किए जा सकते हैं.
• events[].params में इवेंट के स्कोप वाले कस्टम पैरामीटर शामिल किए जा सकते हैं.
• आइटम के स्कोप वाले कस्टम पैरामीटर को items में शामिल किया जा सकता है.

कुछ इवेंट के लिए सुझाई गई वैल्यू

कुछ इवेंट के लिए, सुझाए गए पैरामीटर होते हैं. सभी इवेंट के लिए सुझाए गए पैरामीटर देखने के लिए, इवेंट देखें.

रिज़र्व किए गए नाम

कुछ इवेंट, पैरामीटर, और उपयोगकर्ता प्रॉपर्टी के नाम रिज़र्व किए गए हैं. इनका इस्तेमाल नहीं किया जा सकता:

इवेंट के रिज़र्व किए गए नाम

नीचे दिए गए इवेंट के नाम रिज़र्व हैं. इनका इस्तेमाल नहीं किया जा सकता:

• ad_activeview
• ad_click
• ad_exposure
• ad_query
• ad_reward
• adunit_exposure
• app_clear_data
• app_exception
• app_install
• app_remove
• app_store_refund
• app_update
• app_upgrade
• dynamic_link_app_open
• dynamic_link_app_update
• dynamic_link_first_open
• error
• firebase_campaign
• firebase_in_app_message_action
• firebase_in_app_message_dismiss
• firebase_in_app_message_impression
• first_open
• first_visit
• in_app_purchase
• notification_dismiss
• notification_foreground
• notification_open
• notification_receive
• notification_send
• os_update
• session_start
• user_engagement

पैरामीटर के रिज़र्व किए गए नाम

नीचे दिए गए पैरामीटर के नाम रिज़र्व हैं. इनका इस्तेमाल नहीं किया जा सकता:

• firebase_conversion

पैरामीटर के नाम, इनसे शुरू नहीं हो सकते:

• _ (underscore)
• firebase_
• ga_
• google_
• gtag.

उपयोगकर्ता प्रॉपर्टी के रिज़र्व किए गए नाम

नीचे दी गई उपयोगकर्ता प्रॉपर्टी के नाम रिज़र्व हैं. इनका इस्तेमाल नहीं किया जा सकता:

• first_open_time
• first_visit_time
• last_deep_link_referrer
• user_id
• first_open_after_install

इसके अलावा, उपयोगकर्ता प्रॉपर्टी के नाम इनसे शुरू नहीं हो सकते:

• _ (underscore)
• firebase_
• ga_
• google_