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

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

Протокол 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-адресе.

Все остальные поля запроса одинаковы.

Мы рекомендуем следующий подход к валидации:

• Используйте строгие проверки во время разработки, используя любой из следующих вариантов:
  • Проверьте запросы с помощью Event Builder .
  • Отправляйте запросы на сервер проверки, установив параметр validation_behavior на ENFORCE_RECOMMENDATIONS .
• В рабочей среде отправляйте запросы без установленного параметра validation_behavior , чтобы минимизировать количество данных, отклоненных протоколом измерений.

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

const firebaseAppId = "FIREBASE_APP_ID";
const apiSecret = "API_SECRET";

fetch(`https://www.google-analytics.com/debug/mp/collect?firebase_app_id=${firebaseAppId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    app_instance_id: "APP_INSTANCE_ID",
    validation_behavior: "ENFORCE_RECOMMENDATIONS",
    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": []
}

Ответ

ValidationMessage

Код проверки