Zum Inhalt springen

Plugin-Dokumentation · JTL-Shop 5

Google Analytics 4 — Installation

Setup-Guide für die Installation des Plugins in JTL-Shop 5. Dauer: ca. 5 Minuten.

Voraussetzungen

  • JTL-Shop: Version 5.2.0 oder neuer (getestet bis 5.7.x), NOVA-Template
  • PHP: 8.1 oder neuer
  • Datenbank: keine eigenen Tabellen — die Measurement-ID wird in den Plugin-Einstellungen gespeichert
  • Externe Dienste: ein eingerichtetes Google-Analytics-4-Property inkl. Measurement ID (Format G-XXXXXXXXXX)
  • Wichtig: Der JTL Consent Manager muss im Shop-Backend aktiviert sein — ohne ihn lädt das Tracking aus rechtlichen Gründen grundsätzlich nicht (siehe Konfigurationsanleitung)

Installation über den JTL-Extension Store

  1. Erwerben Sie die Erweiterung im JTL-Extension Store. Sie wird dadurch mit Ihrer Shop-Lizenz verknüpft.
  2. Öffnen Sie im JTL-Shop-Backend Plugins → Meine Erweiterungen. Die Erweiterung erscheint dort nach kurzer Zeit automatisch.
  3. Klicken Sie auf Installieren.
  4. Aktivieren Sie das Plugin anschließend im Plugin-Manager unter Installiert, falls es nicht bereits aktiv ist.

Alternative: manuelle Installation (ZIP)

  1. Öffnen Sie im JTL-Shop-Backend Plugins → Plugin-Manager und wählen Sie den Tab Upload.
  2. Laden Sie das Plugin-Paket (ZIP) hoch. Der Ordnername im Archiv (webpowers_google_analytics) darf nicht verändert werden.
  3. Wechseln Sie zum Tab Vorhanden, wählen Sie Google Analytics 4 aus und klicken Sie auf Installieren.
  4. Aktivieren Sie das Plugin unter Installiert.

Nach der Installation

Öffnen Sie Installierte Plugins → Google Analytics 4 → Einstellungen, tragen Sie Ihre Measurement ID ein und setzen Sie „Plugin aktivieren" auf Aktiviert. Aktivieren Sie zusätzlich den JTL Consent Manager im Shop-Backend — ohne ihn bleibt das Tracking bewusst inaktiv. Details zum Consent-Verhalten, zur IP-Anonymisierung und zu den Enhanced-Ecommerce-Events finden Sie in der Konfigurationsanleitung unter webpowers.org/docs/jtl-google-analytics/konfiguration.

Deinstallation

Das Plugin kann jederzeit über den Plugin-Manager deinstalliert werden. Es legt keine eigenen Datenbanktabellen an — beim Entfernen bleiben keine plugin-eigenen Daten zurück. Bereits an Google Analytics übertragene Daten verbleiben in Ihrem GA4-Property und werden dort nach den Google-eigenen Aufbewahrungseinstellungen verwaltet.

Support

webpowers UG (haftungsbeschränkt) · Hillenbrandstr. 9, 86156 Augsburg · E-Mail: max@webpowers.org