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

Глоссарий

Tenjin

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

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

ID приложения

ID мобильного приложения. Генерируется автоматически при добавлении приложения в Tenjin. Соответствует Bundle ID. Чтобы найти это значение:

1. В вашем аккаунте Tenjin перейдите в раздел Configure > All apps.
2. Перейдите в раздел нужного приложения.
3. В разделе Add details скопируйте Bundle ID.

Ключ SDK

ID мобильного приложения. Генерируется автоматически при добавлении приложения в Tenjin. Соответствует Bundle ID. Чтобы найти это значение:

1. В вашем аккаунте Tenjin перейдите в раздел Configure > All apps.
2. Перейдите в раздел нужного приложения.
3. В разделе Add details скопируйте Bundle ID.

Примечание

Если ваше приложение опубликовано как на платформе iOS, так и на Android, вам необходимо получить общий ключ для приложения. Для этого свяжитесь с вашим менеджером Tenjin.

Общий ключ для приложения (account level key)

Авторизационный токен server-to-server (S2S) запросов, если ваше приложение опубликовано как на платформе iOS, так и на Android. Генерируется вручную на стороне Tenjin. Чтобы получить этот ключ, свяжитесь с вашим менеджером Tenjin.

Обратите внимание, что ID приложения (Bundle ID) уникальны для каждой платформы.

Tenjin ID

ID пользователя, сгенерированный на стороне Tenjin (analytics_installation_id).

Пожизненная ценность (Lifetime value или LTV)

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

Окупаемость затрат на рекламу (Return on advertising spend или ROAS)

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

Окупаемость инвестиций (Return on investment или ROI)

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

Событие в приложении

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

Привлечение пользователей

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

Customer user ID (CUID)

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

Внимание

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

Обратный вызов (callback)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. Настроить передачу CUID в Tenjin.
2. Добавить Xsolla в качестве маркетингового канала.
3. Настроить функцию обратного вызова.

Передача CUID

Настройте передачу CUID из вашего мобильного приложения в Tenjin с помощью вызова метода setCustomerUserId:

1TenjinSDK instance = TenjinSDK.getInstance(this, "<TENJIN_SDK_KEY>");
2instance.setCustomerUserId(cuid);   // CUID generated by your backend
3instance.connect();

1TenjinSDK.initialize("<TENJIN_SDK_KEY>")
2TenjinSDK.setCustomerUserId(userId: cuid);  // CUID used for Web Shop
3TenjinSDK.connect();

1BaseTenjin instance = Tenjin.getInstance("<TENJIN_SDK_KEY>");
2instance.SetCustomerUserId(cuid);   // CUID used for Web Shop
3instance.Connect();

Добавление Xsolla в качестве маркетингового канала

1. Авторизуйтесь в вашем аккаунте Tenjin.
2. Перейдите в раздел Configure > Channels.
3. Нажмите Add a channel.

4. В поисковой строке введите и выберите Xsolla.
5. Нажмите панель Xsolla.

6. Нажмите Add ad account.

Настройка функции обратного вызова

1. Авторизуйтесь в вашем аккаунте Tenjin.
2. Перейдите в раздел Configure > Channels.
3. Перейдите на страницу необходимого приложения.
4. Перейдите на вкладку Callbacks.
5. В раскрывающемся списке маркетинговых каналов выберите Xsolla.

6. В разделе Channel callbacks нажмите Add events и выберите Xsolla login.

7. В модальном окне выберите событие, которое содержит CUID, и нажмите Save.

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

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

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

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

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

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