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

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

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

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

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

  sequenceDiagram
    participant U as Пользователь
    participant WSP as Рекламная кампания Web Shop (рекламный баннер)
    participant WS as Web Shop
    participant AF as AppsFlyer
    U->>WSP: Нажимает на баннер
    WSP->>WS: Перенаправляет с параметрами URL-адреса
    WS->>AF: Отправляет событие load
    U->>WS: Авторизуется с помощью CUID
    WS->>AF: Отправляет событие identify
    U->>WS: Совершает покупку
    WS->>AF: Отправляет событие purchase

1. Пользователь нажимает на баннер рекламной кампании.
2. Пользователь перенаправляется в Web Shop и в URL этого перехода включены параметры из группы параметров AppsFlyer, показывающие с какого баннера и с какого сайта перешел пользователь.
3. С клиентской части Web Shop в AppsFlyer отправляется событие о посещении.
4. Пользователь авторизуется в Web Shop, используя CUID.
5. Событие авторизации отправляется в AppsFlyer.
6. Пользователь совершает покупку в Web Shop.
7. Событие покупки отправляется в AppsFlyer.

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

Предварительные настройки в сервисе AppsFlyer:

1. Добавьте приложение:
   1. Нажмите Add app.
   2. Выберите в списке платформу Web (PBA).
   3. В качестве URL-адреса приложения укажите домен вашего Web Shop. Например, https://www.webshop.example.com/.
   4. Укажите название приложения, например, Xsolla.
   5. Нажмите Add my app.

2. Добавьте пакет бренда:
   1. Нажмите Add bundle.
   2. В качестве названия укажите Xsolla-bundle.
   3. Выберите в списке веб-приложение Xsolla, которое вы добавили ранее.
   4. Нажмите Create bundle.

1. Откройте проект в Личном кабинете.
2. Перейдите в конструктор сайтов одним из следующих способов:
   • В боковом меню нажмите Каналы продаж > Веб-сайты.
   • В боковом меню нажмите Интеграции. В открывшемся разделе:
     1. Нажмите панель AppsFlyer.
     2. В панели Web SDK (Site Builder) нажмите Настроить.

3. В панели вашего сайта нажмите Настроить.
4. На вкладке Настройки сайта перейдите в раздел Приложения.
5. В панели AppsFlyer нажмите Подключить.

1. Откройте проект в вашем аккаунте.
2. Перейдите в конструктор сайтов одним из следующих способов:
   • В боковом меню нажмите Каналы продаж > Веб-сайты.
   • В боковом меню нажмите Другие инструменты > Интеграции. В открывшемся разделе:
     1. Нажмите панель AppsFlyer.
     2. В панели Web SDK (Site Builder) нажмите Настроить.

3. В панели вашего сайта нажмите Настроить.
4. На вкладке Настройки сайта перейдите в раздел Приложения.
5. В панели AppsFlyer нажмите Подключить.

1. Откройте проект в вашем аккаунте.
2. Перейдите в конструктор сайтов одним из следующих способов:
   • В боковом меню нажмите Каналы продаж > Веб-сайты.
   • В боковом меню нажмите Другие инструменты > Интеграции. В открывшемся разделе:
     1. Нажмите панель AppsFlyer.
     2. В панели Web SDK (Site Builder) нажмите Настроить.

3. В панели вашего сайта нажмите Настроить.
4. На вкладке Настройки сайта перейдите в раздел Приложения.
5. В панели AppsFlyer нажмите Подключить.

1. Откройте проект в вашем аккаунте.
2. Перейдите в конструктор сайтов одним из следующих способов:
   • В боковом меню нажмите Каналы продаж > Веб-сайты.
   • В боковом меню нажмите Другие инструменты > Интеграции. В открывшемся разделе:
     1. Нажмите панель AppsFlyer.
     2. В панели Web SDK (Site Builder) нажмите Настроить.

3. В панели вашего сайта нажмите Настроить.
4. На вкладке Настройки сайта перейдите в раздел Приложения.
5. В панели AppsFlyer нажмите Подключить.

1. Откройте ваш проект в аккаунте для мобильных игр.
2. Перейдите в конструктор сайтов одним из следующих способов:
   • В боковом меню нажмите Web Shop.
   • В боковом меню нажмите Управление > MMP. В открывшемся разделе:
     1. Нажмите панель AppsFlyer.
     2. В панели Web SDK (Site Builder) нажмите Настроить.

3. В панели вашего сайта нажмите значок ⋮ и выберите Настроить.
4. На вкладке Настройки сайта перейдите в раздел Приложения.
5. В панели AppsFlyer нажмите Подключить.

6. В поле Ключ разработчика AppsFlyer укажите ключ разработчика. Вы можете найти эти данные в вашем аккаунте в AppsFlyer:
   1. Перейдите в раздел My Apps.
   2. Нажмите View brand bundles.
   3. В строке с пакетом бренда Xsolla-bundle нажмите значок копирования в столбце Web dev key.
7. Нажмите Подключить.

Чтобы найти информацию о событиях в вашем аккаунте в AppsFlyer:

1. Перейдите в раздел My Apps.
2. В разделе Available Apps выберите приложение Xsolla и нажмите View in PBA.

Также вы можете посмотреть аналитику по событиям в разделе Dashboards > People-Based Attribution.

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

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

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

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

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

  sequenceDiagram
    participant User
    participant App as Application
    participant Shop as Web Shop
    participant Backend as Xsolla Backend
    participant AF as AppsFlyer
    User->>App: 1. Logs in
    App->>AF: 2. Sends CUID
    AF-->>Backend: 3. Sends postback (Application ID, AppsFlyer ID, CUID)
    User->>Shop: 4. Logs in with CUID
    User->>Shop: 5. Makes purchase
    Shop->>Backend: 6. Sends purchase event
    Backend->>AF: 7. Sends xsolla-billing-payment event

