Устранение неполадок

В этом руководстве описаны основные шаги по устранению распространенных ошибок внедрения.

Нет событий

Если ваши события не отображаются в Google Analytics, следует обратить внимание на несколько распространенных проблем.

Сначала выберите своего клиента:

  • Вы используете правильный параметр api_secret ?

    Убедитесь, что вы используете api_secret для правильного потока. Если вы настроите протокол измерения для нескольких потоков, каждый поток будет иметь свой собственный секретный ключ.

  • Ваш параметр api_secret по-прежнему действителен?

    Для борьбы со спамом вы можете отозвать api_secret . Убедитесь, что используемый вами api_secret всё ещё действителен. Возможно, другой пользователь, имеющий доступ к вашему потоку, по ошибке отозвал к нему доступ.

  • Правильно ли скопирован ваш api_secret ?

    Параметр api_secret чувствителен к регистру. Убедитесь, что значение api_secret в пользовательском интерфейсе Google Analytics точно совпадает с тем, которое вы используете в своем коде.

  • Не используйте advertising_id .

    advertising_id не поддерживается в качестве допустимого идентификатора устройства. Используйте app_instance_id , если вы используете Firebase, и client_id если вы используете gtag.js.

  • Вы используете правильный firebase_app_id ?

    Убедитесь, что вы используете идентификатор приложения Firebase. Это значение можно найти в консоли Firebase по пути: Настройки проекта > Общие > Ваши приложения > Идентификатор приложения .

    firebase_app_id отличается от app_instance_id .

  • Вы используете правильный app_instance_id ?

    Убедитесь, что вы используете идентификатор, специфичный для конкретной установки приложения Firebase. Это значение необходимо получить через SDK Google Analytics для Firebase.

    app_instance_id отличается от firebase_app_id .

Неверные идентификаторы

Поскольку протокол измерения поддерживает идентификаторы из SDK Google Analytics for Firebase и gtag.js, убедитесь, что вы используете правильный идентификатор. Идентификаторы, которые следует использовать, различаются в зависимости от того, используете ли вы SDK Google Analytics for Firebase или gtag.js. Ниже приведен список идентификаторов, которые следует использовать:

Google Analytics для Firebase SDK

Если вы используете SDK Google Analytics для Firebase, вам следует использовать следующие идентификаторы:

  • firebase_app_id — укажите этот идентификатор в параметрах запроса. Этот идентификатор однозначно идентифицирует ваше приложение Firebase. Все пользователи вашего приложения будут иметь одинаковый firebase_app_id . Найти его можно в консоли Firebase по адресу:
    Настройки проекта > Общие > Ваши приложения > Идентификатор приложения

  • app_instance_id — укажите этот идентификатор в теле POST-запроса. Этот идентификатор однозначно идентифицирует конкретную установку приложения Firebase. Это значение будет разным для каждой установки вашего приложения. Способы запроса этого значения для каждой платформы Firebase следующие:

Следующее использовать не следует:

  • firebase_instance_id — Этот идентификатор не следует включать в ваш запрос. Он используется для идентификации конкретного экземпляра приложения, но является специфичным для Firebase. Он используется для таких задач, как отправка сообщений FCM.

gtag.js

Если вы используете gtag.js, вам следует использовать следующие идентификаторы:

  • measurement_id — укажите этот идентификатор в параметрах запроса. Этот идентификатор однозначно идентифицирует поток данных. Все пользователи вашего сайта будут иметь одинаковый measurement_id . Найти его можно в пользовательском интерфейсе Google Analytics в разделе:
    Администрирование > Потоки данных > выберите поток > Идентификатор измерения
  • client_id — укажите этот идентификатор в теле POST-запроса. Этот идентификатор однозначно идентифицирует конкретный экземпляр веб-клиента. Это значение будет разным для каждого пользователя вашего приложения. См. примеры получения этого значения.

Отсутствуют события тегирования на стороне сервера.

Установка Server-side Tag Manager с клиентом Measurement Protocol позволяет отправлять события в формате Measurement Protocol в контейнер. Затем контейнер отправляет эти события в Google Analytics, используя тот же механизм, что и для всех других событий SGTM.

Если вам нужны все возможности протокола Measurement Protocol, отправляйте события непосредственно в Measurement Protocol, а не в ваш контейнер.