Integration with Tenjin

词汇表

Integration scenario

Tenjin and Xsolla support the mobile application S2S integration that allows completion of full LTV, ROAS, and ROI measurement for the purchases within the application and on Web Shop. Xsolla sends information about Web Shop purchases to Tenjin as mobile in-app events, which Tenjin then attributes to the number of mobile application installations and user acquisition campaigns.

You can configure mobile application integration to get advanced event analytics if you:

• have a mobile application on the Android/iOS platform
• use Tenjin
• use Web Shop solution to sell in-game items

The following event is available via the Xsolla and Tenjin S2S integration:

运行机制

The integration includes a bidirectional data flow between Xsolla and Tenjin. Below is the system interaction scenario when a user makes a purchase.

  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. The user signs up or logs in to the mobile application.
2. Your application sends an in-app event that includes the CUID to Tenjin.
3. Tenjin sends a callback to Xsolla, which includes the application ID, Tenjin ID, CUID, and other related data parameters.
4. The user logs in to Web Shop using the CUID.
5. The user makes a purchase in Web Shop.
6. The purchase event is sent to the Xsolla server and matched with the data received from Tenjin.
7. Xsolla’s server sends an S2S in-app event to Tenjin, which contains the Tenjin ID, application ID, and other parameters received from Tenjin.

Tenjin attributes a new event, purchase, and revenue back to the media source.

How to set up in Publisher Account

1. Open your project in the Publisher Account and go to the Integrations section.
2. Click the Tenjin pane.

3. In the Mobile app S2S integration pane, click Configure.
4. Check the Enable this integration box.
5. Enter the following data:
   • SDK key generated on the Tenjin side per platform. If your application is published on both iOS and Android platforms, you need to specify an account level key you received from Tenjin.
   • Application ID.
6. Click Save.
7. Enable the integration in Tenjin.

保存设置后，S2S集成面板上将显示一个绿色指示器。

To make changes to the active integration:

1. Click the Tenjin pane.
2. In the window that opens, make the necessary changes.
3. Click Save.

How to set up in Tenjin

In Tenjin, you need to:

1. Configure passing CUID to Tenjin.
2. Add Xsolla as an ad channel.
3. Configure a callback.

Pass CUID

Configure the CUID transfer from your mobile application to Tenjin by calling the setCustomerUserId method:

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();

Add Xsolla as add channel

1. Log in to your Tenjin account.
2. Go to the Configure > Channels section.
3. Click Add a channel.

4. In the search bar, enter and select Xsolla.
5. Click the Xsolla pane.

6. Click Add ad account.

Configure callback

1. Log in to your Tenjin account.
2. Go to the Configure > Channels section.
3. Go to the page for a necessary application.
4. Go to the Callbacks tab.
5. In the drop-down list of ad channels, select Xsolla.

6. In the Channel callbacks section, click Add events and select Xsolla login.

7. In the modal window, select the event that contains CUID and click Save.

Event value structure

如果想设置特定事件或当前集成方案无法满足您的需求，请联系您的客户成功经理或发送邮件至csm@xsolla.com。

Item purchase

When a user makes a purchase in Web Shop, Xsolla sends the xsolla-billing-payment event to Tenjin. The following purchase information is passed in the event parameters:

Additional data

Additionally, you can pass the following parameters in the callback: