配置支付归因

支付归因可帮助您识别推荐购买用户的内容创作者。该用户产生的所有购买都会归因于对应的内容创作者，以确保其获得正确的活动分成。

如果购买是通过创作者店铺页面或使用艾克索拉建站器则无需额外设置支付归因，该功能会自动生效。如果您使用的是自定义商店前端，请按照以下说明操作。

工作原理

如需启用归因，请使用tracking_id参数。

tracking_id是一个唯一标识符，可用于：

跟踪活动效果
识别推荐该用户的创作者
在网红推广中收集分析数据
正确计算奖励和分成

当用户点击内容创作者的个人链接时，艾克索拉会生成一个唯一的32位tracking_id，并将其附加到目标页面的URL中。目标页面可以是任何与商品销售相关的落地页。请在生成支付令牌的请求中传入生成的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的逻辑，或使用艾克索拉提供的网红推广脚本。无论销售页面类型如何（包括商店主页、单个商品页面、游戏Key页面和多游戏商品目录），支付归因的工作方式均相同。

请确保该脚本先于任何会修改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中。

如需将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，如购买小组件中所示。

如需通过Headless checkout传递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