Configurez l’attribution des paiements

L’attribution des paiements permet d’identifier le créateur de contenu à l’origine de la référence d’un utilisateur ayant effectué un achat. Tous les achats de cet utilisateur lui sont attribués, afin de garantir le versement correct des commissions de campagne.

Comment ça marche

Pour activer l’attribution, utilisez le paramètre tracking_id.

Le tracking_id est un identifiant unique utilisé pour :

• suivre la performance des campagnes
• identifier quel créateur a référé l’utilisateur
• collecter des analyses dans Partner Network
• calculer correctement les récompenses et les versements

Lorsqu’un utilisateur suit le lien personnel d’un créateur de contenu, Xsolla génère un tracking_id unique de 32 caractères et l’ajoute à l’URL de destination. Celle-ci peut être n’importe quelle page associée à la vente de produits. Incluez le tracking_id généré dans la requête de génération du jeton de paiement. Après la transaction, le tracking_id est stocké avec les données de paiement et utilisé pour l’attribution, les analyses et les calculs financiers.

Exemple de lien avec un paramètre tracking_id : https://webshop-external-demo.xsolla.site/?tracking_id=abcdefghijklmnopqrstuvwxyz123456

Pour transmettre le tracking_id lors de la génération d’un jeton de paiement :

1. Récupérez le tracking_id à partir des paramètres de requête dans l’URL.
2. Enregistrez-le dans le localStorage du navigateur.
3. Incluez le tracking_id dans la requête pour générer le jeton de paiement.

Obtention du tracking_id

La récupération du tracking_id côté client dépend de votre type d’intégration. Vous pouvez utiliser votre propre logique d’extraction du tracking_id ou le script Partner Network fourni par Xsolla. L’attribution des paiements fonctionne pour tous les types de pages de vente : vitrines, pages de produits individuels, pages de clés de jeu ou catalogues multi-jeux.

Ce script extrait automatiquement le tracking_id des paramètres de requête de l’URL et l’enregistre dans le localStorage. Pour récupérer la valeur enregistrée, la méthode getTrackingId() est fournie, qui est appelée lors de la génération d’un jeton de paiement.

Des exemples d’implémentation détaillés sont fournis dans les onglets ci-dessous.

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

Quel que soit le mode d’intégration, le snippet JavaScript ou le script Partner Network, appelez XsollaPartnerNetwork.getTrackingId() pour récupérer le tracking_id stocké :

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

Passez tracking_id lors de la génération du jeton de paiement

Selon votre configuration d’intégration, utilisez l’une des options ci-dessous pour transmettre le tracking_id lors de la génération du jeton.

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