以下のいずれかを使用している場合は、高度なイベント分析のためにSingularとのWeb SDK連携を設定できます：

• Singularモバイル測定プラットフォーム
• エクソーラサイトビルダー

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

仕組み

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

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

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

ユーザーフロー：

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

Singularでのセットアップ方法

1. Singularアカウントにログインします。
2. 設定 > アプリセクションに移動します。

3. 「新規アプリを追加」をクリックします。

4. ウェブアプリケーション名を指定します。

5. ウェブをOSとして選択します。
6. URLフィールドには、ウェブショップのドメインを指定します（例:yourapp.yourcompany.com）。
7. バンドルIDフィールドには、リバースDNS形式でバンドルIDを指定します（例:com.yourcompany）。
8. 「保存」をクリックします。

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

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

1. • 2. Web SDK（サイトビルダー）ペインで、「設定」をクリックします。

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

3. Singular接続フォームで、SDKキー、SDKシークレット、およびバンドルIDの各フィールドに入力してください：

3. Singularアカウントでこの情報を見つけるには：
   1. Singularアカウントにログインします。
   2. 開発者ツール > SDK統合セクションに移動します。
   3. SDKキータブに移動します。
   4. 「キーを表示」をクリックします。
   5. SDKキーフィールドの値をコピーします。
   6. SDKシークレットフィールドの値をコピーします。

3. 7. バンドルIDを見つけるには、設定 > アプリ > ウェブアプリケーションに移動してバンドルIDをコピーしてください。

4. 「接続」をクリックします。

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

エクソーラウェブショップでのユーザー獲得およびリターゲティング広告キャンペーンの実行と追跡には、これらの手順を使用してください。これは以下の両方に適用されます：

• ウェブからウェブショップへのキャンペーン（ウェブソースからユーザーをウェブショップへ誘導する広告）
• アプリ内からウェブショップへのリターゲティングキャンペーン（アプリケーションのユーザーをウェブショップへターゲットとする広告）

1. Singularアカウントにログインします。
2. アトリビューション設定セクションに移動し、ウェブリンクを作成を選択します。
3. 目標（アプリ）フィールドで、エクソーラウェブショップに関連付けられたウェブアプリを選択します。
4. パートナーフィールドで、広告ネットワークパートナーを選択します。

5. 必要に応じてランディングページパスを入力します（任意）。
6. キャンペーンの詳細を捕捉するためにUTMフィールドを更新します（任意）。
7. 「リンクを生成」をクリックします。

選択に基づいて、ウェブキャンペーン用の最終的な移動先URLが生成されます。このリンクにトラフィックを誘導し、ウェブキャンペーンに活用してください。

より詳細なキャンペーン追跡（粒度）を行うために、生成されたURLにマクロを追加することができます。マクロ追加ガイドを使用して、Singular Web SDK用のマクロパラメータを追加し、キャンペーンレベルのデータを取得できるようにしてください。リンク上の既存のパラメータを上書きしないように注意してください。

選択した特定の広告ネットワークに基づいて、説明が更新される場合があります。ウェブURLビルダーに表示される、広告ネットワーク固有の注意事項には必ず従ってください。

Singularでウェブ/ウェブショップイベントを追加する方法

1. Singularアカウントにログインします。
2. 設定 > イベントセクションに移動します。
3. Web SDKによって捕捉されたイベントを追加します：
   1. アプリ固有のイベントを選択します。
   2. アプリケーションを選択します。
   3. コホートイベントセクションで、レポートに表示させるイベント名を追加します。
   4. イベントのマッピング先フィールドで、SDKイベントを選択します。
   5. 保存をクリックします。

Singularでウェブショップ広告キャンペーンのパフォーマンスレポートを取得する方法

ウェブからウェブ、およびアプリ内からウェブへの広告キャンペーンのレポートを生成するには：

1. Singularアカウントにログインします。
2. 「インサイト > レポート」セクションに移動します。
3. フィルターを設定します：
   • 希望する日付範囲を設定します。
   • 分析したいアプリケーションを選択します。

4. データをセグメント化するためのディメンションを追加します：
   • ソース
   • キャンペーン名
   • 必要に応じたその他のディメンション

5. ウェブメトリクスを選択します：
   • ウェブの新規訪問者
   • ウェブの再エンゲージメント訪問者

6. コホートデータを含めます：
   • 収益
   • ROI
   • 設定 > イベントページで以前に設定したカスタムコホートイベント

7. 右上隅の「レポートを実行」をクリックします。

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

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

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

仕組み

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

  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イベントで渡されるパラメータに加えて、エクソーラは以下のデータを送信します：