Tenjinとの統合

用語集

Tenjin

アプリケーション開発者やマーケターが、さまざまなチャンネルやデバイスにわたるマーケティングキャンペーンを追跡、測定、最適化できるようにする、モバイルアトリビューションおよびマーケティング分析のためのプラットフォームです。

プラットフォームの詳細については、Tenjinに関するドキュメントを参照してください。

アプリケーションID

Tenjinにアプリケーションを追加した際に自動生成される、モバイルアプリケーションIDです。これはBundle IDに対応しています。値を確認するには、以下の手順を行ってください：

1. Tenjinのアカウントにログインし、Configure > All appsセクションに移動します。
2. 対象のアプリケーションのページを開きます。
3. Add detailsセクションでBundle IDをコピーします。

SDKキー

Tenjinにアプリケーションを追加した際に自動生成される、モバイルアプリケーションIDです。これはBundle IDに対応しています。値を確認するには、以下の手順を行ってください：

1. Tenjinのアカウントにログインし、Configure > All appsセクションに移動します。
2. 対象のアプリケーションのページを開きます。
3. Add detailsセクションでBundle IDをコピーします。

注意

アプリケーションがiOSとAndroidの両方のプラットフォームで公開されている場合は、アカウントレベルのキーを取得する必要があります。取得については、Tenjinの担当マネージャーまでお問い合わせください。

アカウントレベルキー

アプリケーションがiOSとAndroidの両方で公開されている場合に、サーバー間（S2S）のAPIコールを認証するために使用されるトークンです。このキーはTenjin側で手動発行されます。取得をご希望の場合は、Tenjinの担当マネージャーにご連絡ください。

バンドルIDは各プラットフォームごとに固有であることに注意してください。

Tenjin ID

Tenjinによって生成されるユーザーID（analytics_installation_id）。

生涯価値（LTV）

ユーザーがアプリケーションを使用している間に生み出す平均収益。LTVの詳細については、Tenjinに関するドキュメントを参照してください。

広告費用対効果（ROAS）

広告費用1単位あたりに獲得した収益を計算することで、広告キャンペーンの効果を測定するメトリクスです。ROASの詳細については、Tenjinに関するドキュメントを参照してください。

投資利益率（ROI）

総コストに対して得られた利益の割合を算出することで、投資に対する収益性を測定するメトリクスです。ROIの詳細については、Tenjinに関するドキュメントをご参照ください。

アプリ内イベント

アプリケーション内で行われるユーザーアクション。ウェブショップでのユーザーアクションは、S2S統合の場合、アプリ内イベントとみなされ、エクソーラバックエンドからTenjinに送信されます。

ユーザー獲得

マーケティング活動を通じて、サイト、サービス、プラットフォーム、またはアプリケーションに新規ユーザーを引き付けるプロセスです。

顧客ユーザーID（CUID）

ユーザー登録時にアプリケーション所有者によって生成・設定されるユーザーIDです。CUIDはウェブショップとTenjinで同じである必要があります。このパラメータにより、ユーザーの照合とアトリビューションが可能になります。

お知らせ

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

コールバック

アプリ内イベントに関するデータを受け取る処理。詳細については、Tenjinに関するドキュメントを参照してください。

統合シナリオ

Tenjinとエクソーラは、モバイルアプリケーションのS2S統合をサポートしており、アプリケーション内やウェブショップでの購入について、完全なLTV（顧客生涯価値）、ROAS（広告費用対効果）、ROI（投資利益率）の測定を可能にします。エクソーラは、ウェブショップでの購入情報をモバイルのアプリ内イベントとしてTenjinに送信し、Tenjinはこれをモバイルアプリケーションのインストール数、ユーザー獲得キャンペーンに関連付けます。

モバイルアプリケーションの統合を構成することで、以下の場合に高度なイベントアナリティクスを取得できます：

• Android/iOSプラットフォームのモバイルアプリケーションを所有するる
• Tenjinを使用する
• ゲーム内アイテムの販売にウェブショップソリューションを使用する

エクソーラとTenjin S2Sの統合により、次のイベントを利用できます：

仕組み

この統合には、エクソーラと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. アプリケーションは、CUIDを含むアプリ内イベントをTenjinへ送信します。
3. Tenjinは、アプリケーションストアID、Tenjin ID、CUID、およびその他の[関連するデータパラメータを含むコールバックをエクソーラに送信します。
4. ユーザーはCUIDを使用してウェブショップにログインします。
5. ユーザーはウェブショップで購入します。
6. 購入イベントはエクソーラバックエンドに送信され、Tenjinから受け取った情報と一致します。
7. エクソーラのサーバーが、Tenjin ID、アプリケーションID、およびTenjinから受け取ったその他のパラメータを含むS2S（サーバー間）アプリ内イベントを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. エクソーラを広告チャネルとして追加します。
3. コールバックを設定します。

CUIDを渡す

setCustomerUserIdメソッドを呼び出して、モバイルアプリケーションからTenjinへのCUID転送を設定します。

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

チャンネル追加としてエクソーラを追加する

1. Tenjinアカウントにログインします。
2. Configure > Channelsセクションに移動します。
3. Add a channelをクリックします。

4. 検索バーに「エクソーラ」と入力して選択します。
5. 「Xsolla」ペインをクリックします。

6. 「Add a channel」をクリックします。

コールバックを設定する

1. Tenjinアカウントにログインします。
2. Configure > Channelsセクションに移動します。
3. 必要なアプリケーションのページに移動します。
4. Callbacksタブに移動します。
5. 広告チャンネルのドロップダウンリストで、Xsollaを選択します。

6. Channel callbacksセクションで、「Add events」をクリックてXsolla loginを選択します。

7. モーダルウィンドウで、CUIDを含むイベントを選択し、「Save」をクリックします。

イベント値の構造

特定のイベントを設定したい場合、または現在の統合オプションで要件を満たせない場合は、カスタマーサクセスマネージャーに連絡するか、csm@xsolla.comまでメールしてください。

アイテム購入

ユーザーがウェブショップで購入すると、エクソーラはxsolla-billing-paymentイベントをTenjinに送信します。以下の購入情報がイベントパラメータに渡されます：

追加データ

さらに、コールバックで以下のパラメータを渡すことができます：