Hematek Solutions
Support Projekt anfragen

Tracking · Plugin für JTL-Shop 5

Google Analytics 4 PRO Tracking

GA4-E-Commerce-Tracking für JTL-Shop 5 – mit Kategoriedaten, die bis zum Kauf erhalten bleiben.

  • E-Commerce-Events von view_item_list bis purchase
  • Kategorie-Anreicherung über bis zu fünf Ebenen
  • Consent-gesteuert über den JTL Consent Manager
Im JTL Extension Store ansehen (öffnet in neuem Tab) Frage zum Plugin

01 Problem & Lösung

Wofür es dieses Plugin gibt.

Das Problem

Viele GA4-Implementierungen im JTL-Shop verlieren unterwegs Informationen. Auf der Produktseite ist die Kategorie noch bekannt, im Warenkorb oder beim Kauf nicht mehr. Umlaute kommen als HTML-Entities an, einzelne Events fehlen oder sind kein gültiges JSON. Am Ende stehen Berichte, denen niemand traut.

Die Lösung

Das Plugin erfasst die E-Commerce-Events des Kaufprozesses und übergibt sie als valides JSON an gtag. Kategoriedaten werden beim Produktaufruf zwischengespeichert und in den Folge-Events ergänzt – bis zu fünf Ebenen, ohne vorhandene Werte zu überschreiben. Gesendet wird erst, wenn die Einwilligung über den JTL Consent Manager vorliegt.

02 Unterstützte Events

8 Events entlang der Customer Journey.

  1. view_item_list Produktlisten und Kategorieseiten
  2. view_item Produktdetailseite inklusive Kategoriepfad
  3. add_to_cart Artikel in den Warenkorb gelegt
  4. remove_from_cart Artikel aus dem Warenkorb entfernt
  5. begin_checkout Start des Bestellvorgangs
  6. add_shipping_info Versandart gewählt
  7. add_payment_info Zahlungsart gewählt
  8. purchase Bestellabschluss mit Transaktions-ID

Laut Produktbeschreibung erfasst das Plugin diese und weitere E-Commerce-Events.

03 Funktionen

Was das Plugin im Detail kann.

Datenerfassung

  • Hybride Erfassung über PHP-Variablen und DOM-Auswertung mit Fallbacks – auch für individuelle Templates
  • Keine invasiven Template-Änderungen erforderlich
  • Produkterkennung in Listenansichten über eigene JavaScript-Module

Datenqualität

  • Zentrale Encoding-Logik: UTF-8-Ausgabe, aufgelöste HTML-Entities, korrekte Umlaute
  • Valides JSON für gtag (JSON_THROW_ON_ERROR, ohne JSON_NUMERIC_CHECK)
  • Kategorie-Anreicherung aus Local Storage bzw. Item-Objekten, ohne bestehende Werte zu überschreiben

Einwilligung & Kontrolle

  • Events werden nur mit Einwilligung gesendet
  • Kompatibel mit dem JTL Consent Manager
  • Optionaler Debug-Modus mit ausführlichem Logging, kompatibel mit der GA4 DebugView

Einrichtung

  • Measurement ID und Debug-Modus im Plugin-Backend
  • Standard-Templates funktionieren direkt; stark angepasste Templates benötigen ggf. kleine Anpassungen

04 Anwendungsfälle

Wofür Händler es einsetzen.

  • Kategorien auswerten, die wirklich verkaufen

    Mit durchgängigen Kategoriedaten lassen sich Umsätze bis auf die fünfte Kategorie-Ebene zuordnen – nicht nur Produktaufrufe.

  • Checkout-Abbrüche lokalisieren

    Die Events von begin_checkout bis purchase zeigen, an welchem Schritt Kunden aussteigen: bei der Versandart, bei der Zahlung oder davor.

  • Kampagnen und Tests verlässlich messen

    Saubere Kauf-Conversions sind die Grundlage für Kampagnenauswertungen und A/B-Tests.

05 Technische Details

Voraussetzungen, Installation, Versionen.

Alles, was Sie vor dem Kauf und bei der Einrichtung wissen müssen.

Nutzungs- und Systemvoraussetzungen

Nutzung

  • GA4-Property mit gültiger Measurement ID (G-XXXXXXXXXX)
  • Admin-Zugang zum JTL-Shop
  • Zugriff auf die GA4 DebugView zur Prüfung
  • Empfohlen: Staging-Umgebung für den Ersttest

System

  • JTL-Shop 5.0.0 – 5.6.1
  • PHP 7.4 – 8.2 (laut Changelog Version 1.0.3)
  • PHP-Extension json; empfohlen: mbstring und intl
  • Optional, empfohlen: JTL Consent Manager
Installation und Einrichtung

  1. Im Extension Store buchen

    Plugin im JTL Extension Store auschecken – direkt oder über den Menüpunkt im Shop-Backend.

  2. Lizenz binden und installieren

    Im Backend unter Plugins › Meine Käufe die Lizenz an den Shop binden und das Plugin installieren.

  3. Measurement ID eintragen

    In den Plugin-Einstellungen die Measurement ID hinterlegen und für den Test den Debug-Modus aktivieren.

  4. Consent prüfen und testen

    Consent-Kategorie für GA4 prüfen, den Kaufprozess durchklicken und die Events in der DebugView kontrollieren. Danach den Debug-Modus wieder ausschalten.

Changelog

  1. v1.0.3

    • Hooks optimiert und angepasst für stabilere Abläufe

  2. v1.0.2

    • Kompatibel mit JTL-Shop 5.6.1

  3. v1.0.1

    • Kompatibel mit JTL-Shop 5.0.0 – 5.5.3

Quelle: Changelog im JTL Extension Store.

06 Häufige Fragen

Fragen zu Google Analytics 4 PRO Tracking

Ihre Frage ist nicht dabei? Fragen Sie uns direkt.

Werden Daten ohne Einwilligung an Google gesendet?

Nein. Das Plugin prüft die Einwilligung über den JTL Consent Manager und sendet Events erst, wenn sie vorliegt. Die Consent-Kategorie für GA4 muss dort aktiviert und konfiguriert sein.

Funktioniert das Plugin mit meinem individuellen Template?

Standard-Templates funktionieren direkt. Weil Daten sowohl über PHP-Variablen als auch über das DOM erfasst werden, arbeitet das Plugin auch mit vielen individuellen Templates. Bei stark angepassten Templates können kleine Anpassungen nötig sein – die übernehmen wir auf Wunsch als Dienstleistung.

Wie prüfe ich, ob das Tracking korrekt läuft?

Aktivieren Sie den Debug-Modus, öffnen Sie die GA4 DebugView und durchlaufen Sie Produkt-, Kategorie-, Warenkorb- und Checkout-Seiten. Prüfen Sie Werte wie item_name, price und transaction_id. Für den Livebetrieb schalten Sie den Debug-Modus wieder aus.

Brauche ich JTL-Wawi dafür?

Nein. Das Plugin hat keine Abhängigkeit zur JTL-Wawi.

Was umfasst der Support?

Support per E-Mail zu Installation, Konfiguration und grundlegender Fehlersuche. Individuelle Template-Anpassungen und Erweiterungen bieten wir separat an.

Mehr als ein Plugin nötig?

Wenn der Standardumfang nicht reicht, entwickeln wir weiter.

Zusätzliche Events, besondere Templates, mehrere Systeme: Im Bereich Tracking & Marketing-Technologie setzen wir individuelle Lösungen um – auf Wunsch aufbauend auf diesem Plugin.

Tracking & Marketing-Technologie Projekt anfragen

Weitere Plugins

Auch von Hematek.