Выберите свою платформу:
Протокол Google Analytics Measurement Protocol не возвращает коды ошибок HTTP
, даже если событие имеет некорректный формат или не содержит обязательных параметров. Чтобы убедиться в корректности событий, перед их развертыванием в рабочей среде необходимо протестировать их на сервере валидации протокола Google Analytics Measurement Protocol. После проверки правильности структуры событий необходимо проверить реализацию , чтобы убедиться в использовании правильных ключей.
Вы можете вызвать сервер валидации напрямую или использовать конструктор событий Google Analytics . Конструктор событий Google Analytics позволяет интерактивно создавать события и использует сервер валидации Measurement Protocol для их проверки.
В этом руководстве описывается, как отправлять события на сервер проверки Measurement Protocol для Google Analytics 4 и интерпретировать ответ.
Отправлять события для проверки
Единственное различие между запросом событий, отправляемым на Measurement Protocol, и сервером проверки Measurement Protocol, заключается в 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": []
}
Ответ
Ключ | Тип | Описание |
---|---|---|
validationMessages | Массив< ValidationMessage > | Массив проверочных сообщений. |
ValidationMessage
Ключ | Тип | Описание |
---|---|---|
fieldPath | нить | Путь к полю, которое оказалось недействительным. |
description | нить | Описание ошибки. |
validationCode | Код проверки | Код проверки, соответствующий ошибке. |
Код проверки
Ценить | Описание |
---|---|
VALUE_INVALID | Указано недопустимое значение fieldPath . См. ограничения . |
VALUE_REQUIRED | Не указано требуемое значение для fieldPath . |
NAME_INVALID | Указанное имя недействительно. См. ограничения . |
NAME_RESERVED | Указанное имя является одним из зарезервированных. См. зарезервированные имена . |
VALUE_OUT_OF_BOUNDS | Указанное значение слишком велико. См. ограничения . |
EXCEEDED_MAX_ENTITIES | В запросе слишком много параметров. См. ограничения . |
NAME_DUPLICATED | Одно и то же имя было указано в запросе несколько раз. |