हिट की पुष्टि करना - मेज़रमेंट प्रोटोकॉल

इस दस्तावेज़ में Google Analytics मेज़रमेंट प्रोटोकॉल हिट की पुष्टि करने का तरीका बताया गया है.

खास जानकारी

Google Analytics मेज़रमेंट प्रोटोकॉल, एचटीटीपी गड़बड़ी कोड नहीं दिखाता, भले ही मेज़रमेंट प्रोटोकॉल हिट गलत हो या ज़रूरी पैरामीटर मौजूद न हों. यह पक्का करने के लिए कि आपके हिट सही तरीके से फ़ॉर्मैट किए गए हैं और उनमें सभी ज़रूरी पैरामीटर शामिल हैं, प्रोडक्शन में भेजने से पहले पुष्टि करने वाले सर्वर पर उनकी जांच की जा सकती है.

इस गाइड में, मेज़रमेंट प्रोटोकॉल की पुष्टि करने वाले सर्वर पर हिट भेजने की प्रक्रिया के बारे में जानकारी दी गई है. साथ ही, रिस्पॉन्स को समझने का तरीका भी बताया गया है.

पुष्टि करने के लिए हिट भेजे जा रहे हैं

हिट, मेज़रमेंट प्रोटोकॉल की पुष्टि करने वाले सर्वर पर ऐसे किसी भी तरीके से भेजे जा सकते हैं जो मेज़रमेंट प्रोटोकॉल में काम करता है. फ़र्क़ सिर्फ़ यूआरएल का है. मेज़रमेंट प्रोटोकॉल की पुष्टि करने वाले सर्वर को हिट भेजने के लिए, /collect के बजाय, एंडपॉइंट /debug/collect का इस्तेमाल करें. यहां दिए गए उदाहरण में, मेज़रमेंट प्रोटोकॉल के पुष्टि सर्वर को भेजे गए अमान्य हिट को दिखाया गया है:

https://www.google-analytics.com/debug/collect?tid=fake&v=1

मेज़रमेंट प्रोटोकॉल हिट बनाने के तरीके के बारे में ज़्यादा जानने के लिए, प्रोटोकॉल का रेफ़रंस देखें.

जवाब की व्याख्या करना

मेज़रमेंट प्रोटोकॉल के पुष्टि करने वाले सर्वर से मिलने वाले जवाब, JSON फ़ॉर्मैट में होंगे. यहां दिए गए उदाहरण में, ऊपर दिखाए गए हिट के लिए रिस्पॉन्स दिखाया गया है:

{
  "hitParsingResult": [
    {
      "valid": false,
      "hit": "GET /debug/collect?tid=fake\u0026v=1 HTTP/1.1",
      "parserMessage": [
        {
          "messageType": "ERROR",
          "description": "The value provided for parameter 'tid' is invalid. Please see http://goo.gl/a8d4RP#tid for details.",
          "parameter": "tid"
        },
        {
          "messageType": "ERROR",
          "description": "Tracking Id is a required field for this hit. Please see http://goo.gl/a8d4RP#tid for details.",
          "parameter": "tid"
        }
      ]
    }
  ]
}

रिस्पॉन्स रूट, hitParsingResult एक कलेक्शन है. इसकी लंबाई, ओरिजनल अनुरोध में भेजे गए हिट की संख्या के हिसाब से होती है. कलेक्शन में मौजूद हर ऑब्जेक्ट में valid, hit, और parserMessage कुंजियां होंगी. अगर कोई हिट अमान्य है, तो parserMessage में ऐसे ऑब्जेक्ट होंगे जिनमें पुष्टि से जुड़ी समस्याओं के बारे में जानकारी दी गई होगी. अगर कोई हिट मान्य है, तो parserMessage एक खाली कलेक्शन होगा.

नीचे दी गई टेबल में hitParsingResult कलेक्शन में मौजूद हर आइटम की प्रॉपर्टी के बारे में बताया गया है:

सुरक्षा कुंजी	टाइप	ब्यौरा
`valid`	`Boolean`	मान्य हिट के लिए `true`, अमान्य हिट के लिए `false`.
`hit`	`string`	इस स्ट्रिंग में अनुरोध के पाथ के साथ-साथ उसका तरीका और प्रोटोकॉल शामिल होता है.
`parserMessage`	`Array`	पार्सर मैसेज की सूची. अगर हिट मान्य है, तो यह कलेक्शन खाली रहेगा.
`parserMessage.messageType`	`string`	संभावित वैल्यू "INFO", "WARN", और "ERROR" हैं.
`parserMessage.description`	`string`	पुष्टि करने से जुड़ी समस्या को ठीक करने के लिए ज़्यादा जानकारी या तरीका.
`parserMessage.parameter`	`string\|undefined`	वह पैरामीटर (अगर लागू हो) जिसकी वजह से पुष्टि में समस्या आई.