Set up payment attribution

Payment attribution lets you identify which content creator referred a user who made a purchase. All purchases made by that user are attributed to that content creator, ensuring they receive the correct campaign payouts.

How it works

To enable attribution, use the tracking_id parameter.

The tracking_id is a unique identifier that is used to:

• track the performance of campaigns
• identify which creator referred the user
• collect analytics in Partner Network
• correctly calculate rewards and payouts

When a user follows a content creator’s personal link, Xsolla generates a unique 32-character tracking_id and appends it to the URL of the destination page. The destination can be any landing page associated with selling products. Pass the generated tracking_id in the request to generate a payment token. After the transaction is completed, the tracking_id is stored with the payment data and is used for attribution, analytics, and financial calculations.

Example of a link with a tracking_id parameter: https://webshop-external-demo.xsolla.site/?tracking_id=abcdefghijklmnopqrstuvwxyz123456

To pass tracking_id when generating a payment token:

1. Get the tracking_id from the query parameters in the URL.
2. Save it to the browser’s localStorage.
3. Include tracking_id in the request to generate the payment token.

Get tracking_id

Retrieving the tracking_id on the client side depends on your integration type. You can either implement your own logic to extract the tracking_id or use the Partner Network script provided by Xsolla. Payment attribution works the same regardless of the type of sales pages, including storefronts, individual items or game key pages, and multi-game catalogs.

This script automatically extracts tracking_id from the URL’s query parameters and saves it to localStorage. To retrieve the stored value, the getTrackingId() method is provided, which is called when generating a payment token.

Detailed implementation examples are provided in the tabs below.

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

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

Regardless of how you integrate it — using the JavaScript snippet or the Partner Network script — call XsollaPartnerNetwork.getTrackingId() to retrieve the stored tracking_id:

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

Pass tracking_id when generating payment token

Depending on how you set up your integration, use one of the options below to pass the tracking_id to the token generation method.

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

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

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

1await headlessCheckout.setToken('your_token_with_tracking_id');

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

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

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