Adjustとの統合

以下の条件を満たしている場合、AdjustとWeb SDKの統合を設定して、高度なイベント分析を行うことができます：

• Adjustを使用する
• エクソーラサイトビルダーを使用してサイトを作成した

以下のイベントは、ウェブSDKの統合で利用できます：

仕組み

以下に、ユーザー獲得およびリターゲティングキャンペーンを実装する際のシステム連携のシナリオを示します。ユーザーが広告バナーを経由してウェブショップにアクセスし、購入を行います。このプロセスでAdjustに送信される一連のイベントにより、以下の追跡が可能になります：

• 各バナーをクリックしたユーザー数とユーザーの流入元
• ユーザーが支払った金額
• リターゲティングキャンペーンが効果的であったかどうか

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

ユーザーフロー：

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

Adjustでのセットアップ方法

Adjustでは、以下の手順が必要です：

1. ウェブアプリケーションを作成します。
2. Adjustのアナリティクスレポートに含めたいイベントを作成します。
3. エクソーラとの統合をアクティブ化します。

ウェブアプリケーションの作成

1. Adjustアカウントにログインします。
2. AppView > All appsセクションに移動します。
3. New appをクリックします。

4. 名称を指定し、レポートに使用する通貨を選択してください。
5. Add appをクリックします。
6. Add platformをクリックします。
7. Webを選択します。

8. ウェブショップのURLを指定してください。
9. Saveをクリックします。

イベントを作成する

1. Adjustアカウントにログインします。
2. AppView > All appsセクションに移動します。
3. 対象となるアプリケーション名をクリックします。

4. Eventsタブで、Add eventをクリックします。

5. 以下のイベントを一つずつ追加してください：
   • サイト訪問に関する一般的な情報を受け取るためのイベント。例えば、xsolla-web-event。
   • ユーザー認証に関する情報を受け取るためのイベント。例えば、xsolla-web-identify。
   • 購入に関する情報を受け取るためのイベント。例えば、xsolla-web-purchase。

イベント名やルールは、ニーズに合わせて指定できます。イベントが追加されると、Eventsタブのリストに表示されます。

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

1. Adjustアカウントにログインします。
2. Campaign Lab > Partnersセクションに移動します。
3. New partnerをクリックします。

4. 検索バーにXsollaと入力して選択します。
5. Nextをクリックします。

6. 統合を設定するアプリケーションを選択します。
7. Nextをクリックします。
8. データ共有を有効化します。これを行うには、Enable data sharingブロックで「Edit」をクリックし、トグルをオンにして「Enable」をクリックします。

9. イベントマッピングを設定します：

1. 1. Map your events ブロックで、Map eventをクリックします。
   2. 以下の表に従ってイベントをマッピングしてください：

1. 3. Applyをクリックします。

10. Nextをクリックします。
11. 設定内容を確認し、Enable partnerをクリックします。必要に応じて前のステップに戻り、設定を更新できます。

お知らせ

「Campaign lab > Partners > 対象のアプリケーション > Data sharing」セクションで既存の連携を更新する場合は、変更内容を反映させるために必ずSaveをクリックしてください。

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

1. パブリッシャーアカウントでプロジェクトを開き、統合セクションに移動します。
2. 「Adjust」ペインをクリックします。

3. Web SDK（サイトビルダー）ペインで「設定」をクリックすると、ウェブサイトの一覧画面へリダイレクトされます。

4. 必要なサイトのウィンドウで、「設定」をクリックします。
5. サイト設定タブから、アプリセクションに移動します。
6. 「Adjust Web SDK」ペインで、「接続」をクリックします。

7. 表示されたモーダルウィンドウで、アプリトークンを入力してください。
8. 「接続」をクリックします。

Adjustアカウントでイベントに関する情報を確認するには、Datascape > Reports > All reportsセクションに移動してください。レポートの操作に関する詳細については、Adjustドキュメントを参照してください。

ウェブおよびアプリ内広告キャンペーンをウェブショップで実行する方法

ウェブショップに関して、以下のユーザー獲得やリターゲティング広告キャンペーンを実施し、その効果を追跡することが可能です：

• ウェブソースからウェブショップへユーザーを誘導するウェブキャンペーン。この場合、追跡およびアトリビューションはAdjustによって処理されます。
• アプリケーションからウェブショップへユーザーを誘導するアプリ内キャンペーン。この場合、DSPを使用する必要があり、追跡およびアトリビューションはAdjustによって処理されます。

