Интеграция с 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.

Веб-событие (web event)

Действия пользователя в Web Shop. События при этих действиях отправляются с клиентской части Web Shop в Adjust и необходимы для интеграции через Web SDK.

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

Adjust и Xsolla поддерживают следующие сценарии интеграции:

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

Вы можете настроить интеграцию через Web SDK и получать расширенную аналитику событий, если вы:

используете Adjust;
создали сайт с помощью конструктора сайтов Xsolla.

С помощью интеграции через Web SDK вы можете получать информацию о следующих событиях:

Событие	Описание
`xsolla-web-event`	Посещение сайта. Содержит URL-адрес с информацией об источнике, откуда пришел пользователь, и ID устройства, который хранится в основных cookie сайта.
`xsolla-web-identify`	Авторизация на сайте. Содержит ID устройства и CUID.
`xsolla-web-purchase`	Покупка товара. Содержит события конструктора сайтов. Дополнительно может содержать детали транзакции.

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

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

какие пользователи, в каком количестве и с какого баннера перешли;
сколько они заплатили;
эффективна ли кампания по ретаргетингу.

  sequenceDiagram
    participant User
    participant Promo as Web Shop<br>promotional campaign<br>(ad banner)
    participant Shop as Web Shop
    participant Adjust as Adjust
    User->>Promo: 1. Clicks banner
    Promo->>Shop: 2. Redirect with URL parameters
    Shop->>Adjust: 3. xsolla-web-event event
    User->>Shop: 4. Logs in with CUID
    Shop->>Adjust: 5. xsolla-web-identify event
    User->>Shop: 6. Makes purchase
    Shop->>Adjust: 7. xsolla-web-purchase event

Cценарий пользователя:

Пользователь нажимает баннер рекламной кампании.
Пользователь перенаправляется в Web Shop, и URL-адрес этого перехода включает параметры, указывающие, с какого баннера и с какого сайта перешел пользователь.
С клиентской части Web Shop в Adjust отправляется событие о посещении.
Пользователь авторизуется в Web Shop, используя CUID.
Событие авторизации отправляется в Adjust.
Пользователь совершает покупку в Web Shop.
Событие покупки отправляется в Adjust.

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

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

Создать события, которые вы хотите включить в аналитический отчет в Adjust.
Активировать интеграцию с Xsolla.

Создание событий

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

администратор (admin);
редактор (editor);
роль с доступом на редактирование (custom editor).

Авторизуйтесь в вашем аккаунте Adjust.
Перейдите в раздел AppView > All apps.
Нажмите название необходимого приложения.

На вкладке Events нажмите Add event.

По очереди добавьте следующие события:
- Событие для получения общей информации о посещении сайта, например xsolla-web-event.
- Событие для получения информации об авторизации пользователя, например xsolla-web-identify.
- Событие для получения информации о покупке, например xsolla-web-purchase.

Вы можете назвать события и задать их правила так, как вам удобно. После создания события отображаются в списке на вкладке Events.

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

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

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

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

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

1. В блоке Map your events нажмите Map event.
2. Настройте маппинг согласно таблице:

Adjust event	Partner event
Событие, которое вы создали для получения общей информации о посещении сайта.	Xsolla Web Events
Событие, которое вы создали для получения информации об авторизации пользователя.	Xsolla Web Identify
Событие, которое вы создали для получения информации о покупке.	Xsolla Web Purchase

1. Нажмите Apply.

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

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

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

В панели Web SDK (Site Builder) нажмите Настроить. Вы будете перенаправлены на список ваших сайтов.

Вы также можете увидеть этот список, перейдя в раздел Каналы продаж > Веб-сайты.

В панели необходимого сайта нажмите Настроить.

На вкладке Настройки сайта перейдите в раздел Приложения.
В панели Adjust Web SDK нажмите Подключить.

В открывшемся модальном окне введите токен приложения.
Нажмите Подключить.

Чтобы найти информацию о событиях в вашем аккаунте Adjust, перейдите в раздел Datascape > Reports > All reports. Подробная информация о работе с отчетами приведена в [документации Adjust.

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

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

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

Событие	Описание
xsolla-billing-payment	Покупка товара. Параметры события содержат информацию о покупке.

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

В рамках интеграции реализован двусторонний обмен данными между 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

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

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

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

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

В панели S2S-интеграция для приложений нажмите Настроить.

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

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

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

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

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

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

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

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

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

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

Пример:

Copy

Full screen

Small screen

swift

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

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

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

Чтобы просматривать S2S-токены и управлять ими, вы должны обладать одной из следующих ролей в аккаунте Adjust:

администратор (admin);
редактор (editor);
роль с доступом на редактирование (custom editor).

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

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

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

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

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

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

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

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

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

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

Чтобы связать другое событие Adjust с Xsolla billing payment, сначала создайте его, следуя инструкции.

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

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

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

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

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

Параметр	Описание
content_id	Отдельный артикул товара или массив артикулов в покупке.
quantity	Количество товара соответствующего артикула (один или массив).
revenue	Сумма покупки с учетом скидок. До вычета комиссий и налогов.
currency	Валюта покупки.

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

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

Параметр	Описание
os_name	Операционная система устройства.
adid	ID устройства на стороне Adjust (все платформы).
idfa	ID рекламодателя в App Store.
idfv	ID вендора на стороне Apple.
gps_adid	ID рекламодателя в Google Play.
app_token	Токен приложения на стороне Adjust.
{partner_parameters}	Другие пользовательские параметры, информацию о которых вы хотите получать.

Спасибо за обратную связь!

Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.

Последнее обновление: 28 января 2026

Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

Содержание

Глоссарий
Сценарии интеграции
Как это работает
Как настроить в Adjust
Создание событий
Активация интеграции с Xsolla
Как настроить в Личном кабинете
Как это работает
Как настроить в Личном кабинете
Как настроить в Adjust
Передача CUID в качестве партнерского параметра
Получение S2S-токена безопасности
Активация интеграции с Xsolla
Структура значений событий
Покупка товара
Дополнительные данные

Your browser is not supported. Please try a different browser

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

Глоссарий

Adjust

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

Adjust ID

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

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

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

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

Customer user ID (CUID)

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

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

Ретаргетинг

Веб-событие (web event)

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

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

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

Создание событий

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

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

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

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

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

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

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

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

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

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

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