Google Analytics GA4: Einrichtung und Hilfe

Folgen Sie den Schritten im Schnellstart.

Öffnen Sie "Configure" in "Module Manager". Verwenden Sie Einstellungen für IDs und Trackingsteuerung, Diagnose für Prüfungen. Separate Seiten für Lizenz, Support, Aktualisieren und "Integrity" sind vorhanden.

"Enhanced Conversions" hasht E-Mail, Telefon, Vorname, Nachname, Stadt, Region und Postleitzahl nach Entfernen äußerer Leerzeichen und Umwandlung in Kleinbuchstaben. Der ISO-Ländercode wird ungehasht gesendet. Adressfelder stammen, falls verfügbar, aus der ersten Kundenadresse. Diese Option ist vom Tracking der gehashten Kunden-ID getrennt.

Produktinteraktion

Der gemeinsame Tracker erkennt außerdem Variantenwechsel und Produktdetailinteraktionen. Standardmäßig begrenzt er hohes Interesse auf einmal pro Produkt/Sitzung. Halten Sie dies getrennt von Ihrer primären Kaufconversion-Einrichtung.

Ist Cookies Revolution aktiv, erkennt das Modul es und kann sich auf displayHeader an die letzte Stelle verschieben, damit die CMP zuerst Consent Mode initialisiert. Verwenden Sie bei Bedarf Hook-Reihenfolge reparieren in Diagnose.

Ohne diese erkannte CMP gibt das Modul Consent-Mode-Standardwerte aus, die Analyse-, Werbe-, Werbenutzerdaten- und Personalisierungsspeicherung verweigern, Sicherheitsspeicherung jedoch erlauben. Dies ist ein Standardsnippet. Es erstellt kein Banner und holt keine Einwilligung ein. Konfigurieren Sie Einwilligungsaktualisierungen über Ihr Einwilligungswerkzeug.

Die Browser-Zulässigkeitsprüfung überspringt Nicht-Frontend-Controller, erkannte Bots/Audit-Werkzeuge, ausgeschlossene Mitarbeiter und Browser mit mpr_notrack=1. So schließen Sie einen Testbrowser aus:

document.cookie = 'mpr_notrack=1; path=/; max-age=31536000; SameSite=Lax';

Serverkäufe erfordern die erfasste Analyseeinwilligung des Käufers, seine ursprüngliche GA-Client- und Sitzungs-ID sowie die Zuständigkeit dieses Moduls für die konfigurierte GA4-Property. Browser-Opt-outs und Mitarbeiterausschlüsse gelten ebenfalls. "Server-Side Purchase Fallback" ist standardmäßig deaktiviert. Geben Sie zur Aktivierung gültige Zugangsdaten ein und setzen Sie "Purchase recovery hostname" auf den HTTPS-Hostnamen Ihres Produktivshops, ohne Schema oder Pfad.

Das Modul lädt GA4 asynchron über displayHeader. Es sendet E-Commerce-Ereignisse über folgende Pfade:

Dieses Einstellungsformular hat keine separaten Schalter für diese Standard-E-Commerce-Ereignisse. Ihr Auftreten hängt von den zugehörigen Hooks und dem Theme-Ablauf ab.

Kaufdaten enthalten die Bestellreferenz als transaction_id, Wert, Währung, Steuern, Versand, Gutscheine und Positionen. Verfügbare Artikelfelder umfassen ID, Name, Preis, Menge, Marke, Kategorie, Variante und Rabatt. Prüfen Sie diese Werte anhand einer Testbestellung mit Ihrer Steuer-, Rabatt- und Versandkonfiguration.

"Track custom events" steht standardmäßig auf Nein. Das Feld "Custom event rules" ist zunächst leer. Fügen Sie Regeln hinzu, aktivieren Sie den Schalter und speichern Sie:

[
  {"event":"gallery_browse","trigger":"click","selector":".product-images img,.images-container img","params":{"component":"product_gallery"},"once":false},
  {"event":"checkout_page_seen","trigger":"url","contains":["/order"],"params":{"area":"checkout"},"once":true},
  {"event":"module_page_seen","trigger":"controller","controllers":["module"],"modules":["mprwishlist"]},
  {"event":"size_guide_opened","trigger":"event","dom_event":"shop:size-guide-opened","params":{"component":"size_guide"},"once":false}
]

document.dispatchEvent(new CustomEvent('shop:size-guide-opened'));

