# 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…
- Seite:
- Sprache: de
- Aktualisiert am: 2026-06-27
- Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/datafirefly-google-tag-manager-pro/index.md), [en](https://www.datafirefly.com/en/documentation/datafirefly-google-tag-manager-pro/index.md), [es](https://www.datafirefly.com/es/documentation/datafirefly-google-tag-manager-pro/index.md), [it](https://www.datafirefly.com/it/documentation/datafirefly-google-tag-manager-pro/index.md), [pl](https://www.datafirefly.com/pl/documentation/datafirefly-google-tag-manager-pro/index.md), [nl](https://www.datafirefly.com/nl/documentation/datafirefly-google-tag-manager-pro/index.md), [pt](https://www.datafirefly.com/pt/documentation/datafirefly-google-tag-manager-pro/index.md)
- Index:
## Ü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.
Das Plugin trennt zwei Rollen: Es **erzeugt die Daten** (den GA4-dataLayer) und es **hilft Ihnen, sie auszuliefern** (erzeugter GTM-Container, direkte Pixel, Server-side-Ereignisse). Sie wählen den passenden Auslieferungsmodus.
## 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).
Tracking wird für Administratoren und Mitarbeiter gemäß den ausgeschlossenen Rollen (Tab Erweitert) nie ausgelöst, ebenso wenig im Admin, in RSS-Feeds oder im Customizer.
## 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**.
Bei einem bestehenden Container bevorzugen Sie **Zusammenführen**, um Ihre anderen Tags nicht zu entfernen.
## 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.
Aktivieren Sie dasselbe Pixel nicht gleichzeitig über GTM _und_ per direkter Einbindung: Sie riskieren eine Doppelzählung. Wählen Sie pro Plattform einen einzigen Auslieferungsmodus.
## 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.`). Meta und GA4 nutzen sie, um jede Conversion nur einmal zu zählen.
Server-side-Anfragen werden nach der Zahlung nicht blockierend gesendet, bei den Status „in Bearbeitung", „abgeschlossen" oder „Zahlung abgeschlossen", einmal pro Bestellung.
## 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.