支払いの属性を設定する

支払いの属性を設定することで、どのコンテンツクリエイターのリンク経由で購入が行われたかを特定できます。そのユーザーによるすべての購入がクリエイターに紐づけられるため、キャンペーンの結果に基づいた正確なペイアウトを支払うことが可能になります。

どのように動作するか

属性を有効にするには、tracking_idパラメータを使用します。

tracking_idは、ユーザーの支払いをトラフィック元（例：広告キャンペーン）に紐づけるためのユニークな識別子です。これは以下の目的で使用されます：

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

tracking_idは、ユーザーがコンテンツクリエイターの個人リンクをクリックした際にエクソーラによって生成されます。ユーザーがこのリンクにアクセスすると、エクソーラは一意の32文字の識別子であるtracking_idエクソーラパラメータをURLに付加します。このリンクは、キャンペーンに応じて、ウェブショップのメインページ、特定のアイテム、またはプロモーションを指している場合があります。決済トークンを生成するリクエストには、必ず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が失われる可能性があります。

パートナーネットワークトラッキングスクリプトの使用をお勧めします。これにより、tracking_idが自動的にlocalStorageに保存され、getTrackingId()メソッドにアクセスできるようになります。

以下のタブに詳細な実装例が記載されています。

日本語翻訳案以下のスニペットは、URLからtracking_idを抽出し、localStorageに保存します。パートナーネットワークトラッキングスクリプトを使用しない場合は、このコードをご利用ください。

tracking_id処理スニペット：

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})();

このスクリプトは、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>

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

例：

Copy

Full screen

Small screen

1const trackingId = XsollaPartnerNetworkSDK.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}

access_dataを経由でtracking_idを渡す方法は非推奨です。Pay Station Embedと同様にaccess_tokenの使用をお勧めします。

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_tokenの代わりにaccess_dataを使用する方法は非推奨です。お使いの連携方法が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オブジェクトに渡します（Unity向けのSDK）。

例：

Copy

Full screen

Small screen

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

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

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

最終更新日: 2025年9月23日

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

内容

どのように動作するか
tracking_idを取得する
決済トークンを生成する時にtracking_idを渡す
クライアント側での決済トークン
サーバー側での決済トークン

Your browser is not supported. Please try a different browser

支払いの属性を設定する

どのように動作するか

tracking_idを取得する

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

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

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