Conversions API für serverseitigen Google Tag Manager (GTM)

Die Conversions API ermöglicht eine direkte Verbindung deiner Marketingdaten mit unseren Systemen. Dadurch kannst du dein Anzeigen-Targeting optimieren, über alle Meta-Technologien hinweg die Kosten pro Handlung senken und deine Ergebnisse messen. Du kannst einen Server, den du auf der Google Cloud Platform (GCP) oder einem anderen Cloud-Anbieter einrichtest, so konfigurieren, dass er wichtige Web- und Offline-Event-Daten über die Conversions API sendet. Mit dieser Einrichtung kannst du diese Daten nach der Konfiguration des Google Analytics 4(GA4)-Web-Tags an deinen eigenen Server senden, der auf der Google Cloud Platform (GCP) gehostet wird, und schließlich über die Conversions API an Meta.

Das Conversions API-Tag wird von Meta basierend auf der benutzerdefinierten Tag-Vorlage von Google erstellt und verwaltet. Bitte wende dich an Google, wenn du Fragen zur Einrichtung von Google-Produkten oder zur Entwicklungsdokumentation von Google hast.

In diesem Dokument wird Folgendes beschrieben:

• Voraussetzungen, einschließlich der Erstellung eines Servercontainers
• Vorgehensweise bei der Konfiguration des Containers, um deine Umsetzung des GA4-Web-Tags zu unterstützen
• Vorgehensweise beim Senden von Daten von deiner Website an deinen GCP-Server
• Vorgehensweise beim Teilen von Daten mit Meta über die Conversions API
• Häufig gestellte Fragen

Voraussetzungen

Bevor wir mit dieser Integration fortfahren, empfehlen wir dir:

1. Mach dich mit der Conversions API-Integration und den Best Practices für die Einrichtung vertraut.
2. Mach dich mit dem serverseitigen Tagging und der benutzerdefinierten Tag-Vorlage vertraut.

Wenn dein System eine ältere Version als GA4 verwendet, musst du deine vorhandene Tag Manager-Einrichtung aktualisieren, um GA4 zu verwenden, bevor du mit dieser Integration fortfährst.

Integration

Einen GTM-Servercontainer erstellen

Du musst einen Servercontainer und einen Webcontainer konfigurieren:

• Webcontainer: Wenn du GTM zum ersten Mal verwendest, beginnst du damit, einen Webcontainer in deinem Konto zu installieren. Weitere Informationen findest du hier.
• Servercontainer: Du musst einen Servercontainer in deinem GTM-Portal erstellen, um eine Tagging-Server-URL einzurichten. Erfahre mehr über diesen Schritt.

Die Einrichtung eines Servercontainers erfordert die Konfiguration eines Tagging-Servers. Die standardmäßige GCP-Bereitstellung kann beim Einrichten des Servercontainers durchgeführt werden (siehe folgende Anleitung). Leitfaden für die manuelle Einrichtung.

Web- und Servercontainer konfigurieren

1. Erstelle in deinem Webcontainer folgende Artefakte:
   • GA4-Konfiguration zur Konfiguration deiner Tagging-Server-URL.
   • GA4-Event zur Konfiguration des Event-Schemas, das dem Server zugestellt wird.
2. Erstellen in deinem Servercontainer folgende Artefakte:
   • GA4-Client, ein Listener für das Event, der das Event an Meta weiterleitet.
   • Meta Conversions API-Tag, ein serverseitiges Tag, das das Standard-Event-Modell des GA4-Clients in das Conversions API Event-Schema umwandelt und an graph.facebook.com sendet.

Schritt 1: GA4-Konfiguration – Konfiguriere deine Tagging-Server-URL

Konfiguriere deinen Webcontainer, um deine Website-Daten an den erstellten Tagging-Server zu senden. Erfahre mehr über die Konfiguration des Google Analytics: GA4-Konfigurations-Tags.

• Wenn du An Servercontainer senden auswählst, legst du deine Servercontainer-URL als Tagging-Server-URL fest.
• Wenn du An Servercontainer senden unter Festzulegende Felder nicht auswählst, klicke auf Zeile hinzufügen und lege Folgendes fest:

  • Feldname: transport_url
  • Feldwert: die URL deines Tagging-Servers

Du kannst zusätzliche Felder für alle anderen Parameter konfigurieren, die du für alle Events senden möchtest.

