支払いのアトリビューションを設定する

決済アトリビューションを使用すると、購入を行ったユーザーをどのコンテンツクリエイターが紹介したかを特定できます。そのユーザーによるすべての購入が該当のコンテンツクリエイターに帰属し、正しいキャンペーン報酬を確実に受け取れるようになります。

購入がクリエイターストアフロントまたはエクソーラサイトビルダーで作成されたページを通じて行われた場合、追加の決済アトリビューション設定は不要で、自動的に機能します。カスタムストアフロントを使用している場合は、以下の説明に従ってください。

仕組み

アトリビューションを有効にするには、tracking_idパラメータを使用します。

tracking_idは、以下の目的で使用される一意の識別子です：

キャンペーンのパフォーマンスを追跡する
どのクリエイターがユーザーを紹介したかを特定する
パートナーネットワークで分析を収集する
報酬とペイアウトを正確に計算する

ユーザーがコンテンツクリエイターの専用リンクをたどると、エクソーラは一意の32文字のtracking_idを生成し、目的のページのURの末尾にこれを追加します。目的先は、製品の販売に関連する任意のランディングページに設定できます。生成されたtracking_idを決済トークンを生成するリクエストに渡します。トランザクションが完了すると、tracking_idは決済データと共に保存され、アトリビューション、アナリティクス、および財務計算に使用されます。

tracking_idパラメータを含むリンクの例：https://webshop-external-demo.xsolla.site/?tracking_id=abcdefghijklmnopqrstuvwxyz123456

tracking_idがない場合、支払いはトラフィックソースに帰属できません。このような支払いはパフォーマンスレポートに含まれず、クリエイターへのペイアウト計算には考慮されません。

tracking_idを決済トークン生成時に渡すには：

tracking_idの取得

クライアント側でのtracking_idの取得は、統合タイプに依存します。独自のロジックを実装してtracking_idを抽出するか、エクソーラが提供するパートナーネットワークスクリプトを使用できます。決済アトリビューションは、ストアフロント、個別アイテムやゲームキーのページ、複数ゲームのカタログなど、販売ページのタイプに関係なく同様に機能します。

スクリプトは、URLを変更する他のJavaScriptよりも前に実行されることを確認してください。そうしないと、tracking_idが失われる可能性があります。

このスクリプトは、URLのクエリパラメーターから tracking_id を自動的に抽出し、localStorage に保存します。保存された値を取得するために、決済トークンの生成時に呼び出される getTrackingId() メソッドが提供されます。

詳細な実装例は、以下のタブに示されています。

このスクリプトは、URLのクエリパラメータからtracking_idを自動的に抽出し、localStorageに保存し、決済トークン生成時に使用するgetTrackingId()メソッドを提供します。

以下のスクリプトをランディングページのHTMLに追加します：

Copy

Full screen

Small screen

1<script src="https://cdn.xsolla.net/xpn-bucket-prod/xpn-script/xpn@latest/xpn.min.js"></script>

スクリプトは、決済トークンが生成される可能性のあるすべてのページで読み込まれる必要があります。

以下のスニペットは、URLからtracking_idを抽出し、localStorageに保存します。

tracking_id処理用のJavaScriptスニペット：

Copy

Full screen

Small screen

 1(function () {
 2  const XPN_TRACKING_ID = 'xsolla_partner_network_tracking_id';
 3  const TRACKING_ID = 'tracking_id';
 4
 5  function removeTrackingIdFromUrl() {
 6    if (window.history && window.history.replaceState) {
 7      const url = new URL(window.location.href);
 8      url.searchParams.delete(TRACKING_ID);
 9      window.history.replaceState(null, '', url.toString());
10    }
11  }
12
13  function extractTrackingIdFromURL() {
14    try {
15      const savedTrackingId = localStorage.getItem(XPN_TRACKING_ID);
16      const searchParams = new URLSearchParams(window.location.search);
17      const trackingId = searchParams.get(TRACKING_ID) || savedTrackingId || '';
18      if (trackingId !== '') {
19        localStorage.setItem(XPN_TRACKING_ID, trackingId);
20      }
21      removeTrackingIdFromUrl();
22    } catch (e) {
23      console.error('[Xsolla Partner Network] Failed to extract tracking_id:', e);
24    }
25  }
26
27  function getTrackingId() {
28    return localStorage.getItem(XPN_TRACKING_ID) || null;
29  }
30
31  extractTrackingIdFromURL();
32  window.XsollaPartnerNetwork = window.XsollaPartnerNetwork || {};
33  window.XsollaPartnerNetwork.getTrackingId = getTrackingId;
34})();

