DataFirefly Google Tag Manager Pro — Vollständige Anleitung

Überblick und Voraussetzungen

DataFirefly Google Tag Manager Pro sendet einen vollständigen GA4-E-Commerce-dataLayer für Ihren WooCommerce-Shop und ermöglicht es Ihnen, mit einem Klick einen importfertigen Google-Tag-Manager-Container zu erzeugen, der bereits mit diesem dataLayer verdrahtet ist. Das Plugin übernimmt außerdem das Server-side-Tracking (Meta Conversions API, GA4 Measurement Protocol) mit automatischer Deduplizierung, den Consent Mode v2 und einen direkten Pixel-Einbindungsmodus für Shops, die kein GTM verwenden.

• WordPress 5.8 und höher, getestet bis 7.0.
• WooCommerce 7.0 und höher, getestet bis 9.6, HPOS- und Cart/Checkout-Blocks-kompatibel.
• PHP 7.4 und höher.
• Mehrsprachig (FR/EN/ES/DE/IT), kompatibel mit Polylang und WPML.
• Kein Tracking im Admin, in Feeds oder im Customizer.

Installation

1. Laden Sie das Archiv datafirefly-gtm-pro-1.1.0.zip aus Ihrem Kundenkonto herunter.
2. Gehen Sie im WordPress-Admin zu Plugins > Installieren > Plugin hochladen und legen Sie das Archiv ab.
3. Klicken Sie auf Aktivieren.
4. Öffnen Sie Tag Manager Pro im Admin-Menü, um zu den Einstellungen zu gelangen.

Bei der Aktivierung registriert das Plugin seine Standardeinstellungen. Anschließend können Sie Ihren Container, Ihre Verbindungen und das Server-side Tab für Tab einrichten.

Tab Allgemein — Container und dataLayer

Dieses Tab steuert die Container-Einbindung und die Form des dataLayer:

• Container-ID: Ihre GTM-ID im Format GTM-XXXXXXX. Solange sie leer ist, wird auf der GTM-Seite nichts eingebunden (der dataLayer und der Direktmodus bleiben verfügbar).
• dataLayer-Name: standardmäßig dataLayer. Ändern Sie ihn nur, wenn Ihre Installation es erfordert.
• Platzierung: head + body (noscript), nur head oder nur body.
• Ausgabepriorität: Standard oder Hoch (der Container wird früh im head geschrieben).

Tab Verbindungen — Ihre Plattformen

Geben Sie hier die IDs der Plattformen ein, die Sie nutzen. Diese Grundlage speist gleichzeitig den erzeugten GTM-Container, die direkten Pixel und die Server-side-Ereignisse. Lassen Sie leer, was Sie nicht nutzen.

• Google Analytics 4: Measurement ID (G-XXXXXXXXXX).
• Google Ads: Conversion ID (AW-XXXXXXXXX), Label der Kauf-Conversion, dynamisches Remarketing (Option).
• Meta: Pixel ID, Conversions-API-Token, CAPI-Testcode (Option).
• TikTok: Pixel ID, Events-API-Token (Option).
• Pinterest: Tag ID — Snapchat: Pixel ID — LinkedIn: Partner ID.
• Microsoft Advertising (UET): Tag ID — X: Pixel ID.
• Hotjar: Site ID — Microsoft Clarity: Project ID.

Unten im Tab wählt die Einstellung Pixel-Auslieferung den Modus: über Google Tag Manager (empfohlen, Sie importieren den erzeugten Container) oder direkte Einbindung (das Plugin lädt die Pixel selbst).

Tag Pilot — GTM-Container erzeugen und importieren

Das Tab Tag Pilot baut aus Ihren Verbindungen einen vollständigen Google-Tag-Manager-Container und bietet ihn zum Download an. Es erzeugt insbesondere:

• das GA4-Google-Konfigurations-Tag und ein GA4-Ereignis-Tag pro aktiviertem Ereignis (mit Übermittlung der E-Commerce-Daten aus dem dataLayer);
• den Google Ads Conversion Linker, die Kauf-Conversion und dynamisches Remarketing;
• das Meta-Pixel und seine Standardereignisse (ViewContent, AddToCart, InitiateCheckout, AddPaymentInfo, Purchase, Search);
• Custom-HTML-Tags für TikTok, Pinterest, Snapchat, LinkedIn, Microsoft UET, X, Hotjar und Clarity;
• die zugehörigen Data Layer Variables und benutzerdefinierten Ereignis-Trigger.

So importieren Sie ihn:

1. Klicken Sie auf GTM-Container herunterladen (.json).
2. Öffnen Sie in Google Tag Manager Verwaltung > Container importieren.
3. Wählen Sie die JSON-Datei, wählen Sie Ihren Arbeitsbereich und dann Zusammenführen (behält Ihre vorhandenen Tags) oder Überschreiben.
4. Vorschau, dann Senden & Veröffentlichen.

Direkter Pixelmodus (ohne GTM)

