Google Analytics को मेज़रमेंट प्रोटोकॉल इवेंट भेजें

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

वह प्लैटफ़ॉर्म चुनें जिसे आपको इस गाइड में देखना है:

अनुरोध को फ़ॉर्मैट करना

Google Analytics मेज़रमेंट प्रोटोकॉल सिर्फ़ एचटीटीपी POST अनुरोधों के साथ काम करता है.

इवेंट भेजने के लिए, इस फ़ॉर्मैट का इस्तेमाल करें:

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

आपको अनुरोध के यूआरएल में यह जानकारी देनी होगी:

  • api_secret: Google Analytics के यूज़र इंटरफ़ेस (यूआई) में जनरेट किया गया एपीआई सीक्रेट.

    नया सीक्रेट बनाने के लिए, एडमिन पर जाएं > डेटा स्ट्रीम > चुनें स्ट्रीम > मेज़रमेंट प्रोटोकॉल > बनाएं.

  • measurement_id: किसी स्ट्रीम से जुड़ा मेज़रमेंट आईडी, जो एडमिन सेक्शन में Google Analytics का यूज़र इंटरफ़ेस (यूआई) > डेटा स्ट्रीम > अपना स्ट्रीम > मेज़रमेंट आईडी.

    measurement_id, आपका स्ट्रीम आईडी नहीं है.

पूरी जानकारी के लिए, क्वेरी पैरामीटर देखें.

आपको अनुरोध के मुख्य हिस्से में यह जानकारी देनी होगी:

  • client_id: यह क्लाइंट के लिए एक यूनीक आइडेंटिफ़ायर होता है. यह Firebase app_instance_id. gtag.js('get') का इस्तेमाल करें.

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

  • consent: ज़रूरी नहीं. सहमति सेट करने का तरीका जानें सेटिंग पर टैप करें.

  • timestamp_micros: ज़रूरी नहीं. Unix epoch टाइम, माइक्रोसेकंड में, इवेंट और उपयोगकर्ता प्रॉपर्टी मौजूद होती हैं. अगर यह तय नहीं किया गया है, तो डिफ़ॉल्ट रूप से अनुरोध का समय.

  • events: इवेंट आइटम का कलेक्शन. एक इवेंट में, एक से ज़्यादा इवेंट शामिल किए जा सकते हैं अनुरोध.

    उपयोगकर्ता गतिविधि को रिपोर्ट में दिखाने के लिए, जैसे कि रीयलटाइम, engagement_time_msec और session_id, event के लिए params चुकाएं. engagement_time_msec पैरामीटर से यह पता चलना चाहिए कि इवेंट के दर्शकों के जुड़ाव का समय मिलीसेकंड में.

    यहां एक उदाहरण दिया गया है:

  {
   "client_id": "123456.7654321",
   "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 को tutorial_begin इवेंट भेजने के लिए, इस उदाहरण का इस्तेमाल किया जा सकता है ऐनलिटिक्स सर्वर:

const measurement_id = `G-XXXXXXXXXX`;
const api_secret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurement_id}&api_secret=${api_secret}`, {
  method: "POST",
  body: JSON.stringify({
    client_id: 'XXXXXXXXXX.YYYYYYYYYY',
    events: [{
      name: 'tutorial_begin',
      params: {},
    }]
  })
});

टाइमस्टैंप बदलें

मेज़रमेंट प्रोटोकॉल, नीचे दी गई सूची में मिलने वाले पहले टाइमस्टैंप का इस्तेमाल करता है अनुरोध में हर इवेंट के लिए:

  1. इवेंट का timestamp_micros.
  2. अनुरोध का timestamp_micros.
  3. मेज़रमेंट प्रोटोकॉल को अनुरोध मिलने का समय.

नीचे दिए गए उदाहरण में अनुरोध के लेवल पर एक टाइमस्टैंप भेजा गया है, जो इवेंट शामिल हैं. इस वजह से, मेज़रमेंट प्रोटोकॉल में tutorial_begin और join_group इवेंट का टाइमस्टैंप requestUnixEpochTimeInMicros.

{
  "timestamp_micros": requestUnixEpochTimeInMicros,
  "events": [
    {
      "name": "tutorial_begin"
    },
    {
      "name": "join_group",
      "params": {
        "group_id": "G_12345",
      }
    }
  ]
}

नीचे दिए गए उदाहरण में, अनुरोध के लेवल वाले टाइमस्टैंप और इवेंट लेवल, दोनों का टाइमस्टैंप भेजा गया है टाइमस्टैंप. इस वजह से, मेज़रमेंट प्रोटोकॉल, tutorial_begin को असाइन करता है इवेंट का टाइमस्टैंप tutorialBeginUnixEpochTimeInMicros और join_group इवेंट का टाइमस्टैंप requestUnixEpochTimeInMicros है.

{
  "timestamp_micros": requestUnixEpochTimeInMicros,
  "events": [
    {
      "name": "tutorial_begin",
      "timestamp_micros": tutorialBeginUnixEpochTimeInMicros
    },
    {
      "name": "join_group",
      "params": {
        "group_id": "G_12345",
      }
    }
  ]
}

सीमाएं

Google को मेज़रमेंट प्रोटोकॉल इवेंट भेजने पर, ये सीमाएं लागू होती हैं आंकड़े:

  • अनुरोधों में ज़्यादा से ज़्यादा 25 इवेंट हो सकते हैं.
  • इवेंट में ज़्यादा से ज़्यादा 25 पैरामीटर हो सकते हैं.
  • इवेंट में ज़्यादा से ज़्यादा 25 उपयोगकर्ता प्रॉपर्टी हो सकती हैं.
  • उपयोगकर्ता प्रॉपर्टी के नामों में 24 या इससे कम वर्ण होने चाहिए.
  • उपयोगकर्ता प्रॉपर्टी की वैल्यू में 36 या इससे कम वर्ण होने चाहिए.
  • इवेंट के नामों में 40 या इससे कम वर्ण होने चाहिए. इनमें सिर्फ़ ऐल्फ़ा-न्यूमेरिक (अक्षर और अंक) हो सकते हैं वर्ण और अंडरस्कोर शामिल किए जा सकते हैं. साथ ही, यह अक्षर से शुरू होना चाहिए.
  • पैरामीटर के नामों में 40 या इससे कम वर्ण होने चाहिए. इनमें आइटम पैरामीटर भी शामिल हैं, इसमें केवल अल्फ़ा-न्यूमेरिक वर्ण और अंडरस्कोर हो सकते हैं, और ये शुरू होने चाहिए वर्ण इस्तेमाल किया जा सकता है.
  • पैरामीटर वैल्यू के साथ-साथ आइटम की पैरामीटर वैल्यू, 100 वर्ण की होनी चाहिए या स्टैंडर्ड Google Analytics प्रॉपर्टी के लिए कम और 500 या उससे कम वर्ण Google Analytics 360 प्रॉपर्टी के लिए.
  • आइटम पैरामीटर में ज़्यादा से ज़्यादा 10 कस्टम पैरामीटर हो सकते हैं.
  • पोस्ट का मुख्य भाग 130kB से कम होना चाहिए.
  • Google Analytics को भेजे गए ऐप्लिकेशन मेज़रमेंट प्रोटोकॉल इवेंट, Search में अपने-आप जानकारी नहीं भरते के लिए Google Ads में ऑडियंस.

इस्तेमाल के हर उदाहरण की ज़रूरी शर्तों के बारे में जानने के लिए, इस्तेमाल के सामान्य उदाहरण देखें.