JavaScriptスニペットまたはパートナーネットワークスクリプトのどちらを使用して統合するかに関係なく、XsollaPartnerNetwork.getTrackingId()を呼び出して保存されたtracking_idを取得します：

Copy

Full screen

Small screen

1const trackingId = XsollaPartnerNetwork.getTrackingId();
2if (trackingId) {
3  console.log('Saved tracking_id from URL:', trackingId);
4  // add tracking_id into your request parameters
5}

決済トークン生成時にtracking_idを渡す

統合の設定方法に応じて、以下のオプションのいずれかを使用してtracking_idをトークン生成メソッドに渡します。

正確なアトリビューションを確保するために、tracking_idがトークンリクエストに含まれていることを確認してください。

購入ウィジェットにtracking_idを渡すには：

クライアント側でtracking_idを取得します（URLまたはlocalStorageから）。
ウィジェット初期化時にaccess_data.user.tracking_id.valueパラメータに追加します：

Copy

Full screen

Small screen

1{
2 access_data: {
3  user: {
4    tracking_id: {
5      value: "abcdefghijklmnopqrstuvwxyz123456"
6    }
7  }
8}
9}

tracking_idはウィジェット初期化パラメータとして渡すことはできません。代わりに、トークンのパラメータuser.tracking_id.valueに含める必要があります。

Pay Station Embedにtracking_idを渡すには：

クライアント側でtracking_idを取得します（URLまたはlocalStorageから）。
決済トークン生成時にこのパラメータを渡します：

Copy

Full screen

Small screen

1{
2  "user": {
3    "tracking_id": {
4      "value": "abcdefghijklmnopqrstuvwxyz123456"
5    }
6  }
7}

access_tokenを使用してウィジェットを初期化します：

Copy

Full screen

Small screen

1XPayStationWidget.init({
2  access_token: 'your_token_with_tracking_id'
3});

access_dataの代わりにaccess_tokenを使用することは非推奨です。統合がaccess_tokenをサポートしていない場合は、購入ウィジェットで示されているように、access_data.user.tracking_id.valueパラメータにtracking_idを渡します。

ヘッドレスチェックアウトでtracking_idを渡すには：

クライアント側でtracking_idを取得します（URLまたはlocalStorageから）。
決済トークン生成時にuser.tracking_id.valueパラメータに追加します。
headlessCheckout.init()メソッドを使用してSDKを初期化します。
以下を使用してトークンを渡します：

Copy

Full screen

Small screen

1await headlessCheckout.setToken('your_token_with_tracking_id');

クライアント側での決済トークン

以下のAPIコールのいずれかを介して決済トークンを生成する場合、このオプションを使用します：

決済トークン生成時にtracking_idを渡すには：

クライアント側でtracking_idを取得します（URLまたはlocalStorageから）。
user.tracking_id.valueパラメータに追加します。

例：

Copy

Full screen

Small screen

1{
2  "user": {
3    "tracking_id": {
4      "value": "abcdefghijklmnopqrstuvwxyz123456"
5    }
6  }
7}

このオプションはクライアント側のみです。国と通貨はユーザーのIPアドレスによって決定されます。

サーバー側での決済トークン

購入用決済トークンを作成するAPIコールを介して決済トークンを生成する場合、このオプションを使用します。

決済トークン生成時にtracking_idを渡すには：

クライアント側でtracking_idを取得します（URLまたはlocalStorageから）。
user.tracking_id.valueパラメータに追加します。

例：

Copy

Full screen

Small screen

1{
2  "user": {
3    "tracking_id": {
4      "value": "abcdefghijklmnopqrstuvwxyz123456"
5    }
6  }
7}

Unity向けのエクソーラSDK（レガシー/エンタープライズ）を使用してtracking_idを渡すには：

tracking_idをサポートする最新のSDKバージョンを使用していることを確認します。
クライアント側でtracking_idを取得します（例：ディープリンク経由）。
Xsolla.Core.PurchaseParamsオブジェクトに渡します。

例：

Copy

Full screen

Small screen

1var purchaseParams = new PurchaseParams {
2  tracking_id = "abcdefghijklmnopqrstuvwxyz123456"
3};

ご意見ありがとうございました！

あなたのメッセージを確認し、体験を向上させるために利用させていただきます。

最終更新日: 2026年7月17日

誤字脱字などのテキストエラーを見つけましたか？テキストを選択し、Ctrl+Enterを押します。

内容

仕組み
tracking_idの取得
決済トークン生成時にtracking_idを渡す