Wenn Sie nicht von GTM abhängen möchten, stellen Sie die Auslieferung im Tab Verbindungen auf direkte Einbindung. Das Plugin bindet dann die Basis-Pixel selbst ein (GA4, Meta und die übrigen konfigurierten Plattformen) und gibt die E-Commerce-Ereignisse des dataLayer an Meta, TikTok, Pinterest, Snapchat und GA4 weiter. Derselbe dataLayer speist beide Ansätze.

Server-side — Meta CAPI und GA4 Measurement Protocol

Aktivieren Sie im Tab Server-side das Senden der Käufe direkt von Ihrem Server:

• Meta Conversions API: benötigt die Pixel ID und ein CAPI-Token (Tab Verbindungen). Das Purchase-Ereignis wird mit SHA-256-gehashten Kundendaten, den Cookies _fbp/_fbc, der IP-Adresse und dem User-Agent gesendet.
• GA4 Measurement Protocol: benötigt die Measurement ID (Verbindungen) und ein API-Secret (GA4 > Verwaltung > Datenströme > Measurement Protocol).

Browser und Server teilen dieselbe deterministische event_id pro Bestellung (dfgtm.purchase.<id>). Meta und GA4 nutzen sie, um jede Conversion nur einmal zu zählen.

Consent Mode v2 und Enhanced Conversions

Das Tab Consent aktiviert den Consent Mode v2: denied-Consent-Zustände werden vor dem Laden des Containers standardmäßig gesetzt, mit EEA/UK-Scoping, wait_for_update, URL passthrough und Redaction der Werbedaten. Um das Consent bei der Wahl des Nutzers zu aktualisieren, binden Sie Ihr Cookie-Banner an die bereitgestellte JavaScript-API an:

// Alles erlauben
window.dfgtmConsent.grantAll();
// Alles ablehnen
window.dfgtmConsent.denyAll();
// Feingranulare Aktualisierung
window.dfgtmConsent.update({ ad_storage: 'granted', analytics_storage: 'granted' });

Die Google Ads Enhanced Conversions (Tab GA4 Ecommerce) fügen dem Kaufereignis SHA-256-gehashte Kundendaten hinzu, um die Attribution zu verbessern.

GA4-E-Commerce-Ereignisse

Das Plugin sendet die folgenden GA4-E-Commerce-Ereignisse, jeweils einzeln aktivierbar, mit vollständigen items-Objekten (item_id aus SKU oder ID, Marke, Kategorien bis zu 5 Ebenen, Variante, Preis, Rabatt):

• view_item_list, view_item, select_item
• add_to_cart, remove_from_cart, view_cart
• begin_checkout, add_shipping_info, add_payment_info
• purchase (dedupliziert: einmal pro Bestellung ausgelöst, auch beim Neuladen), search

Entwickler-Hooks

Das Plugin stellt an den wichtigen Stellen Filter bereit, um sein Verhalten zu erweitern, ohne den Kern zu verändern:

• dfgtm_export_container: den erzeugten GTM-Container vor der Kodierung anpassen.
• dfgtm_meta_capi_payload und dfgtm_ga4_mp_payload: die Server-side-Payloads anpassen.
• dfgtm_connections_registry: Ziele hinzufügen oder ändern.
• dfgtm_purchase_push und dfgtm_build_item: die Kaufdaten und die Item-Erstellung anpassen.

FAQ und Fehlerbehebung

Auf der GTM-Seite wird nichts eingebunden

Prüfen Sie, ob die Container-ID (GTM-XXXXXXX) im Tab Allgemein eingetragen ist und ob Sie nicht mit einer ausgeschlossenen Rolle angemeldet sind. Der dataLayer und der Direktmodus funktionieren auch ohne GTM-Container.

Conversions werden auf Meta doppelt gezählt

Stellen Sie sicher, dass Sie dasselbe Pixel nicht gleichzeitig über den GTM-Container und per direkter Einbindung laden. Server-side und Browser werden automatisch über event_id dedupliziert: das ist keine Quelle für Doppelzählung.

Das Kaufereignis wird nicht server-side gesendet

Prüfen Sie, ob die entsprechende Option im Tab Server-side aktiviert ist und die erforderlichen IDs eingetragen sind: Pixel ID + CAPI-Token für Meta, Measurement ID + API-Secret für GA4. Der Versand erfolgt einmal pro Bestellung.

Das GA4-Tag sendet keine E-Commerce-Daten

Im erzeugten Container lesen die GA4-Ereignis-Tags die E-Commerce-Daten aus dem dataLayer. Wenn Sie Ihre Tags manuell erstellt haben, aktivieren Sie „E-Commerce-Daten senden“ und wählen Sie „dataLayer“ als Quelle.

Was passiert bei der Deinstallation?

Wenn die entsprechende Option im Tab Erweitert aktiviert ist, werden die Einstellungen und die Bestell-Tracking-Meta entfernt. Andernfalls bleiben sie für eine mögliche Neuinstallation erhalten.