اعتبارسنجی بازدیدها - پروتکل اندازه گیری

این سند نحوه اعتبارسنجی بازدیدهای پروتکل اندازه‌گیری Google Analytics را شرح می‌دهد.

بررسی اجمالی

پروتکل اندازه‌گیری Google Analytics کدهای خطای HTTP را باز نمی‌گرداند، حتی اگر ضربه پروتکل اندازه‌گیری نادرست باشد یا پارامترهای لازم را نداشته باشد. برای اطمینان از اینکه بازدیدهای شما به درستی قالب بندی شده اند و تمام پارامترهای مورد نیاز را شامل می شوند، می توانید قبل از استقرار آنها در تولید، آنها را در برابر سرور اعتبارسنجی آزمایش کنید.

این راهنما فرآیند ارسال بازدیدها به سرور اعتبارسنجی پروتکل اندازه گیری را شرح می دهد و نحوه تفسیر پاسخ را توضیح می دهد.

ارسال بازدیدها برای اعتبارسنجی

بازدیدها را می توان از طریق هر روشی که در حال حاضر توسط پروتکل اندازه گیری پشتیبانی می شود به سرور اعتبارسنجی پروتکل اندازه گیری ارسال کرد. تنها تفاوت در URL است. برای ارسال بازدیدها به سرور اعتبارسنجی پروتکل اندازه گیری از نقطه پایانی /debug/collect به جای /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`	پارامتر (در صورت وجود) که باعث مشکل اعتبار سنجی می شود.