Zahlungszuordnung einrichten

Mithilfe der Zahlungszuordnung können Sie feststellen, welcher Content-Creator einen Nutzer geworben hat, der einen Kauf getätigt hat. Alle von diesem Nutzer getätigten Käufe werden diesem Content-Creator zugeordnet, sodass er die korrekten Kampagnen-Auszahlungen erhält.

Funktionsweise

Um die Zuweisung zu aktivieren, verwenden Sie den Parameter tracking_id.

Die tracking_id ist eine eindeutige Kennung, die verwendet wird, um:

• die Performance von Kampagnen zu verfolgen
• zu ermitteln, welcher Creator den Nutzer geworben hat
• Analysedaten im Partner Network zu sammeln
• Vergütungen und Auszahlungen korrekt zu berechnen

Wenn ein Nutzer dem persönlichen Link eines Content-Creators folgt, generiert Xsolla eine eindeutige 32-stellige tracking_id und hängt sie an die URL der Zielseite an. Das Ziel kann jede Landing-Page sein, die mit dem Verkauf von Produkten verbunden ist. Übermitteln Sie die generierte tracking_id in der Anfrage zur Generierung eines Zahlungstokens. Nach Abschluss der Transaktion wird die tracking_id zusammen mit den Zahlungsdaten gespeichert und für die Zuweisung, Analysen und finanzielle Berechnungen verwendet.

Beispiel für einen Link mit dem Parameter tracking_id: https://webshop-external-demo.xsolla.site/?tracking_id=abcdefghijklmnopqrstuvwxyz123456

Um die tracking_id beim Generieren eines Zahlungstokens zu übermitteln:

1. Rufen Sie die tracking_id aus den Query-Parametern der URL ab.
2. Speichern Sie sie im localStorage des Browsers.
3. Fügen Sie die tracking_id in die Anfrage zur Generierung des Zahlungstokens ein.

tracking_id abrufen

Das Abrufen der tracking_id auf der Client-Seite hängt von Ihrem Integrationstyp ab. Sie können entweder Ihre eigene Logik zur Extraktion der tracking_id implementieren oder das von Xsolla bereitgestellte Partner Network Script verwenden. Die Zahlungszuordnung funktioniert unabhängig vom Typ der Verkaufsseiten gleich, einschließlich Storefronts, einzelnen Artikel- oder Spielschlüssel-Seiten und Multi-Game-Katalogen.

Dieses Script extrahiert automatisch die tracking_id aus den Query-Parametern der URL und speichert sie im localStorage. Um den gespeicherten Wert abzurufen, wird die Methode getTrackingId() bereitgestellt, die beim Generieren eines Zahlungstokens aufgerufen wird.

Detaillierte Implementierungsbeispiele finden Sie in den untenstehenden Registerkarten.

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

Unabhängig davon, wie Sie es integrieren — mit dem JavaScript-Snippet oder dem Partner Network Script — rufen Sie XsollaPartnerNetwork.getTrackingId() auf, um die gespeicherten tracking_id abzurufen:

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

tracking_id beim Generieren des Zahlungstokens übermitteln

Je nachdem, wie Sie Ihre Integration eingerichtet haben, verwenden Sie eine der folgenden Optionen, um die tracking_id an die Token-Generierungsmethode zu übermitteln.

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