AppsFlyerとの統合

以下のイベントは、エクソーラとAppsFlyer Web SDKの統合で利用できます：

仕組み

以下は、ユーザー獲得とリターゲティングのキャンペーンを実施する際のシステムインタラクションのシナリオです。ユーザーは、ウェブショップに広告バナーを通過し、購入を行います。このプロセスでAppsFlyerに送信される一連のイベントにより、以下を確認できます：

• どのユーザーが、何人、どのバナーから獲得したのか
• 彼らが支払った金額
• リターゲティングキャンペーンが効果的であったかどうか

  sequenceDiagram
    participant U as ユーザー
    participant WSP as ウェブショップのプロモーションキャンペーン（広告バナー）
    participant WS as ウェブショップ
    participant AF as AppsFlyer
    U->>WSP: バナーをクリックする
    WSP->>WS: URLパラメータを付けてリダイレクトする
    WS->>AF: ロードイベントを送信する
    U->>WS: CUIDでログインする
    WS->>AF: 特定イベントを送信する
    U->>WS: 購入を行う
    WS->>AF: 購入イベントを送信する

1. ユーザーは広告キャンペーンバナーをクリックします。
2. ユーザーはウェブショップにリダイレクトされ、この移行のURLには、ユーザーがどのバナーやウェブサイトからリダイレクトされたかを指定するAppsFlyerのパラメータグループが含まれます。
3. 訪問に関するイベントは、ウェブショップのクライアント側からAppsFlyerに送信されます。
4. ユーザーはCUIDを使用してウェブショップにログインします。
5. 認証イベントがAppsFlyerに送信されます。
6. ユーザーはウェブショップで購入します。
7. 購入イベントはAppsFlyerに送信されます。

AppsFlyer​でのセットアップ​方法

開始する前に、AppsFlyerプラットフォームで以下の設定を構成します：

1. アプリケーションを追加する：
   1. Add appをクリックします。
   2. リストで、Web (PBA)プラットフォームを選択します。
   3. アプリケーションのURLとして、ウェブショップのドメインを指定します（例：https://www.webshop.example.com/）。
   4. アプリケーション 名を 指定します。（例：Xsolla）。
   5. Add my appをクリックします。

2. バンドルを追加します：
   1. Add bundleをクリックします。
   2. Xsolla-bundleを名称として指定します。
   3. ウェブアプリケーションのリストで、前に追加したXsollaを選択します。
   4. Create bundleをクリックします。

1. パブリッシャーアカウントでプロジェクトを開きます。
2. いずれかの方法でサイトビルダーに移動します：
   • サイドメニューで、「ストアフロント > ウェブサイト」をクリックします。
   • サイドメニューで、「統合」クリックします。開いたセクションで、次の操作を行います：
     1. AppsFlyerペインをクリックします。
     2. Web SDK（サイドメニュー）ペインで、「構成」をクリックします。

3. サイトを選択し、「構成」をクリックします。
4. サイト設定タブ、アプリセクションに移動します。
5. AppsFlyerペインで、「接続」をクリックします。

1. アカウントでプロジェクトを開きます。
2. いずれかの方法でサイトビルダーに移動します：
   • サイドメニューで、「ストアフロント > ウェブサイト」をクリックします。
   • サイドメニューで、「その他のツール > 統合」クリックします。開いたセクションで、次の操作を行います：
     1. AppsFlyerペインをクリックします。
     2. Web SDK（サイドメニュー）ペインで、「設定」をクリックします。

3. サイトを選択し、「構成」をクリックします。
4. サイト設定タブ、アプリセクションに移動します。
5. AppsFlyerペインで、「接続」をクリックします。

1. アカウントでプロジェクトを開きます。
2. いずれかの方法でサイトビルダーに移動します：
   • サイドメニューで、「ストアフロント > ウェブサイト」をクリックします。
   • サイドメニューで、「その他のツール > 統合」クリックします。開いたセクションで、次の操作を行います：
     1. AppsFlyerペインをクリックします。
     2. Web SDK（サイドメニュー）ペインで、「設定」をクリックします。

3. サイトを選択し、「構成」をクリックします。
4. サイト設定タブ、アプリセクションに移動します。
5. AppsFlyerペインで、「接続」をクリックします。

1. アカウントでプロジェクトを開きます。
2. いずれかの方法でサイトビルダーに移動します：
   • サイドメニューで、「ストアフロント > ウェブサイト」をクリックします。
   • サイドメニューで、「その他のツール > 統合」クリックします。開いたセクションで、次の操作を行います：
     1. AppsFlyerペインをクリックします。
     2. Web SDK（サイドメニュー）ペインで、「設定」をクリックします。

