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

Глоссарий

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

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

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

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

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

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

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

  sequenceDiagram
    participant User
    participant Mobile App
    participant Web Shop
    participant Xsolla Backend
    participant Airbridge
    User->>Mobile App: 1. Logs in
    Mobile App->>Airbridge: 2. Sends CUID
    Airbridge-->>Xsolla Backend: 3. Sends postback
    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->>Airbridge: 7. Sends xsolla-billing-payment event

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

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

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

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

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

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

1. Вам необходимо скопировать значения этих параметров в вашем аккаунте Airbridge, как описано ниже.

6. Нажмите Сохранить.
7. Настройте интеграцию на стороне Airbridge.

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

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

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

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

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

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

Получение учетных данных

1. Авторизуйтесь в вашем аккаунте Airbridge.
2. Перейдите в раздел Integration > Third-party integration.
3. Нажмите панель Xsolla.

4. В разделе Set up Xsolla dashboard скопируйте значения Application store ID и Airbridge S2S token и укажите их в Личном кабинете.

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

После того как вы активировали интеграцию в Личном кабинете:

1. Авторизуйтесь в вашем аккаунте Airbridge.
2. Перейдите в раздел Integration > Third-party integration.
3. Нажмите панель Xsolla.
4. Установите переключатель Send events в активное положение.

Примечание

Чтобы передавать данные пользователей iOS, отказавшихся от применения App Tracking Transparency (ATT), установите переключатель EPC (Extended Privacy Control) в неактивное положение. Если переключатель недоступен, перейдите в раздел Settings > App settings, чтобы изменить эту настройку.

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

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

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

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

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

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