Настройка атрибуции платежей

Этот скрипт автоматически извлекает tracking_id из query-параметров в URL-адресе и сохраняет его в localStorage и предоставляет метод getTrackingId(), который используется при генерации платежного токена.

Добавьте следующий скрипт в HTML-код вашей целевой страницы:

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

Ниже приведен скрипт на JavaScript, который извлекает tracking_id из URL-адреса и сохраняет его в localStorage.

Скрипт на JavaScript для обработки tracking_id:

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

Если ваш магазин создан с помощью конструктора сайтов Xsolla, вам не требуется выполнять дополнительные действия — tracking_id обрабатывается автоматически: он извлекается из URL-адреса и добавляется в запрос на получение платежного токена.

Чтобы передать tracking_id в виджет покупки:

1. Получите tracking_id на стороне клиента (из URL-адреса или из localStorage).

2. Укажите его в параметре access_data.user.tracking_id.value при инициализации виджета:

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

Чтобы передать tracking_id в Pay Station Embed:

1. Получите tracking_id на стороне клиента (из URL-адреса или из localStorage).

2. Передайте следующий параметр при генерации платежного токена:

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

3. Используйте полученный платежный токен access_token для инициализации виджета:

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

Чтобы передать tracking_id при использовании Headless checkout:

1. Получите tracking_id на стороне клиента (из URL-адреса или из localStorage).

2. Укажите его в параметре user.tracking_id.value при генерации платежного токена.

3. Инициализируйте SDK с помощью метода headlessCheckout.init().

4. Передайте платежный токен для инициализированного SDK:

1await headlessCheckout.setToken('your_token_with_tracking_id');

Получение платежного токена на стороне клиента

Используйте этот способ, если вы генерируете платежный токен с помощью одного из следующих методов:

• Создание заказа со всеми товарами из текущей корзины

• Создание заказа со всеми товарами из определенной корзины

• Создание заказа с указанным товаром

Чтобы передать tracking_id при генерации платежного токена:

1. Получите tracking_id на стороне клиента (из URL-адреса или из localStorage).

2. Укажите его в параметре user.tracking_id.value в используемом методе.

Пример:

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

Получение платежного токена на стороне сервера

Используйте этот способ, если вы генерируете платежный токен с помощью метода Создание платежного токена для покупки.

Чтобы передать tracking_id при генерации платежного токена:

1. Получите tracking_id на стороне клиента (из URL-адреса или из localStorage).

2. Укажите его в параметре user.tracking_id.value в используемом методе.

Пример:

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

Чтобы передать tracking_id с использованием Xsolla SDK для Unity (legacy/enterprise):

1. Убедитесь, что используется актуальная версия SDK, поддерживающая параметр tracking_id.

2. Получите tracking_id на стороне клиента (например, используя диплинк).

3. Передайте его в объекте Xsolla.Core.PurchaseParams.

Пример:

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