Einführung
Das client-seitige Baskettracking ermöglicht die Übergabe von Warenkorbdaten direkt aus dem Shop-Frontend an das Tracking-System von easy.MARKETING.
Dabei werden die einzelnen Artikel per JavaScript an das Skript übergeben und anschließend gesammelt übertragen.
Funktionsweise (Client)
- Beim Aufruf der Bestellabschlussseite wird das Tracking-Skript eingebunden.
- Für jedes Produkt im Warenkorb wird
eamTrckAddBasketItem(...)mit den entsprechenden Parametern aufgerufen. - Mit
eamTrckSubmitBasket()werden alle Artikel an das Tracking-System übermittelt. - Die EMID wird beim Klick auf ein Werbemittel erzeugt und muss unbedingt mit übergeben werden, um die Customer Journey korrekt zu attribuieren.
Implementierung
1) Skript einbinden
Das Skript muss auf der Bestellabschlussseite im <body> eingebunden werden:
<script src="https://SUB-DOMAIN/trck/ebasket/ebasket.js"></script>
Hinweis:
SUB-DOMAINdurch die eigene Subdomain ersetzen.
2) Basket-Items übergeben & absenden
Für jeden Artikel im Warenkorb wird eamTrckAddBasketItem() aufgerufen.
Am Ende wird einmal eamTrckSubmitBasket() ausgeführt.
<script>
/* Artikel ins Tracking übergeben */
eamTrckAddBasketItem(
'CAMPAIGN_ID', // z. B. '1'
'TOKEN', // Bestellnummer, z. B. '12345'
'TRIGGER_ID', // z. B. '1'
'ARTICLE_NUMBER', // z. B. '002973000902'
'AMOUNT', // Menge, z. B. '1'
'PRICE', // Netto-Preis als String mit Punkt, z. B. '335.29'
'EMID', // z. B. '5eeb0e0dabf7ad282b28c4a2'
'PRODUCTNAME', // z. B. 'Samsung Fernseher'
'CATEGORY', // z. B. 'Unterhaltungselektronik'
{ // optionale Zusatzparameter (Key-Value-Strings)
'variable' : 'VARIABLENINHALT',
'variable_2' : 'VARIABLENINHALT_2'
}
);
/* Gesamten Warenkorb absenden */
eamTrckSubmitBasket();
</script>
3) Vollständiges Beispiel (2 Artikel)
<script src="https://pvn.beispiel.de/trck/ebasket/ebasket.js"></script>
<script>
eamTrckAddBasketItem(
'1', '12345', '1',
'002973000902', '1', '335.29',
'5eeb0e0dabf7ad282b28c4a2',
'Samsung Fernseher', 'Unterhaltungselektronik',
{ 'vc': 'Gutscheincode12345', 'Farbe': 'Hellgrau' }
);
eamTrckAddBasketItem(
'1', '12345', '1',
'000657001803', '1', '25.13',
'5eeb0e0dabf7ad282b28c4a2',
'TV-WANDHALTER', 'Wohnzimmer',
{ 'vc': 'Gutscheincode12345', 'Farbe': 'Schwarz', 'Unterkategorie': 'TV Halterung' }
);
eamTrckSubmitBasket();
</script>
Variablenbeschreibung
| Parameter | Beschreibung |
|---|---|
| CAMPAIGN_ID | ID der Kampagne, z. B. '1'. |
| TOKEN | Eindeutige Bestellnummer / Order ID. |
| TRIGGER_ID | ID des Triggers, z. B. '1'. |
| ARTICLE_NUMBER | Artikelnummer / SKU. |
| AMOUNT | Menge als String, z. B. '1'. |
| PRICE | Netto-Preis pro Stück, mit Punkt als Dezimaltrennzeichen, z. B. '25.13'. |
| EMID | Eindeutige Tracking-ID aus dem Werbemittelklick. |
| PRODUCTNAME | Produktname als String. |
| CATEGORY | Produktkategorie, z. B. 'Unterhaltungselektronik'. |
| Additional | Optionale Parameter als Key-Value-Paare, z. B. { 'vc': 'Gutschein12345' }. |
Additional Parameter
Weitere Parameter können flexibel als Key-Value-Strings übergeben werden:
{ 'vc': 'Gutschein12345', 'Brand': 'Samsung', 'Farbe': 'Hellgrau' }
Attribution: Prozentwerte als Dezimalzahl mit Punkt übergeben, z. B.
0.50für 50 %.
Hinweise zur Platzierung & Validierung
- Seite: Bestellabschlussseite / Thank-You-Page.
- Position: Innerhalb des
<body>. - Reihenfolge: Erst alle
eamTrckAddBasketItem(...)Aufrufe, dann einmaleamTrckSubmitBasket(). - Preise: Netto, mit Punkt als Dezimaltrennzeichen.
- EMID: Muss zwingend übergeben werden, sonst keine Attribution.
- Mehrere Artikel: Pro Artikel ein eigener
eamTrckAddBasketItem()Aufruf. - Debug-Tipp: In der Browser-Konsole prüfen, ob Fehler beim Laden des Skripts oder beim Funktionsaufruf auftreten.