Establecer la atribución de pagos

La atribución de pagos le permite identificar qué creador de contenido ha referido a un usuario que ha realizado una compra. Todas las compras de ese usuario se atribuyen a dicho creador de contenido, lo que garantiza que reciba los pagos correspondientes a la campaña.

Cómo funciona

Para habilitar la atribución, use el parámetro tracking_id.

El tracking_id es un identificador único que se usa para:

• hacer un seguimiento del rendimiento de las campañas
• identificar qué creador ha referido al usuario
• recopilar datos analíticos en Partner Network
• calcular correctamente las recompensas y los pagos

Cuando un usuario sigue el enlace personal de un creador de contenido, Xsolla genera un tracking_id único de 32 caracteres y lo añade a la URL de la página de destino. El destino puede ser cualquier página relacionada con la venta de productos. Transmita el tracking_id generado en la solicitud para generar un token de pago. Una vez completada la transacción, el tracking_id se almacena junto con los datos de pago y se utiliza para la atribución, el análisis y los cálculos financieros.

Ejemplo de un enlace con el parámetro tracking_id: https://webshop-external-demo.xsolla.site/?tracking_id=abcdefghijklmnopqrstuvwxyz123456

Para transmitir el tracking_id al generar un token de pago:

1. Obtenga el tracking_id de los parámetros de consulta en la URL.
2. Guárdelo en el localStorage del navegador.
3. Incluya el tracking_id en la solicitud para generar el token de pago.

Obtener el tracking_id

Obtener el tracking_id en el lado del cliente depende de su tipo de integración. Puede implementar su propia lógica para extraer el tracking_id o usar el script de Partner Network proporcionado por Xsolla. La atribución de pagos funciona de la misma manera independientemente del tipo de páginas de venta, incluyendo escaparates, páginas de artículos individuales o claves de juego, y catálogos con varios juegos.

Este script extrae automáticamente el tracking_id de los parámetros de consulta de la URL y lo guarda en localStorage. Para recuperar el valor guardado, se proporciona el método getTrackingId(), que se llama al generar un token de pago.

En las siguientes pestañas encontrará ejemplos detallados de la implementación.

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

Independientemente de cómo lo integre (mediante el fragmento de JavaScript o el script de Partner Network), llame a XsollaPartnerNetwork.getTrackingId() para recuperar el tracking_id almacenado:

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

Transmitir tracking_id al generar el token de pago

Dependiendo de cómo haya configurado su integración, utilice una de las opciones siguientes para transmitir el tracking_id al método de generación de tokens.

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