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

Настройка независимой интеграции Segment

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

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

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

  1. Приложение напрямую инициирует Adjust SDK.
  2. Adjust SDK автоматически регистрирует установки, сессии и реатрибуции.
  3. Segment SDK регистрирует события, а сервер Segment отправляет их на сервер Adjust в виде S2S-событий в режиме облака.
  4. Сервер Adjust отправляет колбэк установки на сервер Segment. Сервер Segment регистрирует колбэк установки как событие track с именем Install Attributed.

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

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

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

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

📖 iOS / Android

2. Включите Segment в Adjust

Чтобы настроить Segment в Adjust, выполните эти действия.

См. документацию по Segment, чтобы найти WRITE KEY.

Segment будет получать колбэки для действий по установке.

3. Создайте пункты назначения 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. Настройте каждый пункт назначения с соответствующим токеном приложения.

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

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

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

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

Это решение не поддерживает параметры партнера. Однако параметры партнера по сессии необходимы для передачи определенных значений в Adjust SDK. См. документацию разработчика для вашей платформы:


📖 iOS / Android

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

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

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

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

  1. На панели управления Segment выберите Пункты назначения и выберите пункт назначения Adjust.

  2. Найдите параметр Отслеживать данные атрибуции и включите его.

  3. Найдите параметр Отправить время создания события и выберите соответствующий вариант.

    • ВКЛ. — Segment передает время created_at_unix для S2S-событий. Однако Segment не гарантирует отправку событий в хронологическом порядке в соответствии с временем created_at_unix, поэтому сервер Adjust может отклонять некоторые события.
    • ВЫКЛ. — Segment не передает параметр created_at для S2S-событий. Сервер Adjust не отклоняет события для сохранения хронологии. Вместо этого он внутренним образом устанавливает временную отметку created_at равной временной отметке received_at. Это означает, что временная отметка created_at может не отражать время, когда устройство фактически инициировало событие в Segment SDK.

  4. В верхней части экрана находится «Настройка параметров». Поверните переключатель в положение «ВКЛ.» , чтобы включить пункт назначения.

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

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

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

См. список параметров, передаваемых в колбэках Adjust в Segment.

Подстановочное полеИнформация
[anonymous_id]Анонимный идентификатор Segment
{adgroup_name}Имя рекламной группы, как указано в ссылке
{campaign_name}Имя кампании, как указано в ссылке
{creative_name}Имя креатива, как указано в ссылке
{network_name}Имя сети, как указано в ссылке
{tracker_name}Текущее имя ссылки