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-129845Das 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.
| Argument | Pflicht | Beispielwerte | Beschreibung |
|---|---|---|---|
customerid | ✅ | 123456 | Fü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. |
language | ✅ | DE | Um das Tracking per URL zu ermöglichen, muss dieses Argument als leerer String übergeben werden (um z.B. eine config zu setzen). |
trackingCode | ✅ | ABC-123458795464 | Um das Tracking per URL zu ermöglichen, muss dieses Argument als leerer String übergeben werden (um z.B. eine config zu setzen). |
zipCode | ✅ | 12345 | Um das Tracking per URL zu ermöglichen, muss dieses Argument als leerer String übergeben werden (um z.B. eine config zu setzen). |
orderNumber | O-123AV15-NN | Um 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. |
Updated over 1 year ago