Adjust側で広告キャンペーンを設定するには、ドキュメントを参照してください。

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

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

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

仕組み

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

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

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

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

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

1. パブリッシャーアカウントでプロジェクトを開き、統合セクションに移動します。
2. 「Adjust」ペインをクリックします。

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

4. 開いたウィンドウで、この統合を有効にするのチェックボックスがオンになっていることを確認してください。
5. 以下のデータを入力します：
   • Adjust S2Sセキュリティトークン。
   • 配信プラットフォーム用のアプリトークン（Android/iOS）。ラットフォームを追加するには、「アプリトークンを追加」をクリックします。
6. 「保存」をクリックします。
7. Adjustで統合を有効にします。

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

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

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

Adjustでのセットアップ方法

Adjust側で、以下の手順が必要です：

1. CUIDをパートナーパラメータとして渡すように設定します。
2. S2Sセキュリティトークンを作成します。
3. Adjust分析レポート用のイベントを作成します。
4. エクソーラとの統合をアクティブ化します。

CUIDをパートナーパラメータとして渡します

説明に従って、CUIDの転送を自分で設定してください。これを行うには、addGlobalPartnerParameterメソッドを呼び出し、以下のデータを渡します：

• お客様側のユーザーID
• forKey: “xsolla_cuid”

例：

1Adjust.addGlobalPartnerParameter("abcd123", forKey: "xsolla_cuid")

1[Adjust addGlobalPartnerParameter:@"abcd123" forKey:@"xsolla_cuid"];

S2Sセキュリティトークンの作成

S2Sセキュリティトークンを取得するには：

1. Adjustアカウントにログインします。
2. AppView > All appsセクションを開き、対象アプリケーションのページに移動します。
3. Protectionタブに移動します。
4. S2S securityブロックで、Open S2S securityをクリックします。

注意

Enable S2S authenticationトグルをオンにする必要はありませんが、トークン自体はアクティブなステータスである必要があります。

5. New tokenをクリックし、開いたモーダルウィンドウで以下の操作を行ってください。

1. トークンのタイトルを指定します。
2. ScopeフィールドでEventsを選択します。
3. アプリケーションが複数のプラットフォームで公開されている場合は、Enable multi-app S2S tokenのボックスにチェックを入れ、このS2Sトークンを適用するアプリケーションを選択してください。
4. Add tokenをクリックします。

作成されたトークンは、指定したアプリケーションに適用されます。トークンはS2Sトークンのリストから確認できます。

イベントの作成

1. Adjustアカウントにログインします。
2. AppView > All appsセクションを開き、対象アプリケーションのページに移動します。
3. Eventsタブで、Add eventをクリックします。

4. 以下のイベントを一つずつ追加してください：

1. 購入に関する一般情報を受け取るためのイベント。例えば、xsolla-billing-payment。
2. インボイス作成に関する情報を受け取るためのイベント。例えば、xsolla-billing-created。
3. 決済エラーに関する情報を受け取るためのイベント。例えば、xsolla-billing-error。

イベント名やルールは、ニーズに合わせて指定できます。イベントが追加されると、Eventsタブのリストに表示されます。

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

1. Adjustアカウントにログインします。
2. Campaign Lab > Partnersセクションに移動します。
3. New partnerをクリックします。

4. 検索バーにXsollaと入力して選択します。
5. Nextをクリックします。

6. 統合を設定するアプリケーションを選択します。
7. Nextをクリックします。
8. データ共有を有効化します。これを行うには、Enable data sharingブロックで「Edit」をクリックし、トグルをオンにして「Enable」をクリックします。

9. Set your data sharing optionsブロックで、Parametersチェックボックスをオンにしてください。

10. イベントマッピングを設定します：

1. Map your events ブロックで、Map eventをクリックします。
2. 表に従ってイベントをマッピングしてください：

1. 3. Applyをクリックします。

11. すべてのイベントを追加したら、Nextをクリックしてください。

12. 設定内容を確認し、Enable partnerをクリックします。必要に応じて前のステップに戻り、設定を更新できます。

お知らせ

「Campaign lab > Partners > 対象のアプリケーション > Data sharing」セクションで既存の連携を更新する場合は、変更内容を反映させるために必ずSaveをクリックしてください。

イベント値の構造

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

アイテム購入

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

インボイス作成

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

支払いエラー

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

追加データ

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