با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
پلتفرم خود را انتخاب کنید:
پروتکل اندازهگیری 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"}]}
در اینجا پاسخ سرور اعتبارسنجی به درخواستی بدون مشکل اعتبار سنجی آمده است:
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["The Measurement Protocol Validation Server helps ensure your Google Analytics 4 events are correctly formatted before deploying to production."],["The Validation Server uses a different URL endpoint (`/debug/mp/collect`) than the standard Measurement Protocol (`/mp/collect`)."],["Validation responses provide detailed error messages including the field path, description, and a validation code for easier debugging."],["Events sent to the Validation Server are not processed and will not appear in your Google Analytics reports."],["The Google Analytics Event Builder offers an interactive way to construct and validate events before sending them to the server."]]],["To ensure valid events, use the Measurement Protocol Validation Server by sending requests to `/debug/mp/collect` instead of `/mp/collect`. Validate events before deploying them. This server doesn't log events in reports. It returns a response with `validationMessages`, an array detailing any errors like `NAME_INVALID`, `VALUE_REQUIRED`, or `VALUE_OUT_OF_BOUNDS`, specifying the `fieldPath`, `description`, and `validationCode` of the issue. Use the Google Analytics Event Builder for interactive event construction.\n"]]