Adjustとの統合

用語集

Adjust

モバイルアトリビューションおよびマーケティング分析プラットフォームです。Adjustは、アプリケーション開発者、マーケター、ブランドが、さまざまなチャンネルやデバイスを横断して、マーケティングキャンペーンの効果を追跡、測定、最適化できるようにします。

プラットフォームの詳細については、Adjustに関するドキュメントを参照してください。

アプリトークン

各プラットフォーム（Android、iOSなど）に固有のモバイルアプリケーションIDです。Adjustにアプリケーションを追加する際に自動的に生成されます。この値は、AdjustのAppView > All appsセクションで、該当するアプリケーション名の横に表示されています。

Adjust ID

Adjustが生成したユーザーID。

生涯価値（LTV）

ユーザーがアプリケーションを使用している間に生み出す平均収益。LTVの詳細については、Adjustに関するドキュメントを参照してください。

広告費用対効果（ROAS）

広告費用1単位あたりに獲得した収益を計算することで、広告キャンペーンの効果を測定するメトリクスです。ROASの詳細については、Adjustに関するドキュメントを参照してください。

アプリ内イベント

アプリケーション内でのユーザーアクションです。アプリ内イベントの詳細については、Adjustに関するドキュメント を参照してください。S2S（サーバー間）連携の場合、ウェブショップでのユーザーアクションもインアプリイベントと見なされ、エクソーラのバックエンドからAdjustに送信されます。

ユーザー獲得

マーケティング活動を通じて、サイト、サービス、プラットフォーム、またはアプリケーションに新規ユーザーを引き付けるプロセス。

顧客ユーザーID（CUID）

ユーザー登録時にアプリケーション所有者によって生成・設定されるユーザーIDです。CUIDはウェブショップとAdjustで同じである必要があります。ユーザーの照合とアトリビューションのために、このパラメータが利用されます。

注意

以下の説明に従って、xsolla_cuidというパートナーパラメータとしてCUIDを渡す必要があります。

ウェブショップとモバイルアプリケーションでCUIDが一致しない場合は、ウェブショップでのユーザー検証ウェブフック、またはディープリンク経由の認証を実装するため、カスタマーサクセスマネージャーに連絡するか、csm@xsolla.comまでメールをお送りください。

コールバック

アプリ内イベントに関するデータを受け取る処理。詳細については、Adjustに関するドキュメントを参照してください。

サーバー間（S2S）セキュリティトークン

イベントデータをAdjustに送信するためのS2Sコールを承認するために使用されるトークン。Adjust側で生成されます。S2Sトークンの詳細については、Adjustに関するドキュメントをご参照ください。

統合シナリオ

Adjustとエクソーラは、モバイルアプリケーションのS2S統合をサポートしており、アプリケーション内やウェブショップでの購入について、完全なLTV（顧客生涯価値）とROAS（広告費用対効果）の測定を可能にします。エクソーラは、ウェブショップでの購入情報をモバイルのアプリ内イベントとして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. エクソーラとの統合を有効にします。

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をクリックします。
5. 必要なS2Sトークンの行で、コピーのアイコンをクリックします。

S2Sトークンをまだ取得していない場合は、説明に従って作成してください。

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

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をクリックします。

1. 2. Adjust event セクションで、xsolla-billing-paymentをクリックします。
   3. Partner event セクションで、Xsolla billing paymentをクリックします。
   4. Applyをクリックします。

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

イベント値の構造

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

アイテム購入

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

追加データ

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