Dieses Plugin ermöglicht eine zuverlässige, datenschutzkonforme Integration von Google Analytics 4 in JTL-Shop und liefert vollständige E-Commerce-Metriken ohne Template-Änderungen.
Kurzüberblick
- Vollständiges E-Commerce-Tracking: unterstützt Events wie
view_item, view_item_list, add_to_cart, remove_from_cart, begin_checkout, add_shipping_info, add_payment_info, purchase und weitere.
- Consent-Manager-Integration: Events werden nur bei erteilter Zustimmung gesendet (kompatibel mit dem JTL Consent Manager).
- Robust gegenüber Custom-Templates: hybride Erfassung per PHP-Variablen und DOM-Parsing, inklusive Fallbacks.
- Sauberer Zeichensatzfluss: zentrale Encoding-Hilfsfunktionen sorgen für UTF-8, dekodieren HTML-Entities und erzeugen valides JSON (
JSON_THROW_ON_ERROR, ohne JSON_NUMERIC_CHECK).
- Kategorieanreicherung: versucht fehlende Kategorien aus lokalem Storage oder Artikelobjekten zu ergänzen, ohne bestehende Werte zu überschreiben.
- Debug-Support: optionaler Debug-Modus mit ausführlichem Logging und DebugViewer-Kompatibilität zur Fehleranalyse.
Technische Merkmale
- Keine invasiven Template-Änderungen erforderlich.
- Zentrale Encoding-Utility (
Encoding) verwendet in allen Event-Handlern.
- JavaScript-Module für DOM-basierte Produkterkennung bei Listenansichten.
- Events werden als wohlgeformtes JSON an
gtag übergeben.
- Konfigurierbar: Measurement ID und Debug-Modus über das Admin-Interface.
Was Händler davon haben
- Verlässliche Conversion-Messung (inkl.
purchase) für A/B-Tests und Optimierungen.
- Fehlerfreie Umlaute und Sonderzeichen in Analytics-Daten.
- Datenschutzkonforme Datenübermittlung dank Consent-Prüfung.
Ihre Vorteile
- Saubere, verlässliche Conversion‑Messung für datenbasierte Entscheidungen
- Keine falschen oder kaputten Umlaute dank zentralem UTF‑8‑Handling
- Datenschutzkonform durch Consent‑Manager‑Anbindung
- Funktioniert mit Standard‑Templates und vielen Custom‑Layouts
- Geringer Implementationsaufwand, sofort nutzbar
Lieferumfang
- Plugin-Paket (.zip) zur Installation in JTL-Shop 5.x.
- Admin-Einstellungen für GA4 Measurement ID und Debug-Modus.
- Beispiel-Konfigurationen und kurze Installationsanleitung im Plugin-Ordner.
Updates & Kompatibilität
- Regelmäßige Kompatibilitäts-Updates für neue JTL-Shop-Releases und GA4-Änderungen (Scope: 1.x/Minor-Releases während der aktiven Version).
- Kleinere Bugfixes werden zeitnah bereitgestellt; größere Feature-Requests können als kostenpflichtige Erweiterungen angeboten werden.
Support
- Support per E-Mail (Angabe in Angebot): Fehlerdiagnose, Installationshilfe, Hinweise zu Template-Anpassungen.
- Supportumfang: Hilfe bei Installation, Konfiguration und grundlegender Fehlerbehebung. Anpassungen an individuellen Templates und kundenspezifische Erweiterungen können gegen Aufwandsentschädigung angeboten werden.
Lizenz & SLA (optional zu ergänzen)
Empfohlene Next Steps für Käufer
- GA4 Measurement ID bereithalten und Consent-Manager konfigurieren.
- Kurzprüfung im Staging: Debug-Modus aktivieren, Events im GA4-DebugViewer prüfen.
- Bei individuellen Templates: Screenshots oder Zugangsdaten für schnelle Problemanalyse an den Support senden.
Key Facts
-
Conversion Rate
Präzises, vollständiges E‑Commerce‑Tracking (inkl. Purchase) kombiniert mit Consent‑Handling ermöglicht zuverlässige Conversion‑Messungen und datengetriebene Optimierung.
-
Lizenz
Proprietär
-
Abonnements
Update-Garantie bei gültigem Abonnement
Support durch Hematek Solutions
-
Kompatibel mit JTL-Wawi ab
Keine Abhängigkeit
-
Kompatibel mit JTL-Shop 5 ab
5.0.0 - 5.6.1
Nutzungsvoraussetzungen
- Google‑Analytics‑4‑Property mit gültiger Measurement ID (Format: G-XXXXXXXXXX).
- Admin‑Zugang zum JTL‑Shop, um Plugins zu installieren und Einstellungen zu ändern.
- Empfehlenswert: Staging‑Umgebung für Tests vor Produktiv‑Rollout.
- Zugang zu GA4 DebugView (zum Verifizieren der Events).
Systemvoraussetzungen
-
JTL‑Shop Version: 5.0.0 oder neuer.
-
PHP: 7.3+ (benötigt für JSON_THROW_ON_ERROR).
-
Aktivierte PHP‑Erweiterungen: json (Standard), empfohlen: mbstring, intl.
-
Webbrowser mit aktiviertem JavaScript (für DOM‑Erkennung und gtag).
-
Optional: JTL Consent Manager (empfohlen zur rechtssicheren Ausspielung).
-
Hinweis: Plugin ist so entwickelt, dass es mit Standard‑Templates funktioniert. Bei stark angepassten Templates können geringfügige Anpassungen erforderlich sein.
Installation & EinrichtungBackup & Testumgebung
- Vor Produktion: vollständiges Backup von Shop-Dateien und Datenbank anlegen.
- Ideal: zuerst in Staging installieren.
Installation
- Check Out, Installieren und einrichten, fertig. Die einzelnen Funktionen sind ausführlich dokumentiert und intuitiv verwendbar.
Plugin aktivieren & Grundeinstellungen
- Admin → Plugins →
jtl_ga4 → Einstellungen öffnen.
- Feld „Google Analytics 4 Measurement ID“: GA4 Measurement ID (
G-...) eintragen.
- Debug-Modus: Beim Testen auf „Ja“ stellen (im Produktivbetrieb „Nein“).
- Speichern.
Consent Manager konfigurieren
- Falls der JTL Consent Manager eingesetzt wird: sicherstellen, dass die Zustimmungskategorie, die GA4 betrifft, aktiviert/konfiguriert ist.
- Das Plugin prüft Consent vor dem Senden von Events.
Prüfung & Tests (Staging)
- Debug-Modus aktivieren.
- Browser öffnen, GA4 DebugView aktivieren.
- Produktseiten, Kategorie-Listing, Warenkorb und Checkout durchspielen.
- In der Browser-Konsole nach Plugin-Logs suchen (Plugin schreibt Debug-Meldungen).
- In GA4 DebugView prüfen, dass Events (z. B.
view_item, view_item_list, add_to_cart, purchase) ankommen und die Feldwerte (item_name, price, transaction_id etc.) stimmen.
Produktivsetzung
- Nach erfolgreichem Test Debug-Modus deaktivieren.
- Measurement ID korrekt eintragen (falls im Staging anders verwendet).
- Monitoring in den ersten Tagen prüfen (GA4 DebugView / Echtzeit-Reports).
1.0.2 - 26.11.2025- Kompatibel mit JTL-Wawi: Keine Abhängigkeit
- Kompatibel mit JTL-Shop 5:von 5.0.0 - 5.6.1
- Kompatibel mit PHP:von 7.4 bis 8.2
JTL Shop 5.6.1 kompatibel
1.0.1 - 26.08.2025- Kompatibel mit JTL-Wawi: Keine Abhängigkeit
- Kompatibel mit JTL-Shop 5:von 5.0.0 - 5.5.3
- Kompatibel mit PHP:von 7.4 bis 8.4
- Kompatibel mit JTL-Wawi:von 1.0 - aktuellste Version
- Kompatibel mit JTL-Shop 5:von 5.0.0 - 5.5.*
Log History
-
1.0.226.11.2025
-
1.0.126.08.2025
