Configure a atribuição de pagamento

A atribuição de pagamentos permite identificar qual criador de conteúdo indicou um usuário que fez uma compra. Todas as compras feitas por esse usuário são atribuídas a esse criador de conteúdo, garantindo que ele receba os pagamentos corretos da campanha.

Como funciona

Para habilitar a atribuição, use o parâmetro tracking_id.

O tracking_id é um identificador único usado para:

• rastrear o desempenho das campanhas
• identificar qual criador indicou o usuário
• coletar análises na Partner Network
• calcular corretamente as recompensas e os pagamentos

Quando um usuário segue o link pessoal de um criador de conteúdo, a Xsolla gera um tracking_id único de 32 caracteres e o adiciona ao URL da página de destino. O destino pode ser qualquer página de destino associada à venda de produtos. Passe o tracking_id gerado na solicitação para gerar um token de pagamento. Após a conclusão da transação, o tracking_id é armazenado junto com os dados de pagamento e é usado para atribuição, análises e cálculos financeiros.

Exemplo de um link com o parâmetro tracking_id: https://webshop-external-demo.xsolla.site/?tracking_id=abcdefghijklmnopqrstuvwxyz123456

Para passar o tracking_id ao gerar um token de pagamento:

1. Obtenha o tracking_id a partir dos parâmetros de consulta no URL.
2. Salve-o no localStorage do navegador.
3. Inclua o tracking_id na solicitação para gerar o token de pagamento.

Obter o tracking_id

Obter o tracking_id no lado do cliente depende do seu tipo de integração. Você pode implementar sua própria lógica para extrair o tracking_id ou usar o script da Partner Network fornecido pela Xsolla. A atribuição de pagamentos funciona da mesma forma, independentemente do tipo de páginas de venda, incluindo vitrines, páginas de itens individuais ou chaves de jogo, e catálogos multijogo.

Este script extrai automaticamente o tracking_id dos parâmetros de consulta da URL e o salva no localStorage. Para recuperar o valor salvo, é fornecido o método getTrackingId(), que é chamado ao gerar um token de pagamento.

Exemplos detalhados de implementação são fornecidos nas abas abaixo.

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

Independentemente de como você o integra — usando o snippet de JavaScript ou o script da Partner Network — chame XsollaPartnerNetwork.getTrackingId() para recuperar o tracking_id armazenado:

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

Passe o tracking_id ao gerar o token de pagamento

Dependendo de como você configurou sua integração, use uma das opções abaixo para passar o tracking_id para o método de geração de token.

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