Мы постоянно публикуем обновления документации, которые могут быть недоступны на вашем языке. Наиболее актуальные сведения содержатся в версии на английском языке.

Настройка Google Analytics 4

Google Analytics 4 — партнёр по аналитике, интегрированный с Adjust. Наша интеграция позволяет Adjust отправлять данные о межсетевой атрибуции в Google Analytics. Вам следует включить эту интеграцию, если вы уже регистрируете конверсии с помощью Google Analytics для SDK Firebase. Adjust использует событие campaign_details в API протокола измерений для отправки конверсий вместе с данными об атрибуции.

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

Перед началом работы

Требования

iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona

Учетные данные

Firebase App ID, API Secret

Как найти учетные данные?

Чтобы получить идентификатор приложения Firebase App ID

  1. Откройте консоль Firebase.
  2. Найдите и выберите свой проект.
  3. Нажмите на Настройки (значок шестеренки), затем Настройки проекта на левой панели.
  4. В разделе Ваши приложения выберите свое приложение и перейдите к App ID.
  5. Найдите и скопируйте Firebase App ID.

Чтобы получить секрет API

  1. Откройте панель управления Google Analytics.
  2. Выберите Администратор > Сбор и модификация данных > Потоки данных.
  3. Выберите поток данных вашего приложения, перейдите к разделу Секреты API протокола измерений > Значение секрета.
  4. Найдите и скопируйте свой секрет API.
    1. Если у вас нет секрета API, в разделе Секреты API протокола измерений нажмите Создать.
    2. Введите имя и нажмите Создать.

Интеграция с Firebase SDK

Эта интеграция требует, чтобы SDK Firebase был интегрирован в ваше приложение, а параметры партнера для сессии были реализованы в SDK Adjust. Это необходимо, поскольку Google Analytics 4 создает app_instance_id для каждого экземпляра установки приложения, содержащего Firebase SDK. Если app_instance_id не записывается и не передается соответствующим образом, Adjust не будет отправлять колбэки в Google Analytics.

Для использования этой функции следуйте приведенным ниже инструкциям.

iOS | Android | Unity | Flutter | React Native

Параметры партнера для сессии позволяют SDK Adjust отслеживать app_instance_id для Google Analytics 4 и включать его при отправке данных в Google Analytics 4. Перед инициализацией Adjust SDK необходимо настроить app_instance_id.

Примечание:

Органический трафик не передается посредством этой интеграции. Из-за различий в методологии атрибуции Google Analytics не принимает конверсии старше 3 дней. В зависимости от окон атрибуции, настроенных для ваших ссылок, вы можете увидеть расхождения, поскольку некоторые конверсии могут не регистрироваться в Google Analytics 4.

Выберите Google Analytics 4 и свое приложение в Campaign Lab

  1. В разделе Campaign Lab выберите Партнеры.
  2. Выберите Новый партнер > Google Analytics 4 . Выберите Далее , чтобы перейти к следующему экрану.
  3. На экране Выбор приложения выберите приложение, для которого вы хотите создать ссылку и включите интеграцию, чтобы поделиться данными с Google Analytics 4.
  4. Нажмите Далее.

Включение обмена данными

Включите обмен данными, чтобы активировать интеграцию с Google Analytics 4. Чтобы включить обмен данными

  1. Введите Firebase App ID, API Secret.

После включения обмена данными с Google Analytics 4, Adjust автоматически отправляет Google Analytics 4 следующие данные (по умолчанию).

  • install
  • reattribution

Настройте параметры обмена данными

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

  1. разделить параметры обмена данными на уровне платформы, выбрав Использовать настройки для определенной платформы;
  2. установить одинаковые настройки обмена данными для нескольких платформ, выбрав Использовать глобальные настройки.

Сопоставление параметров

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

Параметры партнера (доступно в Adjust SDK версии 4.0+) позволяют Adjust собирать настраиваемые наборы данных в вашем приложении и перенаправлять их непосредственно Google Analytics 4. Таким образом Google Analytics 4 будет получать указанные сведения по каждому связанному событию.

Прежде чем добавлять новые параметры партнера в Adjust SDK, убедитесь, что ни один из ранее введенных параметров партнера не соответствует вашим требованиям.

Чтобы передавать Google Analytics 4 параметры партнера, выполните следующие действия.

  1. Настройте параметры партнера в Adjust SDK.

    • Проверьте раздел Начало работы для всех ссылок на платформу разработки SDK.
  2. В разделе Выберите параметры обмена данными нажмите Параметры .

  3. В разделе Сопоставить параметры можно указать способ отправки в сеть параметров партнера, заданных в SDK:

    1. Выберите Сопоставить параметр .
    2. В поле Параметр SDK укажите имя параметра SDK, который следует отправить в сеть.
    3. В поле Параметр партнера укажите параметр сети, соответствующий параметру SDK.
Примечание:

Примечание. Если параметры партнера настроены в Adjust SDK без настройки передачи параметров на панели управления, Adjust будет передавать эти параметры с тем же названием, что и в Adjust SDK.

Включите Google Analytics 4 для своего приложения

На экране Проверка настройки вы можете просмотреть выбранные варианты. Вы можете вернуться и внести изменения в следующие настройки:

  • выбранное приложение,
  • параметры обмена данными.

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

Список всех параметров, передаваемых Google Analytics 4

Google Analytics 4 требует от Adjust отправлять следующие параметры (точки данных) вместе с колбэками:

ПлейсхолдерИнформация
{adgroup_name}Название группы объявлений (как прописано в трекере)
{campaign_name}Название кампании (как прописано в трекере)
{creative_name}Название креатива, как прописано в трекере
{engagement_time}Временная отметка вовлечения
{network_name}Название сети (как прописано в трекере)