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

खास जानकारी

मेज़रमेंट का इस्तेमाल करके, Google Analytics को डेटा दो हिस्सों में भेजा जाता है प्रोटोकॉल:

  1. यात्रा - डेटा कहां और कैसे भेजा जाता है
  2. पेलोड - आपका भेजा जाने वाला डेटा

इस दस्तावेज़ में बताया गया है कि ट्रांसपोर्ट और पेलोड को कैसे फ़ॉर्मैट किया जाता है.

परिवहन

यूआरएल एंडपॉइंट

आप नीचे दिया गया एंडपॉइंट:

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

कोई इवेंट भेजने के लिए, POST का यह अनुरोध करें:

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

रिस्पॉन्स कोड

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

पेलोड

मेज़रमेंट प्रोटोकॉल डेटा का इस्तेमाल करके Google Analytics को डेटा भेजा जाता है. इसके लिए, वाहन के पुर्ज़े:

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

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

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

api_secret

ज़रूरी है. API Secret, जो इसके ज़रिए जनरेट होता है Google Analytics यूज़र इंटरफ़ेस (यूआई) की इमेज.

नया सीक्रेट बनाने के लिए, Google Analytics के यूज़र इंटरफ़ेस (यूआई) पर जाएं. इसके बाद:
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है एडमिन > डेटा स्ट्रीम > अपनी स्ट्रीम चुनें &gt; मेज़रमेंट प्रोटोकॉल > बनाएं

हमारा सुझाव है कि आप इन्हें अपने संगठन के लिए निजी रखें. अगर आपने मेज़रमेंट प्रोटोकॉल को क्लाइंट-साइड पर डिप्लॉय किया जाता है, तो बहुत ज़्यादा स्पैम से बचने के लिए, नियमित तौर पर api_secret को घुमाएं.

measurement_id

 मेज़रमेंट आईडी. डेटा स्ट्रीम के लिए आइडेंटिफ़ायर. जानकारी Google पर मिली Analytics के यूज़र इंटरफ़ेस (यूआई) में:
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है एडमिन > डेटा स्ट्रीम > अपनी स्ट्रीम चुनें &gt; मेज़रमेंट आईडी

JSON फ़ाइल का मुख्य हिस्सा

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

client_id

 string

ज़रूरी है. अलग-अलग तरीके से, वेब क्लाइंट के उपयोगकर्ता के इंस्टेंस की पहचान करता है. इवेंट को यहां भेजें मेज़रमेंट प्रोटोकॉल.

user_id

 string

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

timestamp_micros

 number

ज़रूरी नहीं. असोसिएट किए जाने के समय के लिए यूनिक्स टाइमस्टैंप (माइक्रोसेकंड में) इवेंट में शामिल हो सकते हैं. इसे सिर्फ़ उन इवेंट को रिकॉर्ड करने के लिए सेट किया जाना चाहिए पिछली बार इस सूची में शामिल थे. इस मान को इससे बदला जा सकता है: user_property या इवेंट के टाइमस्टैंप. इवेंट के लिए तारीख पीछे की जा सकती है प्रॉपर्टी के टाइमज़ोन के हिसाब से ज़्यादा से ज़्यादा तीन कैलेंडर दिन.

user_properties

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

non_personalized_ads

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

events[]

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

events[].name

 string ज़रूरी है. इवेंट का नाम. इवेंट देखें देखें.

events[].params

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

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

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

ad_user_data

 string

ज़रूरी नहीं. अनुरोध की वैल्यू से उपयोगकर्ता का डेटा भेजने के लिए, सहमति सेट करता है इवेंट और उपयोगकर्ता प्रॉपर्टी को Google को ऐडवर्टाइज़ (विज्ञापन के मकसद से) करना चाहती हैं.

GRANTED या DENIED होना चाहिए.

ad_personalization

 string

ज़रूरी नहीं. उपयोगकर्ता के हिसाब से विज्ञापन दिखाने की सहमति सेट करता है.

GRANTED या DENIED होना चाहिए.

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

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

  • उपयोगकर्ता के स्कोप वाले कस्टम पैरामीटर, पेलोड के 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_