• Setze die „first_party_collection“-Flag auf „true“ fest. Du musst dies tun, um den „user_data“-Parameter an den serverseitigen GTM übergeben zu können. Klicke unter Festzulegende Felder auf Zeile hinzufügen und lege Folgendes fest:

  • Feldname: first_party_collection
  • Feldwert: true

Verwenden eines bestehenden GA4-Konfigurations-Tags

Wenn du bereits eine GA4-Konfiguration eingerichtet hast, kannst du sie entweder ändern oder einen zusätzlichen Konfigurations-Tag für den serverseitigen GTM erstellen.

Wenn du den serverseitigen GTM zum ersten Mal einrichtest, wird durch das Hinzufügen der Servercontainer-URL dein gesamter Traffic an den Servercontainer gesendet. Wenn du weiterhin Daten an GA4 senden möchtest, musst du das serverseitige GA4-Tag in deinem Servercontainer hinzufügen, um sicherzustellen, dass es bei allen Events ausgelöst wird. Möglicherweise musst du zusätzliche GA4-Event-Tags erstellen oder vorhandene ändern, um eine vollständige Zuordnung zu den Meta-Pixel-Events sicherzustellen.

Senden der Meta-Browser-ID und der Meta-Klick-ID

Wenn du eine selbstdefinierte Domäne eingerichtet hast und deine GTM-Tagging-Server-Domäne eine Erstanbieterdomäne ist, werden die Meta-Browser-ID und die Meta-Klick-ID automatisch gesendet.

Wenn du die bereitgestellte Standarddomäne verwendest oder feststellst, dass die Felder „Browser-ID“ und „Klick-ID“ nicht im Events Manager gesendet werden, kannst du diese wie folgt konfigurieren:

• Gehe zum Variablenabschnitt und erstelle eine neue selbstdefinierte Variable sowohl für die Meta-Browser-ID als auch für die Meta-Klick-ID. Verwende den Variablentyp „First-Party-Cookie“.

  • Wähle für die Meta-Browser-ID den Cookie-Namen _fbp.
  • Wähle für die Meta-Klick-ID den Cookie-Namen _fbc.
• Speichere diese Variablen.
• Klicke in deinem GA4-Konfigurations-Tag unter Festzulegende Felder auf Zeile hinzufügen und lege Folgendes fest:

  • Feldname: x-fb-ck-fbp
  • Feldwert: Variable deiner Meta-Browser-ID
• Füge eine zusätzliche Zeile für die Klick-ID hinzu:
• Feldname: x-fb-ck-fbc
• Feldwert: die Variable deiner Meta-Klick-ID

Erstelle eine Datenschichtvariable für jeden der user_data-Parameter des allgemeinen GTM-Event-Schemas. Erfahre mehr über das Einrichten von Datenschichtvariablen. Um beispielsweise eine E-Mail-Adresse an den serverseitigen GTM zu übergeben, erstelle eine Variable (z. B. user_data_email_address), die dem Datenschichtvariablen-Namen eventModel.user_data.email_address zugeordnet werden kann.

Wenn du die Datenschicht nicht verwendest, konfiguriere stattdessen Variablen für jeden Parameter wie unten angegeben. Die Liste unten zeigt alle Zuordnungen für die Parameter von Meta und user_data-Parameter von GTM sowie ihre allgemeine Priorität bei der Steigerung der Qualität des Event-Abgleichs. Für die bestmögliche Nutzung deiner Meta-Werbeanzeigen empfiehlt es sich, die Best Practices der Conversions API einzuhalten, wenn du eine Integration zum ersten Mal einrichtest. Wenn du die Conversions API bereits eingerichtet hast, empfehlen wir dir, diese Best Practices einzuhalten, um deine bestehende Einrichtung zu verbessern. Die Best Practices der Conversions API können helfen, die Performance deiner Werbeanzeigen zu verbessern, indem sie deine Kosten pro Handlung senken.

Schritt 2: GA4-Event – Konfiguriere das Event-Schema, das dem Server zugestellt werden soll

• Konfiguriere deinen Webcontainer so, dass deine Websitedaten an den erstellten Tagging-Server gesendet werden, um Google Analytics hinzuzufügen. Erfahre mehr über die Konfiguration des Google Analytics: GA4-Konfigurations-Tags.

