Google Tag Pro (GTM & GA4) — Komplettanleitung

Google Tag Pro (das Modul dfgtagmanager) installiert ein vollständiges, zuverlässiges E-Commerce-Tracking in Ihrem Shop: 16 GA4 Enhanced Ecommerce Ereignisse, Consent Mode v2, Enhanced Conversions, Google Ads Conversion-Tracking, Werbepixel, Server-side GTM und ein Conversion Recovery-System, das verlorene Conversions wiederholt. Diese Anleitung behandelt die Installation, jeden Konfigurationsbereich und die Fehlerbehebung.

Voraussetzungen

• PrestaShop 8.0 bis 9.0 (PHP 8.1 bis 8.4 empfohlen).
• Ein Google Tag Manager-Konto mit einem Web-Container (ID im Format GTM-XXXXXXX).
• Eine Google Analytics 4-Property (Measurement-ID im Format G-XXXXXXXXXX).
• Optional: ein Google Ads-Konto (Conversion-ID AW-XXXXXXXXX), Google Merchant Center und/oder ein sGTM-Server.

Installation

1. Gehen Sie im Back-Office zu Module > Modul-Manager, klicken Sie auf Modul hochladen und wählen Sie die Datei dfgtagmanager.zip.
2. Klicken Sie nach der Installation auf Konfigurieren.
3. Das Modul erstellt seine Tabellen (Conversion- und Ereignisprotokoll) und registriert seine Hooks automatisch.

1. Google Tag Manager Konfiguration

Im Bereich Google Tag Manager – Konfiguration:

• GTM aktivieren: aktiviert die Container-Injektion im Front-Office.
• GTM-Container-ID: Ihr Bezeichner GTM-XXXXXXX. Solange er leer ist, injiziert das Modul nichts.
• GA4 Measurement-ID: Ihr Bezeichner G-XXXXXXXXXX. Er wird verwendet, um das GA4-Tag im Container-Export vorzubefüllen.

Das Modul pusht die Daten vor dem Laden von GTM in den dataLayer, damit alle Ihre Tags sofort über die Seiten- und E-Commerce-Daten verfügen.

2. Tracking-Ereignisse (GA4 Enhanced Ecommerce)

Nach der Aktivierung sendet das Modul automatisch bis zu 16 Ereignisse, die dem offiziellen GA4-Schema entsprechen:

• Entdeckung: view_item, view_item_list, select_item
• Warenkorb & Checkout: add_to_cart, remove_from_cart, view_cart, begin_checkout, add_shipping_info, add_payment_info
• Conversion: purchase (mit items[], value, tax, shipping, coupon, transaction_id)
• Nutzer & Marketing: login, sign_up, search, add_to_wishlist, view_promotion, select_promotion

Warenkorb-, Checkout-, Promotion- und Such-Ereignisse werden clientseitig ausgelöst (AJAX-Abfang und IntersectionObserver); das purchase-Ereignis wird serverseitig bei der Bestellbestätigung erstellt.

Zugehörige Einstellungen im Bereich Tracking-Ereignisse: Aktivieren/Deaktivieren von GA4 Enhanced Ecommerce, Nutzerdaten (user_data), interner Suche, Login, Registrierung, Promotionen, Wunschliste und dynamischem Remarketing.

3. Consent Mode v2 (DSGVO / DMA)

Consent Mode v2 ist seit März 2024 Pflicht, um Google-Conversions im EWR zu messen. Im Bereich Consent Mode v2:

• Consent Mode v2 aktivieren: injiziert die Standard-Consent-Werte vor GTM.
• Standard analytics_storage / ad_storage: lassen Sie auf Abgelehnt (DSGVO-empfohlen); der Consent wird von Ihrem Banner aktualisiert.

Das Modul aktiviert außerdem url_passthrough und ads_data_redaction, um die Conversion-Modellierung bei fehlendem Consent zu maximieren.

Ihr Cookie-Banner (CMP) verbinden

Wenn der Besucher akzeptiert oder ablehnt, rufen Sie die vom Modul bereitgestellte Funktion aus Ihrer CMP (Tarteaucitron, Axeptio, Cookiebot usw.) auf:

DFGTM.updateConsent({
  analytics_storage: 'granted',
  ad_storage: 'granted',
  ad_user_data: 'granted',
  ad_personalization: 'granted'
});

4. Enhanced Conversions

Wenn aktiviert, verbessern Enhanced Conversions die Google Ads Attribution. Das Modul hasht Kundendaten (E-Mail, Name, Telefon, Stadt) serverseitig mit SHA-256 und überträgt sie über den dataLayer. Die Daten werden nie im Klartext übertragen; Postleitzahl und Land werden gemäß den Google-Spezifikationen ungehasht gesendet.

5. Google Ads Conversions & Merchant Center

Im Bereich Google Ads – Conversion-Tracking:

• Google Ads Conversion aktivieren: fügt den Conversion Linker, das Kauf-Conversion-Tag und das dynamische Remarketing zum GTM-Export hinzu.
• Conversion-ID: Ihr Bezeichner AW-XXXXXXXXX.
• Conversion-Label (Kauf): das Label der „Kauf“-Conversion (alphanumerische Zeichenkette).
• Merchant Center ID + Feed-Land und –Sprache: erforderlich für „Conversions mit Warenkorbdaten“.
• Produkt-ID-Quelle: wählen Sie das Format, das dem id-Feld Ihres Merchant-Center-Feeds entspricht (ID + Trennzeichen + Variante, Referenz/SKU, nur ID, EAN13, UPC oder MPN).