1. Пользователь (игрок) регистрируется или авторизуется в мобильном Android- или iOS-приложении.
2. Ваше приложение отправляет стандартное событие (in-app event) в AppsFlyer: af_login, af_signup или любое другое событие, которое содержит CUID.
3. AppsFlyer отправляет постбэк в Xsolla, который содержит application ID, AppsFlyer ID и CUID.
4. Пользователь авторизуется в Web Shop, используя CUID.
5. Пользователь совершает покупку в Web Shop.
6. Событие покупки отправляется на сервер Xsolla и сопоставляется с информацией, полученной от AppsFlyer.
7. Сервер Xsolla отправляет S2S-событие (in-app event) к  AppsFlyer, которое содержит AppsFlyer ID и CUID.

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

2. Нажмите панель AppsFlyer.

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

4. В открывшемся окне введите следующие данные:
   1. S2S-токен AppsFlyer.
   2. ID приложения на платформах публикации Android/iOS в следующем формате:
      • iOS: idXXXXXXXXX;
      • Android: com.example.yourapp
      Чтобы добавить платформу, нажмите Добавить ID приложения.
5. Нажмите Сохранить.

После сохранения переключатель в панели AppsFlyer будет в активном положении.

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

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

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

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

1. Получить S2S-токен.
2. Активировать интеграцию с Xsolla.

Получение S2S-токена

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

1. Авторизуйтесь в вашем аккаунте AppsFlyer HQ.
2. Перейдите в раздел Account > Security Center > AppsFlyer API and S2S tokens.
3. В строке с S2S-токеном нажмите значок копирования в столбце Token.

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

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

1. В вашем аккаунте AppsFlyer HQ выберите нужное Android- или iOS-приложение и перейдите в раздел Collaborate > Partner marketplace.

2. В поисковой строке найдите и выберите Xsolla.

3. Нажмите Set up integration.

4. На вкладке интеграции:
   1. Переведите переключатель Activate Partner в активное положение.
   2. Только для iOS-приложений: переведите переключатель Advanced Privacy в положение в соответствии с вашей политикой конфиденциальности:
      • Активное — все события отправляются в Xsolla.
      • Неактивное — только события, соответствующие ATT, отправляются в Xsolla.

1. 3. Для Default postbacks оставьте значение по умолчанию — off.
   4. Переведите переключатель In-app event postbacks в активное положение.
   5. Настройте хотя бы одно событие (in-app event), которое содержит информацию об авторизации (CUID).
   6. Введите любое значение в поле mapped to partner event. Xsolla поддерживает любое название события.
   7. Сохраните интеграцию.

Подробную информацию о настройке интеграции на стороне AppsFlyer читайте в документации AppsFlyer.

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

Если вы хотите настроить определенное событие или если текущие возможности интеграции не соответствуют вашим потребностям, обратитесь к персональному менеджеру проекта или напишите на [email protected].

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

Когда пользователь совершает покупку в Web Shop, Xsolla отправляет событие xsolla-billing-payment в AppsFlyer.

Основные параметры

Дополнительные параметры

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

Пример события с указанием одного артикула товара:

 1{
 2    "af_content_id" : "test-coin",
 3    "af_quantity" : "2",
 4    "af_revenue" : "40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "af_net_revenue" : "32.27",
 9    "payout_amount" : "404577.4",
10    "payout_currency" : "UZS",
11    "af_receipt_id" : "5555555550",
12    "af_store" : "xsolla",
13    "af_dry_run" : "0",
14    "date_payment" : "2026-08-27T01:50:58Z"
15}

Пример события с указанием нескольких артикулов товара:

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_revenue" : "40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "af_net_revenue" : "32.27",
 9    "payout_amount" : "404577.4",
10    "payout_currency" : "UZS",
11    "af_receipt_id" : "5555555550",
12    "af_store" : "xsolla",
13    "af_dry_run" : "0",
14    "date_payment" : "2026-08-27T01:50:58Z"
15}

Возврат платежа

Когда пользователь инициирует возврат платежа, Xsolla отправляет событие xsolla-billing-refund в AppsFlyer.

Основные параметры

Дополнительные параметры

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

Пример события с указанием нескольких артикулов товара:

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_revenue" : "-40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "af_net_revenue" : "-32.27",
 9    "payout_amount" : "404577.4",
10    "payout_currency" : "UZS",
11    "af_receipt_id" : "5555555550",
12    "af_store" : "xsolla",
13    "af_dry_run" : "0",
14    "date_payment" : "2026-08-27T01:50:58Z"
15}

Создание счета на оплату

Когда в системе Xsolla создается счет на оплату товара в Web Shop, Xsolla отправляет событие xsolla-billing-created в AppsFlyer.

Основные параметры

Дополнительные параметры

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

Пример события с указанием нескольких артикулов товара:

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_item_value" : "40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "payout_amount" : "404577.4",
 9    "payout_currency" : "UZS",
10    "af_receipt_id" : "5555555550",
11    "af_store" : "xsolla",
12    "af_dry_run" : "0",
13    "date_payment" : "2026-08-27T01:50:58Z"
14}

Ошибка оплаты

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

Основные параметры

Дополнительные параметры

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

Пример события с указанием нескольких артикулов товара:

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_item_value" : "40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "payout_amount" : "404577.4",
 9    "payout_currency" : "UZS",
10    "af_receipt_id" : "5555555550",
11    "af_store" : "xsolla",
12    "af_dry_run" : "0",
13    "date_payment" : "2026-08-27T01:50:58Z"
14}