Интеграция с Adjust

Глоссарий

Adjust

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

Подробная информация о платформе приведена в документации Adjust.

Токен приложения (App token)

ID мобильного приложения, уникальный для мобильной платформы (Android, iOS и т. д.). Генерируется автоматически при добавлении приложения в Adjust. Вы можете найти это значение в Adjust в разделе AppView > All apps рядом с названием необходимого приложения.

Adjust ID

ID пользователя, сгенерированный на стороне Adjust.

Пожизненная ценность (Lifetime Value или LTV)

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

Окупаемость затрат на рекламу (Return on advertising spend или ROAS)

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

Событие в приложении (in-app event)

Действие пользователя в приложении. Подробная информация о событиях в приложении приведена в документации Adjust. Действия пользователя в Web Shop также рассматриваются как события в приложении в случае S2S-интеграции и отправляются в Adjust с сервера Xsolla.

Привлечение трафика

Процесс привлечения новых пользователей на сайт, сервис, платформу или приложение с помощью маркетинговой активности.

Customer user ID (CUID)

ID пользователя, сгенерированный и установленный владельцем приложения в момент регистрации пользователя. CUID для Web Shop и Adjust должны совпадать. Этот параметр используется для атрибуции пользователей.

Внимание

Вам необходимо настроить передачу CUID в качестве партнерского параметра xsolla_cuid, следуя инструкции.

Если CUID в Web Shop и вашем мобильном приложении не совпадают, обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com, чтобы настроить обработку вебхука Проверка пользователя в Web Shop или аутентификации пользователя через диплинк.

Обратный вызов (callback)

Процесс получения в данных о событиях в приложении. Подробная информация приведена в документации Adjust.

S2S токен безопасности

Авторизационный токен server-to-server (S2S) запросов для отправки данных о событии в Adjust. Генерируется на стороне Adjust. Подробная информация о S2S-токене приведена в документации Adjust.

Сценарий интеграции

Adjust и Xsolla поддерживают S2S-интеграцию для мобильных приложений, которая позволяет измерять LTV и ROAS для покупок в приложении и в Web Shop. В этом случае Xsolla отправляет в Adjust информацию о покупках в Web Shop как событие в мобильном приложении. Adjust связывает эти события с количеством установок мобильного приложения, кампаниями по привлечению и повторному привлечению пользователей.

Вы можете настроить S2S-интеграцию для мобильных приложений и получать расширенную аналитику событий, если:

• у вас есть мобильное приложение на платформе Android/iOS;
• вы используете Adjust;
• вы используете решение Web Shop для продажи внутриигровых товаров.

С помощью S2S-интеграции Xsolla и Adjust вы можете получать информацию о следующем событии:

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

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

  sequenceDiagram
    participant User
    participant Mobile App
    participant Web Shop
    participant Xsolla Backend
    participant Adjust
    User->>Mobile App: 1. Logs in
    Mobile App->>Adjust: 2. Sends CUID
    Adjust-->>Xsolla Backend: 3. Sends callback
    User->>Web Shop: 4. Logs in using CUID
    User->>Web Shop: 5. Makes a purchase
    Web Shop->>Xsolla Backend: 6. Sends purchase event
    Xsolla Backend->>Adjust: 7. Sends xsolla-billing-payment event

1. Пользователь (игрок) регистрируется или авторизуется в мобильном приложении.
2. Ваше приложение отправляет в Adjust событие в приложении: login, signup или любое другое событие, которое содержит CUID.
3. Adjust выполняет обратный вызов к Xsolla, который содержит токен приложения, Adjust ID, CUID и другие параметры с данными.
4. Пользователь авторизуется в Web Shop, используя CUID.
5. Пользователь совершает покупку в Web Shop.
6. Событие покупки отправляется на сервер Xsolla и сопоставляется с информацией, полученной от Adjust.
7. Сервер Xsolla отправляет S2S-событие в приложении к Adjust, которое содержит Adjust ID, токен приложения и другие параметры, полученные от Adjust.

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

Как настроить в Личном кабинете

1. В проекте в Личном кабинете перейдите в раздел Интеграции.
2. Нажмите панель Adjust.

3. В панели S2S-интеграция для приложений нажмите Настроить.
4. В открывшемся окне проверьте, что флажок Включить эту интеграцию установлен.
5. Введите следующие данные:
   • S2S токен безопасности Adjust.
   • Токен приложения на платформах публикации (Android/iOS). Чтобы добавить платформу, нажмите Добавить токен приложения.
6. Нажмите Сохранить.
7. Настройте интеграцию на стороне Adjust.

После сохранения в панели S2S-интеграции будет отображаться зеленый индикатор.

Чтобы внести изменения:

1. Нажмите панель Adjust.
2. В открывшемся окне внесите необходимые изменения.
3. Нажмите Сохранить.

Как настроить в Adjust

В Adjust вам необходимо:

1. Настроить передачу CUID в качестве партнерского параметра.
2. Получить S2S-токен безопасности.
3. Активировать интеграцию с Xsolla.

Передача CUID в качестве партнерского параметра

Настройте передачу CUID самостоятельно, следуя инструкции. Для этого вызовите метод addGlobalPartnerParameter и передайте в нем следующие данные:

• ID пользователя на вашей стороне;
• forKey: “xsolla_cuid”.

Пример:

1Adjust.addGlobalPartnerParameter("abcd123", forKey: "xsolla_cuid")

1[Adjust addGlobalPartnerParameter:@"abcd123" forKey:@"xsolla_cuid"];

Получение S2S-токена безопасности

Чтобы получить S2S-токен безопасности:

1. Авторизуйтесь в вашем аккаунте Adjust.
2. Откройте раздел AppView > All apps и перейдите на страницу вашего приложения.
3. Перейдите на вкладку Protection.
4. В блоке S2S security нажмите Open S2S security.
5. В строке необходимого токена нажмите значок копирования.

Если у вас еще нет S2S-токена, создайте его, следуя инструкции.

Активация интеграции с Xsolla

1. Авторизуйтесь в вашем аккаунте Adjust.
2. Перейдите в раздел Campaign Lab > Partners.
3. Нажмите New partner.

4. В поисковой строке введите и выберите Xsolla.
5. Нажмите Next.

6. Выберите приложение, для которого вы настраиваете интеграцию.
7. Нажмите Next.
8. Разрешите передачу данных. Для этого в блоке Enable data sharing нажмите Edit, установите переключатель в активное положение и нажмите Enable.

9. Настройте маппинг событий:

1. 1. В блоке Map your events нажмите Map event.

1. 2. В разделе Adjust event выберите xsolla-billing-payment.
   3. В разделе Partner event выберите Xsolla billing payment.
   4. Нажмите Apply.

10. Нажмите Next.
11. Проверьте настройки и нажмите Enable partner. При необходимости вы можете вернуться на предыдущие шаги и изменить настройки.

Структура значений событий

Если вы хотите настроить определенное событие или если текущие возможности интеграции не соответствуют вашим потребностям, обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com.

Покупка товара

Когда пользователь совершает покупку в Web Shop, Xsolla отправляет событие xsolla-billing-payment в Adjust. В параметрах события передается следующая информация о покупке:

Дополнительные данные

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