Zum Testen ohne Einwilligung gibt es die Test-Modi in DZM Resources. Die früheren „Dev Mode“-Schalter der einzelnen Dienste sind entfallen.
Microsoft Clarity
Hier konfigurierst du die Anbindung an das Analyse-Tool Microsoft Clarity. Im Consent-Banner erscheint der Dienst Microsoft Clarity.boolean
Aktiviere diese Option, um Microsoft Clarity in deinem Shop zu verwenden.
string
Gib hier deine eindeutige Projekt-ID ein, die du in deinem Microsoft Clarity Dashboard findest.
boolean
Aktiviere diesen Schalter, wenn Clarity nicht im gesamten Shop, sondern ausschließlich im Bestellprozess lädt – Bestellvorgang, Bestellabschluss und Bestellstatus, damit auch der Kauf erfasst wird.
niu und den Checkout-Fortschritt mit dem Tag checkout_step.
Widerruft ein Besucher seine Einwilligung, meldet NIU Plus Clarity den Consent als verweigert und schickt keine Events mehr. Das bereits geladene Clarity-Script lässt sich nicht entladen – ob es bis zum nächsten Seitenaufruf gar nichts mehr erfasst, liegt bei Microsoft.
PostHog
Hier konfigurierst du die Anbindung an die Product-Analytics-Plattform PostHog (EU-Cloud). Im Consent-Banner erscheint der Dienst PostHog.boolean
Aktiviere diese Option, um die PostHog-Integration einzuschalten.
string
Trage hier den Project API Key deines PostHog-Projekts ein (beginnt mit
phc_).boolean
Aktiviere diesen Schalter, um PostHog ausschließlich im Bestellprozess zu laden – Bestellvorgang, Bestellabschluss und Bestellstatus.
add_to_cart). Seitenaufrufe erfasst PostHog selbst.
META Pixel
Hier verwaltest du die Einstellungen für das Meta (Facebook) Pixel. Im Consent-Banner erscheint der Dienst Meta Pixel.boolean
Aktiviere diesen Schalter, um das Meta Pixel für das Tracking von Besucheraktionen und Conversions einzubinden.
string
Gib hier deine Meta Pixel ID ein.
PageView, ViewContent, AddToCart, InitiateCheckout, Purchase und Search. Jedes Event trägt eine eindeutige eventID, damit Meta es mit der Conversions API abgleichen kann.
Käufe kannst du zusätzlich vom Server melden, siehe Meta Conversions API.
TikTok Pixel
Hier verwaltest du die Einstellungen für das TikTok Pixel. Im Consent-Banner erscheint der Dienst TikTok Pixel.boolean
Aktiviere diesen Schalter, um das TikTok Pixel einzubinden.
string
Gib hier deine TikTok Pixel ID ein, die du im TikTok Events Manager findest.
ViewContent, AddToCart, InitiateCheckout, CompletePayment und Search, jeweils mit eindeutiger event_id.
Käufe kannst du zusätzlich vom Server melden, siehe TikTok Events API.
Käufe vom Server melden
Meta und TikTok bekommen Käufe auf Wunsch zusätzlich direkt vom Server deines Shops – über die Meta Conversions API bzw. die TikTok Events API. So kommen auch Käufe an, die der Browser nicht übertragen kann, etwa wegen eines Adblockers, der Tracking-Einschränkungen von Safari oder weil der Käufer nach einer externen Zahlung nicht in den Shop zurückkehrt. Pixel und Server senden den Kauf mit derselben Event-ID. Meta und TikTok erkennen daran, dass es sich um denselben Kauf handelt, und zählen ihn nur einmal (Deduplizierung).Voraussetzungen
- Das Pixel ist aktiv: Der Server-Weg ergänzt das Pixel im Browser, er ersetzt es nicht. Die Schalter für den Server erscheinen erst, wenn „Meta Pixel verwenden“ bzw. „TikTok Pixel verwenden“ aktiv ist, und es muss eine Pixel ID eingetragen sein – Conversions API und Events API nutzen dieselbe ID. Fehlt die ID, zeigt das Backend einen Hinweis, und es wird nichts vom Server gesendet.
- Einwilligung des Käufers: Gesendet wird nur, wenn der Käufer bei der Bestellung dem Dienst Meta Pixel bzw. TikTok Pixel im Consent-Banner zugestimmt hatte. Mehr dazu unter Server-Side und Einwilligung.
- Cronjob von DZM Resources: Die Käufe werden stündlich über die Aufgabe „DZM Resources: Server-Side-Tracking senden“ verschickt. Sie wird bei der Installation bzw. beim Update von DZM Resources automatisch angelegt.
Meta Conversions API
1
Schalter aktivieren
Aktiviere im NIU-Plus-Backend unter Tracking in der Box Meta den Schalter „Käufe zusätzlich vom Server melden (Conversions API)“.
2
Zugriffstoken erzeugen
Öffne im Meta Events Manager dein Pixel und erzeuge unter Einstellungen → Conversions API über Zugriffstoken generieren ein Token.
3
Zugriffstoken speichern
Füge das Token im Feld „Zugriffstoken (Conversions API)“ ein und klicke direkt neben dem Feld auf Speichern. Das Feld speichert sofort, unabhängig vom Speichern-Button der Seite. Das Token wird verschlüsselt abgelegt und nie wieder angezeigt – das Feld zeigt danach nur noch den Zustand Gespeichert.
4
Mit Testcode prüfen
Kopiere im Events Manager unter Ereignisse testen den Testcode, trage ihn im Feld „Testcode“ ein und speichere. Löse eine Testbestellung aus. Nach dem nächsten Lauf des Cronjobs erscheint der Kauf in Ereignisse testen.
5
Testcode leeren
Leere das Feld „Testcode“ für den Livebetrieb und speichere. Solange ein Testcode eingetragen ist, erscheinen die Käufe nur unter „Ereignisse testen“.
boolean
Hauptschalter für die Meta Conversions API. Standard: aus.
string
Das Zugriffstoken aus dem Meta Events Manager. Angezeigt wird nur der Zustand: Nicht gesetzt, Gespeichert, Per Konstante gesetzt oder Nicht lesbar – bitte neu eintragen. Mit Entfernen löschst du das Token; danach werden keine Käufe mehr vom Server an Meta gemeldet.
string
Code aus „Ereignisse testen“ im Events Manager. Solange er eingetragen ist, erscheinen die Käufe nur dort. Für den Livebetrieb leeren.
boolean
Sendet zusätzlich E-Mail, Vor- und Nachname, Ort, PLZ und Land des Käufers – vorher mit SHA-256 gehasht, Klartext verlässt den Server nicht. Das verbessert die Zuordnung der Käufe, ist aber datenschutzrelevant: Ergänze deine Datenschutzerklärung. Standard: aus.
TikTok Events API
1
Schalter aktivieren
Aktiviere im NIU-Plus-Backend unter Tracking in der Box TikTok den Schalter „Käufe zusätzlich vom Server melden (Events API)“.
2
Zugriffstoken erzeugen
Öffne im TikTok Events Manager dein Pixel und erzeuge unter Einstellungen → Events API über Zugriffstoken generieren ein Token.
3
Zugriffstoken speichern
Füge das Token im Feld „Zugriffstoken (Events API)“ ein und klicke direkt neben dem Feld auf Speichern. Das Feld speichert sofort und zeigt danach nur noch den Zustand Gespeichert.
4
Mit Testcode prüfen
Kopiere im TikTok Events Manager unter Testereignisse den Testcode, trage ihn im Feld „Testcode“ ein und speichere. Löse eine Testbestellung aus. Nach dem nächsten Lauf des Cronjobs erscheint der Kauf unter „Testereignisse“.
5
Testcode leeren
Leere das Feld „Testcode“ für den Livebetrieb und speichere.
boolean
Hauptschalter für die TikTok Events API. Standard: aus.
string
Das Zugriffstoken aus dem TikTok Events Manager. Angezeigt wird nur der Zustand, wie bei Meta.
string
Code aus „Testereignisse“ im TikTok Events Manager. Solange er eingetragen ist, erscheinen die Käufe nur dort. Für den Livebetrieb leeren.
boolean
Sendet zusätzlich die E-Mail-Adresse des Käufers – vorher mit SHA-256 gehasht. Verbessert die Zuordnung, ist aber datenschutzrelevant: Ergänze deine Datenschutzerklärung. Standard: aus.
Was übertragen wird
Gemeldet wird nur der Kauf – bei Meta alsPurchase, bei TikTok als CompletePayment. Stornos gehen nicht an Meta und TikTok.
Zugangsdaten per Konstante
Statt die Zugriffstoken im Backend einzutragen, kannst du sie als Konstanten in derconfig.JTL-Shop.ini.php deines Shops hinterlegen. Eine Konstante hat Vorrang vor einem im Backend gespeicherten Wert, das Feld zeigt dann Per Konstante gesetzt.
config.JTL-Shop.ini.php