Snippet

Um unser Snippet nutzen zu können, wähle zunächst eine Seite in eurem Shop aus auf dem eure Sendungsverfolgung angezeigt werden soll. Natürlich könnt ihr auch eine neue Seite erstellen und diese mit weiteren Inhalten um das Snippet herum füllen. Im weiteren Verlauf gehen wir der Einfachheit halber davon aus, dass unser Snippet auf einer Seite installiert wird, die über https://dein-shop.tld/sendungsverfolgung erreichbar ist.

Nachdem jetzt klar ist, auf welcher Seite die Sendungsverfolgung angezeigt werden soll, kann zwischen zwei verschiedenen Arten der Einbindung gewählt werden.

Snippet mit GET Parameter nutzen

Die Nutzung per GET Parameter bedeutet, dass ihr ein minimales Snippet einbindet und die Informationen zur Sendung in der URL euer Seite mit der Sendungsverfolgung als so genannter GET Parameter übergeben werden. Der Name des GET Parameters ist festgelegt und lautet tracking-code.

Eure Sendungsverfolgung muss dann folgendermaßen aufgerufen werden:

https://dein-shop.tld/sendungsverfolgung?tracking-code=DE~0034123456221582~40237~ORD-129845

Das Snippet sieht folgendermaßen aus:

<div id="pqt-tracking"></div>
<script src="https://tracking.paqato.com/scripts/pqt-tracking.min.js"></script>
<script>pqtTracking(<customer id>)</script>

Die für das Abholen der Daten notwendige customer id kann, sofern sie nicht bereits bekannt ist, über den Kundenservice bezogen werden. Um dir die Sache einfacher zu machen findest du eine Einsatzbereite Version dieses Snippets in der PAQATO WebApp.

Snippet mit Variablen nutzen

Die Nutzung mit Variablen ermöglicht es unser Snippet auch ohne den tracking-code GET Parameter zu nutzen. Das ist beispielweise sinnvoll, wenn das Snippet auf der Detailseite einer Bestellung eingebunden werden soll, auf der ohnehin schon alle Parameter zur Verfügung stehen oder wenn du eigene Tracking Parameter in der URL nutzen möchtest. In diesem Fall hast Du die volle Kontrolle darüber, wie deine URL aussieht.

<div id="pqt-tracking"></div>
<script src="https://tracking.paqato.com/scripts/pqt-tracking.min.js"></script>
<script>pqtTracking(<customer id>, <language>,<tracking code>, <zip code> )</script>

Konfiguration

In der WebApp

In TRAQ kannst du die gewünschte Farbauswahl für dein Snippet konfigurieren. Hierfür kannst du pro Shop individuell eine Primärfarbe, Erfolgs- und Fehlerfarbe wählen. Kopiere nach dem Speichern das Snippet und füge es an der beliebigen Stelle auf deiner Trackingseite ein.

Per Variable im Snippet

Die Nutzung des Snippets per direktem Aufruf erfordert etwas mehr Konfiguration als die Nutzung per GET Parameter. Die im anderen Fall per URL angegebenen Daten müssen hier direkt an die Funktion pqtTracking() übergeben werden. Der Vollständigkeit halber sind in der nachfolgenden Tabelle alle Argumente angegeben, die beim Funktionsaufruf mit übergeben werden können.

ArgumentPflichtBeispielwerteBeschreibung
customerid123456Für die Nutzung der Tracking-Seite, des IFrames oder des Snippets wird für jeden Kunden eine unique ID generiert. Diese muss zwingend als erstes Argument angegeben werden und ist bei jedem Aufruf identisch.
languageDEUm das Tracking per URL zu ermöglichen, muss dieses Argument als leerer String übergeben werden (um z.B. eine config zu setzen).
trackingCodeABC-123458795464Um das Tracking per URL zu ermöglichen, muss dieses Argument als leerer String übergeben werden (um z.B. eine config zu setzen).
zipCode12345Um das Tracking per URL zu ermöglichen, muss dieses Argument als leerer String übergeben werden (um z.B. eine config zu setzen).
orderNumberO-123AV15-NNUm das Tracking per URL zu ermöglichen, muss dieses Argument als leerer String übergeben werden (um z.B. eine config zu setzen).
config{ "primaryColor": "#123456", "successColor": "#123456", "errorColor": "#123456", "mainTitle": "Titel" }Über ein JSON Objekt können verschiedene Einstellungen vorgenommen werden. Diese betreffen hauptsächlich die Farben der Inhalte sowie den Titel der Seite. Setzt man die Einstellung mainTitle auf null wird kein Titel ausgegeben. Das ermöglicht es den vielleicht schon vorhandenen Seitentitel weiterhin zu nutzen.

What’s Next

Did this page help you?