پلتفرم خود را انتخاب کنید:
پروتکل اندازهگیری Google Analytics کدهای خطای HTTP
را باز نمیگرداند، حتی اگر رویدادی بدشکل باشد یا پارامترهای لازم را نداشته باشد. برای اطمینان از معتبر بودن رویدادها، باید آنها را در برابر سرور اعتبارسنجی پروتکل اندازه گیری قبل از استقرار در تولید آزمایش کنید. بعد از اینکه تأیید کردید که رویدادهای شما به درستی ساختار یافته اند، باید اجرای خود را تأیید کنید تا مطمئن شوید که از کلیدهای صحیح استفاده می کنید.
میتوانید مستقیماً با سرور اعتبارسنجی تماس بگیرید یا از Google Analytics Event Builder استفاده کنید. Google Analytics 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 | همین نام بیش از یک بار در درخواست ارائه شده است. |