• Füge das Google Analytics: GA4-Event-Tag aus der Galerie für Vorlagen zu deinem Workspace hinzu:

  • Richte einen Eventnamen für das Tag ein. Du kannst hierfür einen statischen Wert festlegen oder den Eventnamen so konfigurieren, dass er auf eine Variable zurückgreift. Für bestimmte Standardevents ordnen wir Google Analytics-Standardevents Meta-Äquivalenten zu. Für diese Events kannst du entweder den Google Analytics Eventnamen oder den Meta Eventnamen verwenden. Verwende für alle anderen Standardevents den Meta-Eventnamen. Verwende für selbstdefinierte Events den Namen des selbstdefinierten Events. Mehr erfahren. Mehr erfahren.

• Gehe im Eventparameter-Abschnitt wie folgt vor:

  • Wenn du das Meta-Pixel verwendest, füge den Event-ID-Parameter hinzu. Verwende „event_id“ als Parameternamen und die für die Event-ID erstellte Variable als Parameterwert. Im Abschnitt Deduplizierung findest du Anweisungen zur Erstellung der Event-ID-Variable und zur Änderung des Meta-Pixels.
  • Führe eine Zuordnung für alle zu konfigurierenden Parameter durch. Der Variablenname basiert auf dem Event, das ein gängiges Event-Schema verwendet. Um zum Beispiel eine E-Mail-Adresse als Eventparameter einzurichten, musst du für sie den Parameternamen „user_data.email_address“ definieren und den Wert als Variablennamen einrichten, der die „email_address“ liest (siehe Definition in Abschnitt 1).
  • Eine vollständige Liste findest du im Abschnitt Selbstdefinierte Datenparameter weiter unten.

Schritt 3: Erstelle einen Listener für das Event, der das Event an Meta übergibt

Jeder serverseitige GTM-Container verfügt über einen standardmäßigen GA4-Client, um Events zu ermitteln, die von ihrem GA4-Web-Tag konfiguriert wurden. Der GA4-Client ist hierfür auf die /g/collect-Route deiner Tagging Server-URL ausgerichtet und sendet das eventModel an das Downstream-Tag. Wenn der standardmäßige GA4-Client bereits in deinem Servercontainer unter dem Clients-Bereich installiert ist, kannst du mit Schritt 4 fortfahren.

Schritt 4: Erstelle ein Meta Conversions API-Tag, ein serverseitiges Tag, das das Standard-Event-Modell des GA4-Clients in das Conversions API-Event-Schema umwandelt und an graph.facebook.com sendet.

Um das Event an die Conversions API zu senden, musst du das Meta Conversions API-Tag aus der Galerie für Vorlagen installieren. Die Tag-Vorlage ist von facebookincubator und heißt Conversions API Tag. Dieses Tag kann so eingerichtet werden, dass es für Events ausgelöst wird, die der GA4-Client im vorherigen Schritt empfangen hat und an die Conversions API gesendet hat. Um das Meta Conversions API-Tag zu installieren, benötigst du eine Pixel-ID, einen Zugriffsschlüssel und musst für die Handlungs-Quelle „Website“ angeben. Indem du die Conversions API verwendest, versicherst du, dass der Parameter action_source nach bestem Wissen und Gewissen richtig ist.

Integration testen

Wir empfehlen, den Vorschaumodus von Google Tag Manager zu verwenden, um Integrationen vor der Veröffentlichung von Änderungen zu testen. Sowohl Webcontainer als auch Servercontainer haben Vorschaumodi und du kannst beide gleichzeitig ausführen.

Mit der Funktion „Test-Events“ im Events Manager kannst du verifizieren, ob deine Server-Events richtig empfangen werden. Das Tool findest du unter Events Manager > Datenquellen > Dein Pixel > Test-Events.

Das Tool „Test-Events“ generiert eine Test-ID. Sende die Test-ID als test_event_code-Parameter in deinem Conversions API-Tag, um Event-Aktivitäten im Fenster „Test-Events“ anzuzeigen. Vergewissere dich, die ID zu entfernen, bevor du Änderungen veröffentlichst.

Mit dem Test-Event-Tool kannst du sehen, ob Events richtig empfangen und dedupliziert werden. Wenn du nach ein oder zwei Minuten keine Events siehst, überprüfe den serverseitigen GTM-Debugger, um sicherzustellen, dass die Anfrage durchgegangen ist:

