اعتبار سنجی رویدادها

پلتفرم خود را انتخاب کنید:

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

می‌توانید مستقیماً با سرور اعتبارسنجی تماس بگیرید یا از Google Analytics Event Builder استفاده کنید. Google Analytics Event Builder به شما امکان می دهد رویدادها را به صورت تعاملی بسازید و از سرور اعتبارسنجی پروتکل اندازه گیری برای تأیید اعتبار آنها استفاده کنید.

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

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

تنها تفاوت در درخواست رویدادهای ارسال شده به پروتکل اندازه گیری و سرور اعتبارسنجی پروتکل اندازه گیری، URL است.

سرور URL
پروتکل اندازه گیری /mp/collect
سرور اعتبارسنجی پروتکل اندازه گیری / debug /mp/collect

همه فیلدهای درخواست دیگر یکسان هستند.

ما روش زیر را برای اعتبار سنجی توصیه می کنیم:

  • در طول توسعه با استفاده از یکی از گزینه های زیر از بررسی های اعتبارسنجی دقیق استفاده کنید:
    • درخواست ها را با Event Builder تأیید کنید.
    • درخواست‌ها را به سرور اعتبارسنجی ارسال کنید که validation_behavior روی ENFORCE_RECOMMENDATIONS تنظیم شده است.
  • در تولید، درخواست‌هایی را بدون مجموعه‌ی validation_behavior ارسال کنید تا داده‌های رد شده توسط پروتکل اندازه‌گیری به حداقل برسد.

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

پاسخ اعتبارسنجی

در اینجا پاسخ سرور اعتبارسنجی به رویداد قبلی است:

{
  "validationMessages": [
    {
      "fieldPath": "events",
      "description": "Event at index: [0] has invalid name [_badEventName]. Names must start with an alphabetic character.",
      "validationCode": "NAME_INVALID"
    }
  ]
}

در اینجا پاسخ سرور اعتبارسنجی به درخواستی بدون مشکل اعتبار سنجی آمده است:

{
  "validationMessages": []
}

پاسخ

کلید تایپ کنید توضیحات
validationMessages آرایه< ValidationMessage > مجموعه ای از پیام های اعتبار سنجی

ValidationMessage

کلید تایپ کنید توضیحات
fieldPath رشته مسیر فیلدی که نامعتبر بود.
description رشته شرح خطا
validationCode ValidationCode یک کد اعتبارسنجی که با خطا مطابقت دارد.

ValidationCode

ارزش توضیحات
VALUE_INVALID مقدار ارائه شده برای یک fieldPath نامعتبر بود. محدودیت ها را ببینید.
VALUE_REQUIRED مقدار لازم برای یک fieldPath ارائه نشده است.
NAME_INVALID نام ارائه شده نامعتبر بود. محدودیت ها را ببینید.
NAME_RESERVED نام ارائه شده یکی از اسامی رزرو شده بود. اسامی رزرو شده را ببینید
VALUE_OUT_OF_BOUNDS مقدار ارائه شده خیلی زیاد بود. محدودیت ها را ببینید.
EXCEEDED_MAX_ENTITIES پارامترهای زیادی در درخواست وجود داشت. محدودیت ها را ببینید.
NAME_DUPLICATED همین نام بیش از یک بار در درخواست ارائه شده است.