Verwenden Sie Ereignis- und Parameternamen, die mit einem Buchstaben beginnen, Buchstaben, Ziffern oder Unterstriche enthalten und höchstens 40 Zeichen haben. Reservierte Namen und Präfixe werden abgelehnt. Personenbezogen wirkende Parameterschlüssel werden gefiltert. Klickselektoren dürfen bis zu 500 Zeichen haben. once ist standardmäßig false für Klicks und true für URL-, Controller- und DOM-Ereignisregeln. Passen Sie Controller-/Modulfilter an Ihre tatsächliche Route an.

Die Bestellvalidierung erfasst zulässige Käufe für die Wiederherstellung. Nach 30 Minuten ohne Browserbestätigung stellt die gemeinsame Cron-Aufgabe zulässige Measurement-Protocol-Ereignisse purchase in die Warteschlange und sendet sie mit den beim Checkout erfassten Käuferdaten:

task: send_ga4_measurement_protocol
callable: mprgoogleanalytics::cronProcessMeasurementProtocolQueue
schedule: every:300
context: any
timeout: 30

Stellen Sie sicher, dass Ihr gemeinsamer MPR-Cron-Runner diese Aufgabe ausführt. Prüfen Sie das Ereignisprotokoll in Diagnose und die gemeinsame Conversion-Warteschlange. Protokollzeilen verwenden Ihr Datenbankpräfix gefolgt von mpr_analytics_events; ps_ ist nur das übliche Beispielpräfix. Die Aufbewahrungsbereinigung läuft nach zulässiger Bestellvalidierung. Die Kaufwiederherstellung endet 72 Stunden nach der Bestellung. Die Aufbewahrung der Wiederherstellungsdatensätze richtet sich nach "Log Retention (days)".

Browser- und Serverkäufe verwenden die Bestellreferenz als transaction_id. Ein gemeinsamer Übermittlungsnachweis ordnet jeden Kauf einem Kanal zu. Die Serverwiederherstellung verarbeitet nur Bestellungen, für die nach 30 Minuten noch keine Browserbestätigung vorliegt.

Die Client- und Sitzungs-ID für Serverkäufe stammen aus den ursprünglichen GA-Cookies, die vor der Bestellung erfasst wurden. Fehlende oder unbrauchbare IDs halten die Wiederherstellung an; das Modul erzeugt keine Ersatzidentitäten. Die Warteschlange macht reine Browserereignisse nicht zu serverseitigen Ereignissen.

Öffnen Sie Diagnose und verwenden Sie Prüfungen ausführen. Prüfen Sie erforderliche Konfiguration, Gültigkeit eigener Regeln, Hook-Reihenfolge, Modulgruppensichtbarkeit, CMP-Erkennung, doppelte Skripte, Ausschlüsse und Measurement-Protocol-Status. Verwenden Sie bei Bedarf Hook-Reihenfolge reparieren oder Modulgruppe reparieren.

Prüfen Sie Netzwerkanfragen und GA4 DebugView mit einem normalen Kundenbrowser. Bot-/Audit-User-Agents können absichtlich ausgeschlossen sein. Testen Sie Produktaufruf, Warenkorbänderungen, Checkout, Anmeldung, Registrierung, Suche und eine vollständige Bestellung. Prüfen Sie Transaktionsreferenz und Positionssummen.

Lädt kein Tag, prüfen Sie "Enable Tracking", die "Measurement ID", Mitarbeiter-/Opt-out-Ausschlüsse, Hook-Ausführung und doppelte Zuständigkeit. Fehlt im Theme displayProductActions oder displayBeforeCarrier, kann das zugehörige Ereignis fehlen.

Fehlt der Serverkauf, prüfen Sie Fallback-Schalter, ID, Secret, Zuständigkeit für die Tracking-Funktion, Warteschlangenworker und aktuelles HTTP-/Fehlerprotokoll. Ein leeres Secret lässt Browsertracking verfügbar. GA4-Summen können wegen blockierter Skripte, Einwilligung, Attribution, Berichtsverzögerungen und Erstattungen von PrestaShop abweichen. Das Kauftracking dieses Moduls ist kein System zum Buchhaltungsabgleich.

Setzen Sie "Enable Tracking" auf Nein und speichern Sie, um diese Integration zu pausieren. Deinstallieren Sie über "Module Manager", um Menü, Cron-Registrierung und Modulkonfiguration zu entfernen. Die gemeinsame Warteschlangentabelle bleibt bei Nutzung des Conversion-Pakets durch ein anderes Modul erhalten; andernfalls löscht sie dessen Deinstallationshelfer. Verwalten Sie GA4-Property und historische Daten in Google Analytics. Das Ereignisprotokoll nutzt gemeinsamen Speicher; löschen Sie keine gemeinsame Tabelle manuell.

Verwenden Sie die obigen Einstellungsnamen, wenn ein Referenzbild von Ihrer installierten Version abweicht.