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

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

परिवहन

सभी डेटा को एचटीटीपीएस 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 को अनुरोध के पेलोड से बदलें.

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

पेलोड

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

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

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

पैरामीटर का नाम ब्यौरा

api_secret

 ज़रूरी है. Google Analytics के यूज़र इंटरफ़ेस (यूआई) से एपीआई पासकोड.

यह एडमिन > डेटा स्ट्रीम > अपनी स्ट्रीम चुनें > मेज़रमेंट प्रोटोकॉल > बनाएं में मौजूद होता है.

आपके संगठन के लिए निजी. ज़्यादा स्पैम से बचने के लिए, इसे नियमित तौर पर अपडेट किया जाना चाहिए.

JSON POST बॉडी

कुंजी टाइप ब्यौरा

user_id

 string

Optional. उपयोगकर्ता के लिए यूनीक आइडेंटिफ़ायर. इस आइडेंटिफ़ायर के बारे में ज़्यादा जानने के लिए, क्रॉस-प्लैटफ़ॉर्म विश्लेषण के लिए User-ID देखें. इसमें सिर्फ़ UTF-8 वर्ण शामिल किए जा सकते हैं.

timestamp_micros

 number

Optional. यूनिक्स टाइमस्टैंप, माइक्रोसेकंड में, न कि मिलीसेकंड में. इवेंट के शुरू होने का समय दिखाता है. इसे सिर्फ़ उन इवेंट को रिकॉर्ड करने के लिए सेट किया जाना चाहिए जो पहले हो चुके हैं. इसे user_property या इवेंट के टाइमस्टैंप से बदला जा सकता है. प्रॉपर्टी के टाइमज़ोन के आधार पर, इवेंट को ज़्यादा से ज़्यादा तीन दिन पहले का बताया जा सकता है.

user_properties

 object Optional. मेज़रमेंट के लिए उपयोगकर्ता प्रॉपर्टी.

user_data

 object Optional. उपयोगकर्ता से मिला डेटा.
object Optional. अनुरोध के लिए सहमति की सेटिंग. ज़्यादा जानकारी के लिए, सहमति वाला सेक्शन देखें.

non_personalized_ads

 boolean ज़रूरी नहीं है. उपयोगकर्ता के डेटा का इस्तेमाल, दिलचस्पी के मुताबिक विज्ञापन दिखाने के लिए नहीं किया जाना चाहिए, यह बताने के लिए इसे true पर सेट करें.

user_location

 object Optional. अनुरोध के लिए, जगह की जानकारी को स्ट्रक्चर्ड फ़ॉर्मैट में सेट करता है.

ip_override

 string Optional. आईपी पता, जिसका इस्तेमाल Google Analytics, अनुरोध के लिए जगह की जानकारी पाने के लिए करता है.

events[]

 array ज़रूरी है. event आइटम का कलेक्शन. हर अनुरोध में ज़्यादा से ज़्यादा 25 इवेंट भेजे जा सकते हैं. सभी मान्य इवेंट के लिए, इवेंट का रेफ़रंस देखें.

events[].name

 string ज़रूरी है. इवेंट का नाम. सभी विकल्पों के लिए इवेंट देखें.

events[].params

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

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

कुंजी टाइप ब्यौरा

ad_user_data

 string

Optional. विज्ञापन दिखाने के मकसद से, अनुरोध के इवेंट और उपयोगकर्ता प्रॉपर्टी से उपयोगकर्ता का डेटा Google को भेजने की सहमति.

GRANTED या DENIED.

ad_personalization

 string

Optional. उपयोगकर्ता के लिए, दिलचस्पी के मुताबिक विज्ञापन दिखाने की सहमति.

GRANTED या DENIED.

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

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

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

कुंजी टाइप ब्यौरा

city

 string Optional. शहर का नाम.

region_id

 string Optional. ISO 3166 के मुताबिक देश और उसका सबडिवीज़न. उदाहरण के लिए, US-CA, US-AR, CA-BC, GB-LND, CN-HK.

country_id

 string Optional. ISO 3166-1 alpha-2 फ़ॉर्मैट में देश का नाम. उदाहरण के लिए, US, AU, ES, FR.

subcontinent_id

 string Optional. उपमहाद्वीप का नाम UN M49 फ़ॉर्मैट में. उदाहरण के लिए, 011, 021, 030, 039.

continent_id

 string Optional. महाद्वीप का नाम UN M49 फ़ॉर्मैट में. उदाहरण के लिए, 002, 019, 142, 150.

यहां 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, प्रॉपर्टी की जगह की जानकारी के डेटा की ज़्यादा जानकारी वाली सेटिंग को अनुरोध पर लागू करता है. भले ही, भेजी गई भौगोलिक जानकारी कुछ भी हो.

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

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

  • 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_