Airbridgeとの統合

用語集

統合シナリオ

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

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

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

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

仕組み

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

  sequenceDiagram
    participant User
    participant Mobile App
    participant Web Shop
    participant Xsolla Backend
    participant Airbridge
    User->>Mobile App: 1. Logs in
    Mobile App->>Airbridge: 2. Sends CUID
    Airbridge-->>Xsolla Backend: 3. Sends postback
    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->>Airbridge: 7. Sends xsolla-billing-payment event

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

パブリッシャーアカウントでのセットアップ方法

1. パブリッシャーアカウントでプロジェクトを開き、統合セクションに移動します。
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」ペインをクリックします。

4. Set up Xsolla dashboardセクションで、Application store IDとAirbridge S2S tokenの値をコピーしてパブリッシャーアカウントで貼り付けます。

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

パブリッシャーアカウントで統合を有効にした後：

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

注意

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

イベント値の構造

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

アイテム購入

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

追加データ

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