Das folgende Schnipsel extrahiert die tracking_id aus der URL und speichert sie im localStorage. Verwenden Sie diesen Code, wenn Sie nicht vorhaben, das Tracking-Skript aus dem Partner Network zu verwenden.

Schnipsel für die Verarbeitung der 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})();

Dieses Skript extrahiert automatisch die tracking_id aus den Abfrageparametern der URL, speichert sie im localStorage und stellt die Methode getTrackingId() für die Generierung eines Zahlungstokens bereit.

Fügen Sie das folgende Skript in den HTML-Code Ihres Web Shops ein:

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

Beispiel:

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

Haben Sie Ihren Shop mit Site Builder erstellt, sind keine weiteren Maßnahmen erforderlich – die tracking_id wird automatisch verarbeitet. Sie wird aus der URL extrahiert und in der Tokenanfrage ergänzt.

So übermitteln Sie die tracking_id an das Kauf-Widget:

1. Rufen Sie die tracking_id clientseitig ab (z. B. aus der URL oder dem localStorage).

2. Fügen Sie die ID während der Widget-Initialisierung dem Parameter access_data.user.tracking_id.value hinzu.

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

So übermitteln Sie die tracking_id an Pay Station Embed:

1. Rufen Sie die tracking_id clientseitig ab (z. B. aus der URL oder dem localStorage).

2. Übermitteln Sie den Parameter beim Generieren des Zahlungstokens:

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

3. Nutzen Sie den access_token, um das Widget zu initialisieren:

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

So übermitteln Sie die tracking_id beim Headless Checkout:

1. Rufen Sie die tracking_id clientseitig ab (z. B. aus der URL oder dem localStorage).

2. Fügen Sie die ID beim Generieren des Zahlungstokens dem Parameter user.tracking_id.value hinzu.

3. Initialisieren Sie das SDK mithilfe der Methode headlessCheckout.init().

4. Übermitteln Sie den Token mithilfe von:

1await headlessCheckout.setToken('your_token_with_tracking_id');

Clientseitger Zahlungstoken

Verwenden Sie diese Option, wenn Sie den Zahlungstoken über einen der folgenden API-Aufrufe generieren:

• Bestellung mit allen Artikeln aus dem aktuellen Warenkorb anlegen

• Bestellung mit allen Artikeln aus einem angegebenen Warenkorb anlegen

• Bestellung mit angegebenem Artikel anlegen

So übermitteln Sie die tracking_id beim Generieren des Zahlungstokens:

1. Rufen Sie die tracking_id clientseitig ab (z. B. aus der URL oder dem localStorage).

2. Fügen Sie die ID dem Parameter user.tracking_id.value hinzu.

Beispiel:

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

Serverseitiger Zahlungstoken

Verwenden Sie diese Option, wenn Sie den Zahlungstoken über den API-Aufruf Zahlungstoken für den Kauf erstellen generieren.

So übermitteln Sie die tracking_id beim Generieren des Zahlungstokens:

1. Rufen Sie die tracking_id clientseitig ab (z. B. aus der URL oder dem localStorage).

2. Fügen Sie die ID dem Parameter user.tracking_id.value hinzu.

Beispiel:

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

So übermitteln Sie die tracking_id mithilfe des SDK für Unity:

1. Achten Sie darauf, eine aktuelle Version des SDK zu verwenden, die die tracking_id unterstützt.

2. Rufen Sie die tracking_id clientseitig ab (z. B. über einen Deep Link).

3. Übermitteln Sie die ID an das Objekt Xsolla.Core.PurchaseParams (SDK für Unity).

Beispiel:

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