以下の場合、AppsFlyerとのWeb SDK統合を構成し、高度なイベント分析を得ることができます：

• AppsFlyer測定プラットフォームを使用し、アカウントでピープルベースドアトリビューションを有効にする
• エクソーラサイトビルダーを使用する

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

仕組み

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

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

  sequenceDiagram
    participant User
    participant Promo as Web Shop<br>promotional campaign<br>(ad banner)
    participant Shop as Web Shop
    participant AF as AppsFlyer
    User->>Promo: 1. Clicks banner
    Promo->>Shop: 2. Redirect with URL parameters
    Shop->>AF: 3. load event
    User->>Shop: 4. Logs in with CUID
    Shop->>AF: 5. identify event
    User->>Shop: 6. Makes purchase
    Shop->>AF: 7. event

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ペインで、「接続」をクリックします。

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

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

1. パブリッシャーアカウントでプロジェクトを開き、統合に移動します。
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側のドキュメントを​ご覧ください。

イベント値の構造

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

商品購入

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

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

 1{
 2    "af_content_id" : "test-coin",
 3    "af_quantity" : "2",
 4    "af_revenue" : "99.99",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "USD",
 7    "af_payment_amount" : "99.99",
 8    "af_net_revenue" : "80.00",
 9    "af_receipt_id" : "5555555550",
10    "af_store" : "xsolla",
11    "af_dry_run" : "0"
12}

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

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_revenue" : "99.99",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "USD",
 7    "af_payment_amount" : "99.99",
 8    "af_net_revenue" : "80.00",
 9    "af_receipt_id" : "5555555550",
10    "af_store" : "xsolla",
11    "af_dry_run" : "0"
12}

返金

ユーザーが決済の返金を​開始すると、​エクソーラはxsolla-billing-refundイベントを​AppsFlyerに送信します。​イベントパラメータには​以下の返金情報が​渡されます：

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

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_revenue" : "-99.99",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "USD",
 7    "af_payment_amount" : "99.99",
 8    "af_net_revenue" : "80.00",
 9    "af_receipt_id" : "5555555550",
10    "af_store" : "xsolla",
11    "af_dry_run" : "0"
12}

請求書の作成

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

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

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_item_value" : "99.99",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "USD",
 7    "af_payment_amount" : "99.99",
 8    "af_net_revenue" : "80.00",
 9    "af_receipt_id" : "5555555550",
10    "af_store" : "xsolla",
11    "af_dry_run" : "0"
12}

支払いエラー

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

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

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_item_value" : "99.99",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "USD",
 7    "af_payment_amount" : "99.99",
 8    "af_net_revenue" : "80.00",
 9    "af_receipt_id" : "5555555550",
10    "af_store" : "xsolla",
11    "af_dry_run" : "0"
12}