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

Настройка интеграции Segment SDK-SDK

Segment является партнером Adjust по аналитике. При интеграции SDK-SDK Segment SDK выступает оболочкой для SDK Adjust, соединяя оба SDK в приложении с минимальными усилиями. Таким образом можно управлять развертыванием Adjust SDK через Segment SDK, а Adjust и Segment могут регистрировать события в соответствующих системах.

Как это работает?

Далее показывается, как регистрируется активность пользователей в варианте оболочки для Adjust SDK.

  1. Segment SDK инициализирует Adjust SDK.
  2. Adjust SDK автоматически регистрирует установки, сессии и реатрибуции.
  3. В Segment SDK вы выполняете вызовы track. Каждый вызов регистрирует событие пользователя.
  4. Segment SDK выполняет соответствующие вызовы регистрации событий в Adjust SDK в режиме устройства.
  5. Adjust SDK получает информацию об атрибуции от бэкенда Adjust и отправляет приложению обратный колбэк, который принимает Segment SDK.
  6. Segment регистрирует колбэк атрибуции как событие track с именем Install Attributed. Колбэк атрибуции отправляется в следующих случаях.
    • Пользователь устанавливает приложение в первый раз.
    • Пользователь удаляет и переустанавливает приложение.
    • Сервер Adjust регистрирует реатрибуцию.
    • Сервер Adjust регистрирует обновление атрибуции.
Совет:

Так как колбэк атрибуции Adjust SDK может отправлять несколько колбэков атрибуции для одного и того же устройства, рекомендуется использовать только первый колбэк атрибуции для каждого anonymous_id в наборе данных Segment. Этот первый колбэк атрибуции является атрибуцией установки Adjust для устройства.

Настройка интеграции

Для настройки решения с оболочкой SDK с помощью Segment выполните следующие действия.

Важно:

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

1. Настройте SDK Adjust и Segment

Инструкции по настройке Adjust SDK и Segment SDK см. в наших руководствах для разработчиков интеграции с Segment для вашей платформы:

📖 iOS / Android

2. Создайте пункты назначения Adjust и добавьте токены приложений Adjust в Segment

Чтобы добавить Adjust в качестве пункта назначения на панели управления Segment, выполните следующие действия.

  1. Выберите «Пункты назначения»> «Добавить пункт назначения» .
  2. Найдите Adjust.
  3. Добавьте Adjust в качестве пункта назначения к вашему источнику.

Чтобы добавить токены приложения Adjust в пункт назначения Adjust, выполните следующие действия.

  1. Выберите «Пункты назначения» и выберите пункт назначения Adjust.
  2. Нажмите Токен приложения и введите токен приложения из AppView.
  3. Нажмите СОХРАНИТЬ .

См. приведенную ниже таблицу, где показано, как связаны пункты назначения Adjust с вашими источниками на основе настройки приложения в Adjust.

Используемый SDK SegmentНастройка приложения AdjustНастройка пункта назначения на панели управления Segment
Segment SDK для Android и Segment SDK для iOSМежплатформенное приложение (один и тот же токен приложения для приложений iOS и Android) 
  1. Добавьте пункт назначения Adjust к источнику iOS и пункт назначения Adjust к источнику Android. 
  2. Настройте оба пункта назначения с одним и тем же токеном Adjust.
Segment SDK для Android и/или Segment SDK для iOSПриложения для iOS и/или Android с разными токенами приложений
  1. Добавьте пункт назначения Adjust к каждому источнику, если нужно.
  2. Настройте каждый пункт назначения с соответствующим токеном Adjust.
React Native Segment SDKМежплатформенное приложение (один и тот же токен приложения для приложений iOS и Android)
  1. Добавьте пункт назначения Adjust к источнику React Native.
  2. Настройте пункт назначения с помощью токена приложения.
React Native Segment SDKПриложения для iOS и Android с разными токенами приложений 
  1. Добавьте пункт назначения Adjust для iOS и пункт назначения Adjust для Android в источник React Native.
  2. Настройте каждый пункт назначения с соответствующим токеном приложения.

3. Создайте токены событий в Adjust

Теперь просмотрите свои события на панели управления Segment и определите, какие события необходимо связать с Adjust.

Для каждого вызова track Segment, который необходимо связать с Adjust, создайте соответствующий токен события Adjust и скопируйте этот токен события.

Предупреждение:

Это решение не поддерживает параметры партнера. Однако поддерживаются параметры партнера по сессии (iOS | Android).

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

4. Добавьте токены событий Adjust в Segment

  1. На панели управления Segment выберите Пункты назначения и выберите пункт назначения Adjust.
  2. Нажмите Сопоставить события с пользовательскими токенами событий Adjust и введите токены событий, скопированные из панели управления Adjust.
    Каждое имя события track Segment должно иметь отношение 1:1 с токеном события Adjust. Не связывайте вызовы track Segment с разными именами с одним и тем же токеном события Adjust.
  3. Нажмите СОХРАНИТЬ .

5. Настройте дополнительные параметры в Segment

  1. На панели управления Segment выберите Пункты назначения и выберите пункт назначения Adjust.
  2. Найдите параметр Отслеживать данные атрибуции и включите его.
  3. В верхней части экрана находится «Настройка параметров». Поверните переключатель в положение «ВКЛ» , чтобы включить пункт назначения.

По мере готовности к запуску интеграции в эксплуатационной среде найдите параметр «Отправлять в эксплуатационную среду на Adjust» и включите его.

A screenshot from the Segment dashboard of how to configure your Adjust settings.

Параметры, передаваемые в Segment

Список параметров, отправляемых в колбэке атрибуции SDK Adjust, представлен в документации для разработчиков (iOS | Android).