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

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

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

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

В этом руководстве описывается, как отправлять события на сервер проверки Google Analytics 4 и интерпретировать ответ.

Отправка событий на проверку

Единственная разница в запросе событий, отправляемых на протокол измерений и сервер проверки протокола измерений, — это URL-адрес.

Сервер URL-адрес
Протокол измерений /mp/collect
Сервер проверки протокола измерений / debug /mp/collect

Все остальные поля запроса такие же. Подробную информацию о создании допустимого запроса см. в справочнике по протоколу .

Следующий код показывает, что на сервер проверки протокола измерения отправляется недопустимое событие:

const firebase_app_id = `X:XX:XX:XX`;
const api_secret = `<secret_value>`;

fetch(`https://www.google-analytics.com/debug/mp/collect?firebase_app_id=${firebase_app_id}&api_secret=${api_secret}`, {
  method: "POST",
  body: JSON.stringify({
    app_instance_id: 'app_instance_id',
    events: [{
      // Event names must start with an alphabetic character.
      name: '_badEventName',
      params: {},
    }]
  })
});

Ответ проверки

Вот ответ сервера проверки на предыдущее событие:

{
  "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 Одно и то же имя было указано в запросе несколько раз.