Airbridgeとの統合

用語集

統合シナリオ

Airbridgeとエクソーラは、モバイルアプリケーションのS2S統合をサポートしており、モバイルアプリケーション内およびウェブショップでの購入の両方について、完全なLTVとROASの測定を可能にします。エクソーラは、ウェブショップでの購入情報をモバイルのアプリ内イベントとしてAirbridgeに送信し、Airbridgeはこれをモバイルアプリケーションのインストール数、ユーザー獲得キャンペーン、再エンゲージメントキャンペーンにアトリビュートします。

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

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

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

仕組み

この統合には、エクソーラとAirbridge間の双方向のデータフローが含まれます。以下に、ユーザーが購入を行った際のシステム統合シナリオを示します。

  sequenceDiagram
    participant U as ユーザー
    participant MA as モバイルアプリ
    participant WS as ウェブショップ
    participant XB as エクソーラバックエンド
    participant AB as Airbridge
    U->>MA: ログイン
    MA->>AB: CUIDを送信する
    AB-->>XB: ポストバックを送信する
    U->>WS: CUIDでログインする
    U->>WS: 購入を行う
    WS->>XB: 購入イベントを送信する
    XB->>AB: xsolla-billing-paymentイベントを送信する

1. ユーザー（プレイヤー）がモバイルアプリケーションに新規登録またはログインします。
2. アプリケーションが、login、signup、またはCUIDを含むその他のイベントといったアプリ内イベントをAirbridgeに送信します。
3. Airbridgeは、アプリケーションストアID、Airbridge ID、CUID、およびその他の関連するデータパラメータを含むポストバックをエクソーラに送信します。
4. ユーザーはCUIDを使用してウェブショップにログインします。
5. ユーザーはウェブショップで購入します。
6. 購入イベントはエクソーラバックエンドに送信され、Airbridgeから受け取った情報と一致します。
7. エクソーラのサーバーが、Airbridge ID、アプリケーションストアID、およびAirbridgeから受信したその他のパラメータを含むS2Sアプリ内イベントをAirbridgeに送信します。

Airbridgeは、この新しいイベント、購入、収益をユーザー獲得またはユーザーの再エンゲージメントを促進したメディアソースに帰属させます。

2. 「Airbridge」ペインをクリックします。

   

3. モバイルアプリS2S統合ペインで、「設定」をクリックします。

4. 開いたウィンドウで、この統合を有効にするボックスにチェックを入れます。
5. 以下のデータを入力してください：
   • Airbridge S2Sトークン。
   • 公開プラットフォーム（Android/iOS）用のアプリケーションストアID。プラットフォームを追加するには、「アプリケーションIDを追加」をクリックしてください。

1. 下記の説明に従って、Airbridgeアカウント内でこれらのパラメータの値をコピーする必要があります。

6. 「保存」をクリックします。
7. Airbridgeで統合を有効にします。

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

接続済みの統合を変更するには：

1. 「Airbridge」ペインをクリックします。
2. 開いたウィンドウで必要な変更を行います。
3. 「保存」をクリックします。

Airbridgeでのセットアップ方法

Airbridgeでは、以下を行う必要があります：

1. 認証情報を取得します。
2. エクソーラとの統合をアクティブ化にします。

認証情報を取得する

1. Airbridgeアカウントにログインします。
2. Integration > Third-party integrationセクションに移動します。
3. 「Xsolla」ペインをクリックします。

エクソーラとの統合をアクティブ化にする

1. Airbridgeアカウントにログインします。
2. Integration > Third-party integrationセクションに移動します。
3. Xsollaペインをクリックします。
4. Send eventsトグルをアクティブに設定します。

注意

App Tracking Transparency（ATT）を拒否したiOSユーザーのデータを共有するためには、EPC (Extended Privacy Control)トグルを非アクティブに設定してください。もしこのトグルが無効になっている場合は、それを更新するためにSettings > App settingsセクションに移動してください。

イベント値の構造

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

アイテム購入

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

追加データ

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