6. Werbepixel (Meta, TikTok, Pinterest)

Geben Sie im Bereich Werbepixel Ihre Facebook/Meta-, TikTok- und Pinterest-IDs ein. Sie werden in den GTM-Container-Export integriert, mit automatisch gemappten E-Commerce-Ereignissen (Purchase, AddToCart, ViewContent, InitiateCheckout, Search / CompletePayment / checkout je nach Plattform).

7. GTM-Container-Export

Statt Dutzende von Tags manuell zu erstellen, generiert das Modul einen importfertigen Container:

1. Klicken Sie im Bereich GTM-Container-Export auf GTM-Container exportieren (JSON).
2. Gehen Sie im Google Tag Manager zu Admin > Container importieren.
3. Wählen Sie die JSON-Datei, einen Arbeitsbereich und die Option Zusammenführen (oder Überschreiben bei einem leeren Container).
4. Prüfen Sie die Vorschau und veröffentlichen Sie dann Ihren Container.

Der Export enthält das GA4 Configuration Tag und alle Enhanced Ecommerce Ereignisse, DataLayer-Variablen, Custom Event Trigger, Consent Mode v2 sowie die aktivierten Google Ads Tags und Pixel.

8. Server-Side GTM (sGTM)

Aktivieren Sie im Bereich Server-Side GTM die Option und geben Sie Ihre Server-URL ein (z. B. https://sgtm.ihre-domain.de). Das Modul lädt dann das GTM-Skript und das Noscript von Ihrem Server statt von googletagmanager.com, was Ad-Blocker umgeht und die Tracking-Zuverlässigkeit verbessert.

9. Conversion Recovery

Dies ist die Schlüsselfunktion des Moduls. Bei jeder Bestellbestätigung wird die Conversion in der Datenbank gespeichert. Eine asynchrone Prüfung verifiziert, ob GTM das purchase-Ereignis empfangen hat; falls nicht (Ad-Blocker, Zahlungsweiterleitung, Netzwerkfehler), wird das Ereignis beim nächsten Besuch des Kunden automatisch wiederholt. Keine Konfiguration erforderlich; lassen Sie die Option in den Erweiterten Optionen aktiviert.

10. Erweiterte Optionen

• Cross-Domain-Tracking: Listen Sie die betroffenen Domains auf (durch Kommas getrennt).
• Steuern / Versand vom Umsatz ausschließen: passt die value-Berechnung für purchase an.
• Debug-Modus: protokolliert jeden dataLayer-Push in der Browser-Konsole (farbiges Präfix „DataFirefly GTM“). In der Produktion deaktivieren.

11. Monitoring-Dashboard

Oben auf der Konfigurationsseite zeigt ein Dashboard über 30 Tage: die Anzahl der getrackten Conversions, die erfolgreich gepushten, die auf Recovery wartenden, den getrackten Umsatz, die Tracking-Erfolgsrate und die Top-Ereignisse über 7 Tage. Eine Schaltfläche Wiederholen markiert fehlgeschlagene Conversions für einen erneuten Versuch neu.

PrestaShop 9 Kompatibilität

Seit Version 1.2.0 ist das Modul mit PrestaShop 8 und 9 kompatibel (Symfony 6.4, PHP 8.1 bis 8.4). Die Preisformatierung erfolgt über die Locale (die alte Methode Tools::displayPrice wurde aus PS9 entfernt), das Such-Tracking ist clientseitig, und sowohl Sessions als auch der Export-Download wurden für den Symfony-Kernel abgesichert. Beim Upgrade ist keine Aktion erforderlich; das Upgrade-Skript räumt veraltete Hooks automatisch auf.

Fehlerbehebung

Keine Daten erreichen GTM / GA4

Prüfen Sie, ob GTM aktivieren angehakt und die Container-ID eingetragen ist. Das Modul injiziert nichts, solange nicht beide Bedingungen erfüllt sind. Verwenden Sie die GTM-Vorschau (Preview) und den Debug-Modus des Moduls, um die dataLayer-Pushes zu sehen.

Google Ads Conversions werden nicht ausgelöst

Stellen Sie sicher, dass Sie den exportierten Container nach Eingabe der Conversion-ID und des Labels importiert und veröffentlicht haben. Prüfen Sie das Format AW-XXXXXXXXX und das Kauf-Label.

Warenkorbdaten (Merchant Center) fehlen

Tragen Sie die Merchant Center ID, das Feed-Land und die Sprache ein und prüfen Sie, ob die Produkt-ID-Quelle mit dem id-Feld Ihres Feeds übereinstimmt.

Consent bleibt „abgelehnt“

Verbinden Sie Ihre CMP, indem Sie DFGTM.updateConsent() bei der Zustimmung aufrufen. Ohne diesen Aufruf werden nur modellierte Daten erfasst.

Die Export-Datei ist leer oder beschädigt

Deaktivieren Sie vorübergehend HTML-Cache-/Optimierungsmodule und versuchen Sie es erneut; der Export leert die Ausgabepuffer, aber ein Drittanbieter-Modul kann vor dem Download Inhalt einfügen.