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

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

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

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

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

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.

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

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

1. Откройте проект в Личном кабинете.
2. В боковом меню нажмите Интеграции.
3. Нажмите панель AppsFlyer.

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

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

После сохранения переключатель в панели 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.

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

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

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

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

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

{
    "af_content_id": "test-coin",
    "af_quantity": "11",
    "af_revenue": "99.99",
    "af_currency": "USD",
    "af_purchase_currency": "USD",
    "af_receipt_id": "1234567890"
}

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

{
    "af_content_id": ["test-coin-1", "test-coin-2"],
    "af_quantity": ["5", "60"],
    "af_revenue": "99.99",
    "af_currency": "USD",
    "af_purchase_currency": "USD",
    "af_receipt_id": "1234567890"
}

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

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

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

{
    "af_content_id": ["test-coin-1", "test-coin-2"],
    "af_quantity": ["5", "60"],
    "af_revenue": "-99.99",
    "af_currency": "USD",
    "af_purchase_currency": "USD",
    "af_receipt_id": "1234567890"
}