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

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

Firebase gtag.js

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

Внимание: сервер проверки не проверяет api_secret илиВнимательно проверьте эти значения, чтобы убедиться, что они верны.

Вы можете либо вызвать сервер проверки напрямую, либо использовать Google Analytics Event Builder . Google Analytics Event Builder позволяет вам интерактивно конструировать события и использует сервер проверки Measurement Protocol для их проверки.

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

Важно: события, отправленные на сервер проверки, не отображаются в отчетах.

Отправить события для проверки

Единственное различие в запросе событий, отправляемых в Measurement Protocol и на сервер проверки Measurement Protocol, заключается в URL-адресе.

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

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

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

Совет: если вы хотите, чтобы ваши данные обрабатывались в ЕС, измените URL-адрес, передаваемый методу fetch , чтобы он начинался с https://region1.google-analytics.com вместо https://www.google-analytics.com .

Ответ на проверку

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

{
  "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 >	Массив проверочных сообщений.

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

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

Код проверки

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