1. Wähle im serverseitigen Debugger das entsprechende Event, das du im Menü links prüfen möchtest.
2. Prüfe, ob dein Tag im Bereich „Ausgelöste Tags“ angezeigt wird. Wenn ja, siehst du entweder „Conversions API-Tag – Erfolgreich“ oder „Conversions API Tag – Fehlgeschlagen“.
   • Tag nicht ausgelöst: Überprüfe deinen Conversions API-Tag-Trigger und den relevanten GA4-Event-Trigger im Webcontainer. Prüfe, ob das GA4-Event im Web-Debugger ausgelöst wurde.
   • Tag-Auslösung: Erfolgreich: Klicke auf das Tag und überprüfe, ob der Test-Event-Code richtig ist. Aktualisiere den Test-Event-Code falls erforderlich und starte den Vorschaumodus neu.
   • Tag ausgelöst: Fehlgeschlagen: Öffne das Tab „Anfrage“ und klicke auf die ausgehende Anfrage, die an https://graph.facebook.com gesendet wurde. Überprüfe den Antwortinhalt unten in den Anfragendetails, um den vorliegenden Fehler zu ermitteln, und aktualisiere deine Integration gegebenenfalls. Denke daran, den Vorschaumodus neu zu starten, nachdem du Änderungen vorgenommen hast.

Sobald Events angezeigt werden, vergewissere dich, dass die Event-IDs für jedes Event richtig gesendet werden und dass alle erwarteten Abgleichsschlüssel und selbstdefinierten Datenparameter richtig angezeigt werden. Das Test-Event-Tool zeigt dir, ob Events richtig dedupliziert werden. Wenn die Event-IDs sich unterscheiden, stelle sicher, dass die GA4- und Meta-Pixel-Tags vom selben Trigger ausgelöst werden, und überprüfe deine Variablenimplementierung für die Event-ID.

Deduplizierung

Wir empfehlen dir, eine redundante Event-Einrichtung zu verwenden und dieselben Events von der Conversions API als auch von deinem Meta-Pixel zu übernehmen. Stelle sicher, dass beide Events den identischen event_name verwenden und entweder event_id oder eine Kombination von external_id und fbp enthalten sind.

Dies hilft Meta, Events zu deduplizieren und die doppelte Meldung identischer Events zu reduzieren. Erfahre mehr über die Deduplizierung, wann sie notwendig ist und wie du sie einrichten kannst. external_id und fbp sind alternative Lösungen zur Deduplizierung und helfen auch zur Verbesserung der Qualität der Einrichtung. Wir empfehlen, diese drei Parameter, wann immer möglich, aufzunehmen.

GTM kann auf mehrere Weisen Parameter mit demselben Wert für einen Browser-Tag und einen Server-Tag einrichten. Eine der Möglichkeiten besteht darin, dasselbe GA4-Event als Trigger zu verwenden, um ein Meta-Pixel-Tag und ein Server-Event auszulösen. Das geht so:

• Verwende denselben Trigger für dein selbstdefiniertes HTML-Tag und GA4-Event-Tag. Ein Beispiel: Du kannst eine Bedingung für die Event-Auslösung definieren, die auf der Seiten-URL der Bestellbestätigung basiert.
• Verwende in beiden Tags dieselbe event_id:

  1. Lege eine individuelle ID aus dem Client fest: Lege einen selbstdefinierten Parameter (x-fb-event_id) aus dem gtag-Event fest. Erstelle eine individuelle ID (pro Event) auf der Website mit einer Javascript-Methode (oder mit der selbstdefinierten Javascript-Variable von Google Tag Manager) und setze den Wert des Events wie folgt fest:

  gtag('event', 'purchase', {
   'x-fb-event_id': generateEventId(),
  ...:...
  
   });

  Du kannst eine Variable erstellen, die auf das oben angezeigte selbstdefinierte Javascript hinweist. Wann immer auf die „var“ verwiesen wird, wird das folgende Javascript in der Zeile geladen:

  function() {
  var gtmData = window.google_tag_manager[{{Container ID}}].dataLayer.get('gtm');
  return gtmData.start + '.' + gtmData.uniqueEventId;
  }

  2. Erstelle und fülle eine Datenschichtvariable aus: Du kannst eine eigene Variable im Webcontainer erstellen, um den Wert von event_id zu lesen. Du kannst dies tun, indem du eine neue Datenschichtvariable erstellst – z. B. FBEventIdVar, mit eventModel.event_id als Datenschichtvariablennamen.
  3. Sobald die Variable festgelegt ist, verfügst du über die Variable, die du sowohl für das Web-Event deines selbstdefinierten HTML-Tags verwenden kannst als auch für das Server-Event als zusätzlichen GA4-Event-Parameter.
  4. Im Web kannst du deinen Meta-Tag in Google Tag Manager-Webcontainern einrichten, um event_id aus einer Variable zu lesen.

  fbq('track', Purchase, {..}, {eventID: FBEventIDVar });

  Konfiguriere das GA4-Event, um einen zusätzlichen Parameter namens event_id zu senden, der auf die Variable FBEventIdVar festgelegt wird.

