Singularとの統合

用語集

Singular

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

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

アプリケーション​ID

各プラットフォーム（Android、iOS）に固有のモバイルアプリケーションIDです。SingularのSettings > Appsセクションにある、該当アプリケーションのペインで確認できるBundle IDの値と一致します。

アプリ内イベント

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

ユーザー獲得

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

リターゲティング

過去のまたは現在のユーザーに広告キャンペーンを通じてリーチする。これは、以前にあなたのアプリケーションまたはサイトとインタラクトしたユーザーと関わる戦略を指します。詳細については、Singular ドキュメントを参照してください。

顧客ユーザーID（CUID）

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

注意

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

ポストバック

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

SDKキー

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

統合フロー

Singularとエクソーラは、モバイルアプリケーションのS2S統合に対応しており、ユーザー獲得やリターゲティングキャンペーンがウェブショップへのトラフィックを呼び込む効果を測定または評価することができます。エクソーラは、ウェブショップでの購入情報をモバイルのアプリ内イベントとしてSingularに送信し、Singularはそれを該当するソースに関連付けます。

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

• Android/iOS向けのモバイルアプリケーションをお持つ
• Singularを使用する
• ゲーム内アイテムの販売にウェブショップソリューションを使用する

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

どのように動作するか

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

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent', 'noteTextColor': '#495C6B' }}}%%
sequenceDiagram
    participant User
    participant Mobile App
    participant Web Shop
    participant Xsolla Backend
    participant Singular
    User->>Mobile App: 1. Logs in
    Mobile App->>Singular: 2. Sends CUID
    Singular->>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->>Singular: 7. Sends xsolla-billing-payment event

1. ユーザー（プレイヤー）がモバイルアプリにサインアップまたはログインします。
2. アプリケーションがSingularにアプリ内イベント（例：login、またはCUIDを含むその他のイベント）を送信します。
3. SingularはCUIDやユーザーデバイスに関するその他のデータを含むポストバックをエクソーラに送信します。
4. ユーザーはCUIDを使用してウェブショップにログインします。
5. ユーザー​はウェブショップ​で購入します。
6. 購入イベントはエクソーラバックエンドに送信され、Singularから受け取った情報と一致します。
7. エクソーラのサーバーは、マッピングに必要なパラメータを含むアプリ内イベントをSingularに送信します。

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

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

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

3. モバイルアプリS2S統合ペインで、「構成」をクリックします。
4. 開いたウィンドウで、この統合を有効にするのチェックボックスがオンになっていることを確認してください。
5. 以下のデータを提供してください：
   1. Singular SDKキー。
   2. 各プラットフォーム（Android/iOS）に固有のアプリケーションID。プラットフォームを追加するには、「アプリケーションIDを追加」をクリックします。
6. 「保存」をクリックします。
7. Singularで統合を有効にします。

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

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

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

Singularでのセットアップ方法

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

1. SDKキーを取得します。
2. エクソーラとの統合をアクティブ化にします。

SDKキーを取得する

1. Singularアカウントにログインします。
2. Developer Tools > SDK Integrationセクションを開きます。
3. SDK Keysタブに移動します。
4. Show Keysをクリックします。
5. SDK Key フィールドでの値をコピーします。

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

1. Singularアカウントにログインします。
2. Attribution Setup > Partner Configurationセクションに移動します。
3. Add Partnerをクリックします。
4. 検索バーにXsollaと入力して選択します。

5. 開いたウィンドウで、統合を構成するアプリケーションを選択してください。
6. Nextをクリックします。
7. Events Postbacksブロックで、Loginイベントが選択されていることを確認してください。
8. Saveをクリックします。

イベント値の構造

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

アイテム購入

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

追加データ

xsolla-billing-paymentイベントで渡されるパラメータに加えて、エクソーラは以下のデータを送信します：