3. サイトを選択し、「構成」をクリックします。
4. サイト設定タブ、アプリセクションに移動します。
5. AppsFlyerペインで、「接続」をクリックします。

1. モバイルゲーム用のアカウントでプロジェクトを開きます。
2. 以下の方法でサイトビルダーに移動します：
   • サイドメニューでウェブショップをクリックします。
   • サイドメニューでオペレーション > MMPをクリックします。開いたセクションで：
     1. AppsFlyerパネルをクリックします。
     2. Web SDK (Site Builder)パネルで構成をクリックします。

3. サイトのペインで、「⋮」アイコンをクリックして「設定」を選択します。
4. サイト設定タブ、アプリセクションに移動します。
5. AppsFlyerペインで、「接続」をクリックします。

6. 「AppsFlyer Devキー」フィールドに、開発者キーを入力します。この情報は、AppsFlyerのアカウントで確認できます：
   1. My Appsセクションに移動します。
   2. View brand bundlesをクリックします。
   3. Xsolla-bundleブランドバンドルの行で、Web dev key列のコピーアイコンをクリックします。
7. 「接続」をクリックします。

AppsFlyerでアカウント内のイベントに関する情報を検索するには：

1. My Appsセクションに移動します。
2. Available Appsセクションで、Xsollaアプリを選択し、View in PBAをクリックします。

Dashboards > People-Based Attributionセクションでも分析イベントを確認できます。

モバイルアプリケーション統合を構成して、高度なイベント分析を取得できます：

• Android/iOSプラットフォーム上に​モバイルアプリケーションを​持つ
• AppsFlyer計測プラットフォームを​使用する
• ウェブショップ​ソリューションを​使ってインゲームアイテムを​販売する

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

仕組み

この統合には、​エクソーラとAppsFlyer間の双方向の​データフローが​含まれます。以下は、​ユーザーが​購入するときの​システムインタラクションの​シナリオです。

  sequenceDiagram
    participant User
    participant App as Application
    participant Shop as Web Shop
    participant Backend as Xsolla Backend
    participant AF as AppsFlyer
    User->>App: 1. Logs in
    App->>AF: 2. Sends CUID
    AF-->>Backend: 3. Sends postback (Application ID, AppsFlyer ID, CUID)
    User->>Shop: 4. Logs in with CUID
    User->>Shop: 5. Makes purchase
    Shop->>Backend: 6. Sends purchase event
    Backend->>AF: 7. Sends xsolla-billing-payment event

1. ユーザー（ゲームのプレイヤー）は、Android/iOSモバイルアプリケーションに新規登録またはログインします。
2. アプリケーションは​AppsFlyerに標準のアプリ内イベント​を送信します：​af_login、af_signup、​またはCUIDを含む​イベントです。
3. AppsFlyerは、​アプリケーションID、​appsflyer ID、​CUIDを含むpostbackを​エクソーラに​送信します。
4. ユーザーは​CUIDを使用して​ウェブショップに​ログインします。
5. ユーザー​はウェブショップ​で購入します。
6. 購入イベントは​エクソーラバックエンドに​送信され、​AppsFlyerから受け取った情報と​一致します。
7. エクソーラバックエンドは、AppsFlyer IDとCUIDを含むS2Sのアプリ内イベントをAppsFlyerに送信します。

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

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

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

4. 表示されたウィンドウで、以下のデータを入力します：
   1. AppsFlyer S2Sトークン。
   2. Android/iOS配信プラットフォームのアプリケーションIDを以下の形式で入力します：
      • iOS：idXXXXXXXXX
      • Android：com.example.yourapp
      プラットフォームを追加するには、「アプリケーションIDを追加」をクリックします。
5. 「保存」をクリックします。

保存後、AppsFlyerペインのトグルがオンになります。

接続された統合に変更を加えるには：

1. 「AppsFlyer」ペインをクリックします。
2. 表示されるウィンドウで、​必要な変更を行います。
3. 「保存」をクリックします。

AppsFlyer​でのセットアップ​方法

AppsFlyerでは、​次のことが必要です：

1. S2Sトークンを取得する。
2. Xsollaとの統合を有効にする。

S2Sトークンの取得

S2Sトークンを取得するには：

1. AppsFlyer HQアカウントに​ログインします。
2. 「アカウント > ​セキュリティセンター >​AppsFlyer API ​および S2Sトークンセクションに​移動します。
3. S2Sトークンの行で、​トークンのコピー​アイコンをクリックします。

S2Sトークンをまだ持っていない場合は、​作成してください。

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

1. AppsFlyer HQアカウントで、​必要なAndroid/iOSアプリケーションを選択し、​コラボレーション >​ パートナーマーケットプレイスセクションに​移動します。

