Integration with Tenjin

用語集

Tenjin

A platform for mobile attribution and marketing analytics. It allows application developers and marketers to track, measure, and optimize marketing campaigns across various channels and devices.

Refer to the Tenjin documentation for detailed information about the platform.

Application ID

Mobile application ID that is automatically generated when adding an application to Tenjin. It corresponds to the Bundle ID. To find its value:

In your account in Tenjin, go to the Configure > All apps section.
Open the page for a necessary application.
In the Add details section, copy the Bundle ID.

SDK key

Token that is used to authorize server-to-server (S2S) calls for sending event data to Tenjin. It’s generated on the Tenjin side. To find its value:

In your account in Tenjin, go to the Configure > All apps section.
Open the page for a necessary application.
In the SDK keys section, copy the value in the row of a necessary key.

If your application is published on both iOS and Android platforms, you need to get an account level key. To do so, contact your Tenjin manager.

Account level key

Token that is used to authorize server-to-server (S2S) calls when your application is published on both iOS and Android platforms. It is generated manually by Tenjin. To get it, contact your Tenjin manager.

Keep in mind that bundle IDs are unique for each platform.

Tenjin ID

User ID generated by Tenjin (analytics_installation_id).

Lifetime value (LTV)

Average revenue that a user generates during the time they use your application. Refer to the Tenjin documentation for detailed information about the LTV.

Return on advertising spend (ROAS)

Metric that measures the effectiveness of an advertising campaign by calculating the revenue earned per unit of advertising spend. Refer to the Tenjin documentation for detailed information about the ROAS.

Return on investment (ROI)

Metric that measures the return on investment by calculating the percentage of profit earned relative to the total cost. Refer to the Tenjin documentation for detailed information about the ROI.

In-app event

User action within the application. User actions in Web Shop are also considered in-app events in the case of S2S integration and sent to Tenjin from the Xsolla back end.

User acquisition

The process of attracting new users to a site, service, platform, or application through marketing activity.

Customer user ID (CUID)

User ID generated and set by the application owner at the time of user registration. The СUID should be the same for Web Shop and Tenjin. This parameter enables user matching and attribution.

ウェブショップとモバイルアプリケーションでCUIDが一致しない場合は、ウェブショップでのユーザー検証ウェブフック、またはディープリンク経由の認証を実装するため、カスタマーサクセスマネージャーに連絡するか、csm@xsolla.comまでメールをお送りください。

Callback

Process of receiving data on in-app events. Refer to the Tenjin documentation for detailed information.

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:

イベント	説明
xsolla-billing-payment	アイテム購入。イベントパラメータには購入に関する情報が含まれます。

仕組み

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

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

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

In the Mobile app S2S integration pane, click Configure.
Check the Enable this integration box.
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.
Click Save.
Enable the integration in Tenjin.

設定を保存すると、S2S統合のペインに緑色のインジケーターが表示されます。

To make changes to the active integration:

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

How to set up in Tenjin

In Tenjin, you need to:

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

Pass CUID

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

Copy

Full screen

Small screen

java

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

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

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

Click Add ad account.

Configure callback

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

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

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

We recommend using a login or app open event and passing the CUID there.

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:

パラメータ	説明
date_payment	Payment date.
invoice_id	Transaction ID.
payment_amount	Amount the user actually paid. At the Tenjin side, the amount will be converted to USD regardless of the currency the user paid in.
payment_currency	Currency in which the user actually paid for the purchase, after conversion or selecting a payment method (payment currency).
payout_amount	Purchase amount received by the merchant (game) after deducting commissions and taxes.
purchase_amount	Purchase amount including discounts, before deducting commissions and taxes.
purchase_currency	Currency in which the item price is displayed in the Web Shop (purchase currency).
skus	Single SKU or array of SKU.
dry_run	Test payment indicator. The parameter is set to `1` if the payment is made in sandbox mode. It is omitted for real payments.

Additional data

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

パラメータ	説明
os_version	Device operating system version.
app_version	Application version.
idfa	Advertiser ID in App Store.
idfv	Vendor ID on the Apple side.
gps_adid	Advertiser ID in Google Play.
sdk_version	Tenjin SDK version.
platform	Application platform.

ご意見ありがとうございました！

あなたのメッセージを確認し、体験を向上させるために利用させていただきます。

最終更新日: 2026年3月10日

誤字脱字などのテキストエラーを見つけましたか？テキストを選択し、Ctrl+Enterを押します。

内容

用語集
Integration scenario
仕組み
How to set up in Publisher Account
How to set up in Tenjin
Pass CUID
Add Xsolla as add channel
Configure callback
Event value structure
Item purchase
Additional data