Selbstdefinierte Datenparameter

Um selbstdefinierte Daten zu senden, verwende die folgenden Zuordnungen in deinen GA4-Event-Tags:

Daten von deiner Website an deinen GCP-Server senden

Nachdem du deine Web- und Servercontainer konfiguriert hast, kannst du ein Test-Event von deiner Website aus übermitteln, um das Server-Event zu verifizieren. Ein Test-Event mit konfigurierten Parametern sieht möglicherweise in etwa so aus:

 gtag('event', 'purchase', 
  {
    'event_id': generateEventId(),
    'transaction_id': 't_12345',
    'currency': 'USD',
    'value': 1.23,
    user_data: {
      email_address: '<HASHED_DATA>',
      phone_number: '<HASHED_DATA>',
      address: {
        first_name: '<HASHED_DATA>',
        last_name: '<HASHED_DATA>',
        city: '<HASHED DATA>',
        region: '<HASHED_DATA>',
        postal_code: '<HASHED_DATA>',
        country: '<HASHED_DATA>'     
      },    
    },
    items: [
      {
        item_id: '1',
        item_name: 'foo',
        quantity: 5,
        price: 123.45,
        item_category: 'bar',
        item_brand: 'baz'     
      }
    ], 
  });      
     

Sobald das Event ausgelöst wurde, kannst du eine Anfrage mit den konfigurierten Parametern an den Beispiel-Link www.analytics.example.com/g/collect senden. Du kannst einen Test-Eventcode zum Meta Conversions API-Tag hinzufügen, um Events zu verifizieren, die an die Conversions API gesendet werden. Der Test-Event-Code sollte nur zum Testen verwendet werden. Du musst dieses Feld entfernen, wenn du deine Produktions-Payload sendest.

Nachdem du deine Änderungen veröffentlicht hast, verwende die Seite Verifizierung deiner Einrichtung, um sicherzustellen, dass deine Events richtig gesendet werden. Überprüfe diesen Artikel zur Conversions API und prüfe, ob die Integrationsqualität unseren Best Practices entspricht

Häufig gestellte Fragen

Wird geplant, die Möglichkeit hinzuzufügen, selbstdefinierte Parameter zu senden? Wenn ja, wann wird dies verfügbar sein?
A: Wir haben die meisten selbstdefinierten Standardparameter der Conversions API hinzugefügt, die im GTM-Schema unterstützt werden. Wir haben auch die selbstdefinierte Zuordnung bereitgestellt. Weitere Informationen findest du hier.

Ist ein einziger Server oder Cluster in der Lage, mehrere Container zu betreiben?
A: Derzeit unterstützt GTM nur die 1:1-Zuordnung. Hier findest du Empfehlungen zur Organisation deiner Container.

Benötigt der serverseitige GTM ein browserbasiertes Tag, um Events zu senden?
A: Ja

Ist es möglich, GA4 von der serverseitigen Integration getrennt zu halten?
A: Um eine separate GA4- und serverseitige GTM-Integration auszuführen, kannst du eine zusätzliche Mess-ID in Google Analytics erstellen. Erstelle ein separates GA4-Konfigurations-Tag für den serverseitigen GTM mit dieser Mess-ID und folge den oben genannten Schritten. In diesem Szenario wird dein vorhandenes GA4-Konfigurations-Tag weiterhin GA-Traffic über den Webcontainer senden, während das neue Konfigurations-Tag Daten an den Servercontainer sendet. Erstelle zusätzliche GA4-Event-Tags gemäß Schritt 2, um mit dem neuen Konfigurations-Tag Events serverseitig zu senden.

Funktioniert die GTM Conversions API-Integration mit anderen Cloud-Hosting-Lösungen als GCP?
A: Die GTM Conversions API-Integration sollte mit GCP oder einer anderen Plattform deiner Wahl funktionieren. Hier erfährst du mehr über die manuelle Bereitstellung.

Mehr dazu

• Conversions API
• Deduplizierung für Meta-Pixel- und Conversions API-Events