2. 検索バーで​「エクソーラ」を​見つけて選択します。

3. 「統合をセットアップする」を​クリックします。

4. 統合タブで：
   1. 「パートナーをアクティブ化」の​トグルにオンします。
   2. iOSアプリケーションのみ：​プライバシーポリシーに従って​「高度なプライバシー」の​トグルを​設定します：
      • オン — すべてのイベントが​エクソーラに​送信されます
      • オフ — ATT同意済みイベントのみが​エクソーラに​送信されます

1. 3. デフォルトのポストバック値の​ままにします — ​off(デフォルト）。
   4. 「アプリ内イベントのポストバック」​トグルを​オンにします。
   5. ログイン情報（CUID）を​含むアプリ内イベントを​少なくとも1つ​設定します。
   6. 「パートナーイベントにマッピング」​フィールドに​任意の値を​入力します。​エクソーラは任意の​イベント名をサポートします。
   7. 統合を保存します。

統合設定については、​AppsFlyer側のドキュメントを​ご覧ください。

イベント値の構造

特定のイベントを​セットアップしたい場合、​または現在の統合機能が​お客様のニーズをカバーできない​場合は、​カスタマーサクセス​マネージャーに​お問い合わせいただくか、​[email protected]までメールでご連絡ください。

商品購入

ユーザーがウェブショップで購入を行うと、エクソーラはAppsFlyerにxsolla-billing-paymentイベントを送信します。

主要なパラメータ

追加のパラメータ

これらのパラメータは集計レポートやダッシュボードには表示されず、生データのエクスポート時のみ利用可能です：

単一のSKUを​使用したイベントの例：

 1{
 2    "af_content_id" : "test-coin",
 3    "af_quantity" : "2",
 4    "af_revenue" : "40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "af_net_revenue" : "32.27",
 9    "payout_amount" : "404577.4",
10    "payout_currency" : "UZS",
11    "af_receipt_id" : "5555555550",
12    "af_store" : "xsolla",
13    "af_dry_run" : "0",
14    "date_payment" : "2026-08-27T01:50:58Z"
15}

複数のSKUを​使用したイベントの例：

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_revenue" : "40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "af_net_revenue" : "32.27",
 9    "payout_amount" : "404577.4",
10    "payout_currency" : "UZS",
11    "af_receipt_id" : "5555555550",
12    "af_store" : "xsolla",
13    "af_dry_run" : "0",
14    "date_payment" : "2026-08-27T01:50:58Z"
15}

返金

ユーザーが決済の返金手続きを開始すると、エクソーラはAppsFlyerにxsolla-billing-refundイベントを送信します。

主要なパラメータ

追加のパラメータ

これらのパラメータは集計レポートやダッシュボードには表示されず、生データのエクスポート時のみ利用可能です：

複数のSKUを​使用したイベントの例：

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_revenue" : "-40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "af_net_revenue" : "-32.27",
 9    "payout_amount" : "404577.4",
10    "payout_currency" : "UZS",
11    "af_receipt_id" : "5555555550",
12    "af_store" : "xsolla",
13    "af_dry_run" : "0",
14    "date_payment" : "2026-08-27T01:50:58Z"
15}

請求書の作成

ウェブショップでのアイテム購入に関する請求書がエクソーラシステム内で作成されたとき、エクソーラはxsolla-billing-createdイベントをAppsFlyerに送信します。

主要なパラメータ

追加のパラメータ

これらのパラメータは集計レポートやダッシュボードには表示されず、生データのエクスポート時のみ利用可能です：

複数のSKUを​使用したイベントの例：

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_item_value" : "40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "payout_amount" : "404577.4",
 9    "payout_currency" : "UZS",
10    "af_receipt_id" : "5555555550",
11    "af_store" : "xsolla",
12    "af_dry_run" : "0",
13    "date_payment" : "2026-08-27T01:50:58Z"
14}

支払いエラー

ウェブショップでの購入時に支払いエラーが発生した時、エクソーラはxsolla-billing-errorイベントをAppsFlyerに送信します。イベントパラメータには、以下の情報が含まれます：

主要なパラメータ

追加のパラメータ

これらのパラメータは集計レポートやダッシュボードには表示されず、生データのエクスポート時のみ利用可能です：

複数のSKUを​使用したイベントの例：

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_item_value" : "40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "payout_amount" : "404577.4",
 9    "payout_currency" : "UZS",
10    "af_receipt_id" : "5555555550",
11    "af_store" : "xsolla",
12    "af_dry_run" : "0",
13    "date_payment" : "2026-08-27T01:50:58Z"
14}