Выберите свою платформу:
Протокол измерения Google Analytics не возвращает коды ошибок HTTP
, даже если событие имеет неправильный формат или отсутствуют обязательные параметры. Чтобы убедиться, что ваши события действительны, вам следует протестировать их на сервере проверки протокола измерений, прежде чем развертывать их в рабочей среде. После того, как вы убедились, что ваши события структурированы правильно, вам следует проверить свою реализацию , чтобы убедиться, что вы используете правильные ключи.
Вы можете либо напрямую вызвать сервер проверки, либо использовать построитель событий Google Analytics . Построитель событий Google Analytics позволяет интерактивно создавать события и использует сервер проверки протокола измерений для их проверки.
В этом руководстве описывается, как отправлять события на сервер проверки 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 | Одно и то же имя было указано в запросе несколько раз. |