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

• Вы используете AppsFlyer Measurement Platform и подключили для аккаунта People-Based Attribution.
• Вы используете Xsolla Site Builder.

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

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

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

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

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. Перейдите в конструктор сайтов одним из следующих способов:
   • В боковом меню нажмите Site Builder.
   • В боковом меню нажмите Интеграции. В открывшемся разделе:
     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 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"
}