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일

오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.

콘텐츠

글로서리
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