Как проверить события

Выберите свою платформу:

Протокол измерения Google Analytics для Google Analytics 4 не возвращает коды ошибок HTTP , даже если событие имеет неправильный формат или отсутствуют обязательные параметры. Чтобы убедиться, что ваши события действительны, вам следует протестировать их на сервере проверки протокола измерений, прежде чем развертывать их в рабочей среде. После того, как вы убедились, что ваши события структурированы правильно, вам следует проверить свою реализацию , чтобы убедиться, что вы используете правильные ключи.

Вы можете либо напрямую вызвать сервер проверки, либо использовать построитель событий GA4 . Построитель событий GA4 позволяет интерактивно создавать события и использует сервер проверки протокола измерений для их проверки.

В этом руководстве описывается, как отправлять события на сервер проверки 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 Массив< Сообщение Валидации > Массив сообщений проверки.

Сообщение проверки

Ключ Тип Описание
fieldPath нить Путь к недействительному полю.
description нить Описание ошибки.
validationCode Код проверки ValidationCode, соответствующий ошибке.

Код проверки

Ценить Описание
VALUE_INVALID Значение, указанное для fieldPath , недопустимо. См. ограничения .
VALUE_REQUIRED Не было предоставлено обязательное значение для fieldPath .
NAME_INVALID Указанное имя неверно. См. ограничения .
NAME_RESERVED Указанное имя было одним из зарезервированных имен. См. зарезервированные имена .
VALUE_OUT_OF_BOUNDS Указанное значение было слишком большим. См. ограничения .
EXCEEDED_MAX_ENTITIES В запросе было слишком много параметров. См. ограничения .
NAME_DUPLICATED Одно и то же имя было указано в запросе несколько раз.