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

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

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

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

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

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

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

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

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

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

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

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

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

واکنش

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

ValidationMessage

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

ValidationCode

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