配置支付归因

支付归因可帮助您识别是哪位内容创作者的链接引导了进行购买的用户。该用户的所有购买行为都将关联到对应创作者，确保基于推广活动成果准确计算创作者收益。

运行机制

要启用归因功能，请使用tracking_id参数。

tracking_id是一个将用户支付与流量来源（如广告活动）关联的唯一标识符。它主要用于：

追踪推广活动效果
确定引荐用户的创作者身份
在流量联盟中采集分析数据
正确计算奖励和收益分配

当用户点击内容创作者个人链接时，艾克索拉会自动生成tracking_id。用户访问链接后，系统会自动在URL中附加这个32字符的唯一标识符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可能会丢失。

我们推荐使用流量联盟跟踪脚本⸺它能自动将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的方式已被弃用。我们建议使用access_token，类似于Pay Station Embed的做法。

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，如购买小组件部分所示。

要对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对象（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

客户端侧支付令牌

服务器侧支付令牌