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

Глоссарий

Singular

Платформа для мобильной атрибуции и маркетинговой аналитики. Singular позволяет разработчикам приложений, маркетологам и брендам отслеживать, измерять и оптимизировать маркетинговые кампании по различным каналам и устройствам.

Подробная информация о платформе приведена в документации Singular.

ID приложения

ID мобильного приложения, уникальный для мобильной платформы (Android, iOS). Соответствует значению Bundle ID, которое вы можете найти в Singular в разделе Settings > Apps в панели необходимого приложения.

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

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

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

Процесс привлечения новых пользователей на сайт, сервис, платформу или приложение с помощью маркетинговой активности.

Ретаргетинг

Привлечение текущих или прошлых пользователей посредством рекламных кампаний. Относится к стратегии вовлечения пользователей, которые ранее взаимодействовали с вашим приложением или платформой. Подробная информация приведена в документации Singular.

Customer user ID (CUID)

ID пользователя, сгенерированный и установленный владельцем приложения в момент регистрации пользователя. CUID для Web Shop и Singular должны совпадать. Этот параметр используется для атрибуции пользователей.

Внимание

Вам необходимо настроить передачу этого параметра в постбэке. Если CUID в Web Shop и вашем мобильном приложении не совпадают, обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com, чтобы настроить обработку вебхука Проверка пользователя в Web Shop или аутентификации пользователя через диплинк.

Примечание

Чтобы настроить CUID, следуйте документации Singular SDK.

Постбэк

Процесс получения данных о событиях в приложении. Подробная информация приведена в документации Singular.

Ключ SDK

Авторизационный токен запросов для отправки данных о событии в Singular. Генерируется на стороне Singular. Подробная информация приведена в документации Singular.

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

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

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

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

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

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

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

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

1. Пользователь (игрок) регистрируется или авторизуется в мобильном приложении.
2. Ваше приложение отправляет в Singular событие, например login, или любое другое событие, которое содержит CUID.

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

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

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

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

3. В панели S2S-интеграция для приложений нажмите Настроить.
4. В открывшемся окне проверьте, что флажок Включить эту интеграцию установлен.
5. Укажите следующие данные:
   1. Ключ SDK из Singular.
   2. ID приложения, уникальный для мобильной платформы (Android/iOS). Чтобы добавить платформу, нажмите Добавить ID приложения.
6. Нажмите Сохранить.
7. Настройте интеграцию на стороне Singular.

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

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

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

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

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

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

Получение ключа SDK

1. Авторизуйтесь в вашем аккаунте Singular.
2. Откройте раздел Developer Tools > SDK Integration.
3. Перейдите на вкладку SDK Keys.
4. Нажмите Show Keys.
5. Скопируйте значение из поля SDK Key.

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

1. Авторизуйтесь в вашем аккаунте Singular.
2. Перейдите в раздел Attribution Setup > Partner Configuration.
3. Нажмите Add Partner.
4. В поисковой строке введите и выберите Xsolla.

5. В открывшемся окне в раскрывающемся списке выберите приложение, для которого вы настраиваете интеграцию.
6. Нажмите Next.
7. Убедитесь, что в блоке Events Postbacks выбрано событие Login.
8. Нажмите Save.

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

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

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

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

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

В дополнение к параметрам, переданным в событии xsolla-billing-payment, Xsolla отправляет следующие данные: