Google-Tag in Ihr CMS oder Ihren Website-Builder einbinden

Das Google-Tag ist ein Code-Snippet, das einer Website hinzugefügt werden kann, um die Nutzeraktivität in einer Vielzahl von Google-Produkten zu messen, darunter Google Analytics, Google Ads und Google Marketing Platform. Weitere Informationen zum Google-Tag.

In dieser Anleitung wird beschrieben, wie Sie das Google-Tag in Ihr Content-Management-System (CMS) oder Ihren Website-Builder einbinden, um Ihren Endnutzern Zugriff auf die Analyseprodukte von Google zu ermöglichen.

Zielgruppe

Diese Anleitung richtet sich an Inhaber von Content-Management-Systemen (CMS) oder Website-Builder, die ihren Nutzern eine Einbindung in die Analyseprodukte von Google ermöglichen möchten. Sie ist nicht für Nutzer eines CMS oder Website-Builders gedacht.

Hinweis

Sie benötigen eine Google-Tag-Entwickler-ID. Wenn Sie keine Google-Tag Entwickler-ID haben, füllen Sie das Antragsformular für die Google-Tag-Entwickler-ID aus. Ihre Entwickler-ID unterscheidet sich von anderen IDs wie der Mess-ID oder der Conversion-ID, die Ihre Endnutzer ihrem Website-Messcode hinzufügen.

Übersicht

So binden Sie Ihre Plattform in Google-Produkte ein:

  1. Einbindung mit dem Google-Tag erstellen
  2. Struktur der Nutzereingabe aktualisieren
  3. API für den Einwilligungsmodus implementieren
  4. Ereignisdaten einrichten
  5. Aktualisierte Einbindung überprüfen
  6. Anleitung zur Bereitstellung für Nutzer aktualisieren

Einbindung mit dem Google-Tag erstellen

Wenn Sie eine Einbindung mit dem Google-Tag erstellen, können Ihre Kunden Google-Analyseprodukte (über gtag.js) auf jeder Seite ihrer Website bereitstellen. Entfernen Sie alle vorhandenen Legacy-Tag-Einbindungen (z. B. analytics.js), bevor Sie eine Einbindung mit gtag.js erstellen.

Ersetzen Sie Ihr vorhandenes Code-Snippet durch das folgende, um eine Einbindung mit dem Google-Tag zu erstellen. Nutzer müssen TAG_ID durch ihre eigene Tag-ID ersetzen können.

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=GOOGLE_TAG_ID"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('set', 'developer_id.<developer ID>', true); // Replace with your Google tag Developer ID
  gtag('js', new Date());

  gtag('config', 'GOOGLE_TAG_ID');
</script>

Wichtige Hinweise:

  • Werbetreibende können die Funktionen zur Anzeigenpersonalisierung wie Remarketing mit dem allow_ad_personalization_signals Parameter deaktivieren (siehe Erfassung personalisierter Werbedaten deaktivieren.
  • Im Idealfall sollte das Google-Tag-Snippet nur einmal pro Seite vorkommen. Das Snippet kann mehrere Tag-IDs enthalten. Wenn eine Instanz von gtag.js vorhanden ist, sollten Sie neue Tag-IDs dem vorhandenen Tag hinzufügen. Weitere Informationen.

Struktur der Nutzereingabe aktualisieren

Ihre Kunden sollten über eine einzige Benutzeroberfläche mehrere Formen ihrer Google-Tag-ID angeben können, unabhängig davon, welches Google-Analyseprodukt sie bereitstellen.

Das folgende Beispiel zeigt eine einfache Google-Tag-Eingabe. Die Einbindung sollte als Bereitstellung für das Google-Tag dargestellt werden. Sie kann als Methode zur Bereitstellung von Google Ads und Google Analytics bezeichnet werden.

Eingabefeld für die Google-Tag-ID

Alternativ zeigt das folgende Diagramm, wie eine Plattform separate Nutzerflows für Analytics und Ads haben kann. Jeder Flow führt jedoch zu einer Benutzeroberfläche, auf der Nutzer ihre Google-Tag-ID angeben.

Analytics und Ads führen zu einem Eingabefluss

Die Tag-ID-Eingabe sollte mehrere ID-Varianten mit dem regulären Ausdruck [A-Z]{1,3}\\w{5,}[\w]* akzeptieren.

Das Google-Tag enthält eine integrierte Consent API zur Verwaltung der Nutzereinwilligung. Sie kann zwischen der Nutzereinwilligung für Cookies zu Werbezwecken und zu Analysezwecken unterscheiden.

Das erwartete Ergebnis ist, dass der Aufruf gtag('consent', 'update' {...}) ohne Maßnahmen des Kunden eingebunden wird. So können Google-Tags (Google Ads, Floodlight, Google Analytics, Conversion-Verknüpfung) den aktuellen Einwilligungsstatus des Nutzers lesen und in Netzwerkanfragen an Google einbeziehen (über den Parameter &gcs).

Zusätzliche Implementierungsschritte wären die Bereitstellung oder Unterstützung von Werbetreibenden bei der Bereitstellung des Status gtag('consent', default' {...}) und die Aufhebung der Blockierung von Google-Tags (d. h. keine zustimmungsbasierte bedingte Auslösung), damit sie im Einwilligungsmodus zustimmungsorientiert ausgelöst werden können.

Details zur Implementierung finden Sie unter Einstellungen für die Einwilligung verwalten (Web).

Ereignisdaten einrichten

Sie sollten umfangreiche Ereignisdaten von der Website des Kunden an sein Google-Konto senden, ohne dass der Kunde Maßnahmen ergreifen muss. Sie können beispielsweise die Ereignisse entlang eines Kauftrichters hinzufügen (z.B. add_to_cart, begin_checkout, add_payment_info, add_shipping_info und purchase), Lead-Generierung und Registrierungen.

Best Practices für das Hinzufügen von Ereignissen:

  • Alles protokollieren
  • Mindestens acht Kernereignisse einrichten
  • E‑Commerce-Ereignisse priorisieren

Alles protokollieren

Wenn möglich, sollten Sie Ereignisse standardmäßig einrichten. Dazu zählen:

  • Schlüsselereignisse wie purchase oder sign_up
  • Ereignisse vor Schlüsselereignissen wie add_to_cart
  • Verhaltensbezogene Interaktionen wie Medieninteraktionen, mit denen Kunden nachvollziehen können, wie sie mit ihren Endnutzern interagieren

Sie sollten Schlüsselereignis-Snippets nur auf Seiten mit Schlüsselereignissen hinzufügen (z.B. Kaufbestätigung, Bestätigung der Formulareinreichung). Das Google-Tag muss jedoch auf jeder Seite der Website eingefügt werden.

Ereignisse werden mit dem event Befehl gesendet. Dazu gehört dieselbe Google-Tag-Entwickler-ID, die Sie oben im allgemeinen Website-Tag angegeben haben:

gtag('event', 'my_event', {
  'developer_id.<developer ID>': true,
  // Additional event parameters
});

Mit dem Befehl event können Sie beispielsweise ein login-Ereignis mit dem Wert „Google“ für method senden:

gtag('event', 'login', {
  'developer_id.<developer ID>': true,
  'method': 'Google'
});
<!-- Event snippet for sales conversion page -->
<script>
  gtag('event', 'conversion', {
      'developer_id.<developer ID>': true,
      'value': <value>,
      'currency': '<currency>',
      'transaction_id': '<transaction_id>'
  });
</script>

Wichtige Hinweise:

  • Ihre Entwickler-ID <developer ID> ist eindeutig und spezifisch für Ihre Plattform. Fügen Sie sie jedem Ereignis hinzu.
  • Die folgenden Parameter sind optional und können weggelassen werden:
    • 'value' ist der numerische Wert des Schlüsselereignisses (z. B. der Preis eines Kaufs).
    • 'currency' ist ein dreistelliger Währungscode, der für Werbetreibende nützlich ist, die mehrere Währungen akzeptieren.
    • 'transaction_id' ist eine eindeutige ID für die Transaktion (z. B. eine Bestell-ID). Sie wird zur Deduplizierung verwendet.
  • Einige Parameter sind zwar optional, es wird jedoch empfohlen, so viele Informationen wie möglich für jedes Ereignis anzugeben.
    • Parameter geben Aufschluss darüber, wie Nutzer mit Ihrer Website oder App interagieren. Wenn sich ein Nutzer beispielsweise eines Ihrer Produkte ansieht, können Sie Parameter einbinden, die Informationen zum entsprechenden Produkt enthalten, z. B. den Namen, die Kategorie und den Preis.
    • Von einigen Parametern werden automatisch Daten für die vordefinierten Dimensionen und Messwerte in Google Analytics zur Verfügung gestellt, sodass Nutzer ihre Kunden besser verstehen.

Wenn Sie ein Schlüsselereignis basierend auf einem Klick messen möchten (z.B. ein Klick auf eine Schaltfläche oder eine dynamische Antwort für eine Website mit AJAX), können Sie auch das folgende Snippet verwenden:

<!-- Event snippet for sales conversion page
    In your HTML page, add the snippet and call gtag_report_conversion
    when someone clicks on the chosen link or button. -->
<script>
  function gtag_report_conversion(url) {
  var callback = function () {
    if (typeof(url) != 'undefined') {
      window.location = url;
    }
  };
  gtag('event', 'conversion', {
    'developer_id.<developer ID>': true,
    'value': <value>,
    'currency': '<currency>',
    'transaction_id': '<transaction_id>',
    'event_callback': callback
  });
  return false;
}
</script>

Mindestens acht Kernereignisse einrichten

Wir empfehlen, eine Reihe von Kernereignissen einzurichten, die für Websiteinhaber am wertvollsten sind. Mindestens die folgenden Ereignisse sollten eingerichtet werden:

  • view_item_list: wenn ein Nutzer eine Liste von Artikeln aufruft (z.B. eine Produktliste). Weitere Informationen

    gtag('event', 'view_item_list', {
      item_list_id: "related_products",
      item_list_name: "Related products",
      items: [{
        item_id: "SKU_123",
        item_name: "Test Item",
        currency: "USD",
        discount: 2.22,
        price: 99.9,
        quantity: 1
      }]
    });
    
  • add_to_cart: wenn ein Nutzer einen oder mehrere Artikel in einen Einkaufswagen legt. Weitere Informationen

    gtag('event', 'add_to_cart', {
      value: 99.0,
      currency: "USD",
      items: [{
        item_id: "SKU_123",
        item_name: "Test Product",
        price: 99.0,
        currency: 'USD',
        quantity: 1,
        item_category: "All Products"
      }]
    });
    
  • begin_checkout: wenn ein Nutzer den Checkout-Prozess für ein oder mehrere Produkte startet. Weitere Informationen

    gtag('event', 'begin_checkout') {
      value: 99.0,
      currency: "USD",
      items: [{
        item_id: "SKU_123",
        item_name: "Test Product",
        price: 99.0,
        currency: 'USD',
        quantity: 1,
        item_category: "All Products"
      }]
    });
    
  • purchase: wenn ein Nutzer ein oder mehrere Produkte oder Dienstleistungen kauft. Weitere Informationen

    gtag('event', 'purchase', {value: XX, currency: 'USD', items: [{xx},{xx}]});
    
  • sign_up: wenn sich ein Nutzer registriert, damit der Endnutzer die beliebtesten Registrierungsmethoden sehen kann (z.B. Google-Konto, E‑Mail-Adresse). Weitere Informationen

    gtag('event', 'sign_up', {method: 'web'});
    
  • generate_lead: wenn ein Nutzer ein Formular einreicht. Weitere Informationen

    gtag('event', 'generate_lead', {value: XX, currency: 'USD'});
    
  • subscribe: wenn ein Nutzer einen Dienst oder Newsletter abonniert.

    gtag('event', 'subscribe', {value: XX, currency: 'USD', coupon: 'XX'});
    
  • book_appointment: wenn ein Nutzer einen Termin bucht.

    gtag('event', 'book_appointment', {value: XX, currency: 'USD', coupon: 'XX'});
    

Weitere Empfehlungen

Google unterstützt viele weitere Ereignisse und Parameter, insbesondere für den E‑Commerce. Im Allgemeinen empfehlen wir, Folgendes zu erfassen:

  • Alle Erfolgsergebnisse, die direkt mit einem Wert verknüpft sind
  • Erfolgsergebnisse, die zu wichtigen Schlüsselereignissen beitragen (add_to_cart, sign_up usw.)
  • Interaktionen und Nutzerinteraktionen, mit denen Werbetreibende nachvollziehen können, wie sie mit ihren Endnutzern interagieren

Weitere Informationen zur Ereigniserfassung finden Sie in den folgenden Ressourcen:

Wir möchten potenzielle Erweiterungen dieses Schemas besprechen. Wenn Sie Vorschläge haben, teilen Sie uns diese bitte mit.

Aktualisierte Einbindung überprüfen

Bevor Sie Ihre Änderungen in der Produktion bereitstellen, prüfen Sie die Kompatibilität mit Folgendem:

  • Google-Tag mit einem Google Analytics-Ziel
  • Google-Tag für Remarketing und Conversion-Analyse

Prüfen Sie außerdem mit einem der folgenden Tools, ob das Tag auf allen Seiten, einschließlich der Seiten mit Schlüsselereignissen, richtig ausgelöst wird:

  • Google Tag Assistant: Mit dem Tag Assistant können Sie sehen, welche Google-Tags ausgelöst wurden und in welcher Reihenfolge. Im Debug-Modus erkennen Sie, welche Daten an die Datenschicht übergeben werden und welche Ereignisse diesen Datenaustausch ausgelöst haben.
  • Chrome-Entwicklertools: Filtern Sie auf dem Tab Netzwerk Anfragen, die „google“ enthalten, um zu prüfen, wie Daten gesendet werden.
  • (Serverseitiger) Google Analytics-Echtzeitbericht: Erstellen Sie ein kostenloses Google Analytics-Konto und prüfen Sie im Bericht Echtzeit, ob die Tag-Treffer von den Google-Servern empfangen werden.

Wenn Sie einen Fehler melden oder Feedback zu fehlenden Informationen geben möchten, füllen Sie das Formular für den Support für Content-Management-Systeme aus.

Wenn möglich, gewähren Sie Google Testzugriff für die laufende Überprüfung.

Anleitung zur Bereitstellung für Nutzer aktualisieren

Aktualisieren Sie Ihre Dokumentation, um eine klare Anleitung zur Implementierung von Google-Analyseprodukten mit Ihrer Implementierung zu geben. Senden Sie uns einen Entwurf dieser Anleitung über das Formular zur Überprüfung der Dokumentation zur Einrichtung der CMS-Einbindung , damit wir Ihnen Feedback geben können.