Google Floodlight-Tags

Dieser Artikel richtet sich an Entwickler, die Floodlight-Tags aus einem Tag Manager-Webcontainer in einen Servercontainer verschieben möchten.

Mit dem serverseitigen Tag Manager können Sie Ihre Google Floodlight-Verkaufs- und Zähler-Tags von der Webseite auf den Server verschieben. Wenn Sie diese Tags auf den Server verschieben, wird die Menge an Code reduziert, die auf der Seite ausgeführt werden muss, und die Ladezeiten der Seite werden verbessert.

Hinweis

Bevor Sie Tags auf Ihren Server verschieben können, müssen folgende Voraussetzungen erfüllt sein:

• Administratorzugriff auf Google Tag Manager und Floodlight
• Google Tag Manager eingerichtet und installiert
• Servercontainer eingerichtet
• Client Google Analytics: GA4 eingerichtet

Schritt 1: Tag „Conversion-Verknüpfung“ einrichten

Ihr Floodlight-Konto kann Conversion-Daten nur dann an Google Tag Manager senden, wenn Sie ein Tag vom Typ Conversion-Verknüpfung eingerichtet haben.

Wenn Sie bereits ein Tag vom Typ „ Conversion-Verknüpfung“ in Ihrem Servercontainer konfiguriert haben, können Sie diesen Schritt überspringen.

So richten Sie das Tag vom Typ Conversion-Verknüpfung ein:

1. Öffnen Sie in Ihrem Servercontainer-Arbeitsbereich links auf der Seite das Menü Tags.
2. Klicken Sie auf Neu , um ein neues Tag hinzuzufügen.
3. Wählen Sie den Tag-Typ Conversion-Verknüpfung aus.
4. Richten Sie den Trigger ein, der das serverseitige Tag vom Typ Conversion-Verknüpfung auslösen soll.
   In den meisten Fällen ist der Trigger Alle Seiten die beste Option.
5. Geben Sie einen Namen für das Tag ein und klicken Sie auf Speichern.

Schritt 2: Floodlight-Tags einrichten

Google Tag Manager unterstützt im Servercontainer Floodlight-Zähler-Tags und Floodlight-Verkaufs-Tags.

Floodlight-Zähler

So richten Sie ein Floodlight-Zähler -Tag ein:

1. Wählen Sie in Ihrem Servercontainer-Arbeitsbereich links auf der Seite das Menü Tags aus.
2. Klicken Sie auf Neu , um ein neues Tag hinzuzufügen.

3. Wählen Sie den Tag-Typ Floodlight-Zähler aus.

   

4. Damit die für die Tag-Konfiguration erforderlichen Werte erfasst werden können, öffnen Sie ein neues Browserfenster und melden Sie sich bei Campaign Manager 360 an. Klicken Sie auf Werbetreibende und anschließend auf den Namen des Werbetreibenden. Fügen Sie die folgenden Werte in das neue Tag Manager-Floodlight-Zähler-Tag ein:

   • Werbetreibenden-ID: Die Werbetreibenden-ID wird auf der Detailseite des Werbetreibenden unterhalb des Namens des Werbetreibenden angezeigt. Sie können diesen Wert auch src= in einem erzeugten Floodlight-Tag-Snippet entnehmen.
   • Gruppen-Tag-String: Geben Sie in der Aktivitätstabelle die Aktivität an, die Sie verwenden möchten, und suchen Sie in einer der Spalten rechts nach dem Gruppen-Tag-String. Sie können diesen Wert auch type= in einem erzeugten Floodlight-Tag-Snippet entnehmen.
   • Aktivitäts-Tag-String: Geben Sie in der Aktivitätstabelle die Aktivität an, die Sie verwenden möchten, und suchen Sie in einer der Spalten rechts nach dem Aktivitäts-Tag String. Sie können diesen Wert auch cat= in einem erzeugten Floodlight-Tag-Snippet entnehmen.

5. Legen Sie die gewünschte Zählmethode fest:

   • Standard: Jede Conversion wird gezählt.
   • Eindeutig: Die erste Conversion eines einzelnen Nutzers wird erfasst innerhalb eines 24-Stunden-Zeitraums, das heißt von Mitternacht bis Mitternacht Eastern Time (USA).
   • Pro Sitzung: Pro Nutzer und Sitzung wird eine Conversion berücksichtigt. Die Länge der Sitzung wird durch die Website vorgegeben, auf der das Floodlight-Tag eingesetzt wird.

6. Öffnen Sie das Fenster Trigger auswählen.

7. Wählen Sie im Menü Triggerkonfiguration einen Trigger aus. In den meisten Fällen ist Alle Seiten die beste Option.

   

8. Geben Sie einen Namen für das Tag ein und klicken Sie auf Speichern.

   

Floodlight-Verkäufe

So richten Sie ein Floodlight-Verkaufs -Tag ein:

1. Wählen Sie in Ihrem Servercontainer-Arbeitsbereich links auf der Seite das Menü Tags aus.
2. Klicken Sie auf Neu , um ein neues Tag hinzuzufügen.

3. Wählen Sie den Tag-Typ Floodlight-Verkäufe aus. Hinweis: Das Floodlight-Verkäufe Tag erfasst die folgenden Werte automatisch aus dem entsprechenden E-Commerce-Feld:

   *   Order ID (Transaction ID)
   *   Revenue (Value)
   

4. Damit die für die Tag-Konfiguration erforderlichen Werte erfasst werden können, öffnen Sie ein neues Browserfenster und melden Sie sich bei Campaign Manager 360 an. Klicken Sie auf Werbetreibende und anschließend auf den Namen des Werbetreibenden. Fügen Sie die folgenden Werte in das neue Tag Manager-Floodlight-Zähler-Tag ein:

   • Werbetreibenden-ID: Die Werbetreibenden-ID wird auf der Detailseite des Werbetreibenden unterhalb des Namens des Werbetreibenden angezeigt. Sie können diesen Wert auch src= in einem erzeugten Floodlight-Tag-Snippet entnehmen.
   • Gruppen-Tag-String: Geben Sie in der Aktivitätstabelle die Aktivität an, die Sie verwenden möchten, und suchen Sie in einer der Spalten rechts nach dem Gruppen-Tag-String. Sie können diesen Wert auch type= in einem erzeugten Floodlight-Tag-Snippet entnehmen.
   • Aktivitäts-Tag-String: Geben Sie in der Aktivitätstabelle die Aktivität an, die Sie verwenden möchten, und suchen Sie in einer der Spalten rechts nach dem Aktivitäts-Tag String. Sie können diesen Wert auch cat= in einem erzeugten Floodlight-Tag-Snippet entnehmen.

5. Legen Sie die gewünschte Zählmethode fest:

   • Standard: Jede Conversion wird gezählt.
   • Eindeutig: Die erste Conversion eines einzelnen Nutzers wird erfasst innerhalb eines 24-Stunden-Zeitraums, das heißt von Mitternacht bis Mitternacht Eastern Time (USA).
   • Pro Sitzung: Pro Nutzer und Sitzung wird eine Conversion berücksichtigt. Die Länge der Sitzung wird durch die Website vorgegeben, auf der das Floodlight-Tag eingesetzt wird.

6. Öffnen Sie das Fenster Trigger auswählen.

7. Wählen Sie im Menü Triggerkonfiguration einen Trigger aus. In den meisten Fällen ist Alle Seiten die beste Option.

8. Geben Sie einen Namen für das Tag ein und klicken Sie auf Speichern.

Optional: Conversions mit Warenkorbdaten einrichten

Sie können Ihr Floodlight-Verkaufs-Tag so konfigurieren, dass Conversions mit Warenkorbdaten gesendet werden. Die Funktion „Conversions mit Warenkorbdaten“ liefert detaillierte Informationen zu Conversion-Ereignissen auf SKU-Ebene. Wenn Sie die Händler-ID, das Feedlabel, die Feedsprache und Produktdaten senden, lässt sich feststellen, welche Artikel sich gut verkaufen und welche möglicherweise stärker gefördert werden müssen.

Schritt 1 von 2: Warenkorbdaten-Parameter an die Datenschicht senden

1. Erstellen Sie ein ecommerce.purchase.products-JSON-Array. Beispiel:

       'ecommerce':{
       'purchase':{
           'products': [{
               'id': 'String',
               'price': 'Floating point',
               'quantity': Integer,
               'country': 'String', // Optional
               'accountId': 'String' // Optional
           },
           {
               … // Each SKU (product) in the transaction
               // is in its own array item.
           }]
       }
       }'
   

2. Wenden Sie die dataLayer.push Methode an, um die Daten in der Datenschicht von Google Tag Manager verfügbar zu machen.

Schritt 2 von 2: Floodlight-Verkaufs-Tag konfigurieren

Ereignisdaten

1. Öffnen Sie in Ihrem Servercontainer das Floodlight-Verkaufs-Tag.
2. Klicken Sie unter „Produktberichte“ das Kästchen Verkaufsdaten auf Produktebene angeben an.
3. Wählen Sie im Drop-down-Menü „Datenquelle“ die Option Ereignisdaten aus. Google Tag Manager verwendet automatisch die Daten, die an die Datenschicht im Array ecommerce.purchase.products weitergeleitet werden.
4. Klicken Sie auf Speichern.

Benutzerdefinierte Konfiguration

1. Öffnen Sie in Ihrem Servercontainer das Floodlight-Verkaufs-Tag.
2. Klicken Sie unter „Produktberichte“ das Kästchen Verkaufsdaten auf Produktebene angeben an.
3. Wählen Sie im Drop-down-Menü „Datenquelle“ die Option Benutzerdefinierte Konfiguration aus.
4. Wählen Sie eine dynamische Variable aus oder geben Sie in die folgenden Felder manuell einen Wert ein:
   • Produktdaten: Das ist der formatierte String, der die Produktdaten enthält.
   • Händler-ID: Google Merchant Center-ID des Einzelhändlers
   • Feedlabel: Label zur Identifizierung des spezifischen Feeds, der in Google Merchant Center verwendet wird
   • Sprache des Feeds: Sprache des Feeds, dargestellt mit dem zweistelligen ISO 639-1-Code
5. Klicken Sie auf Speichern.

Hinweis: Sie müssen die Anforderungen für Conversions mit Warenkorbdaten erfüllen, um diese Funktion vollständig nutzen zu können.

Optional: Erweiterte Conversions einrichten

Wenn Sie erweiterte Conversions nicht verwenden, fahren Sie mit dem Abschnitt Einrichtung überprüfen fort.

So konfigurieren Sie erweiterte Conversions:

Variable vom Typ „Von Nutzern bereitgestellte Daten“ einrichten

Sie können erweiterte Conversions in Tag Manager auf drei Arten implementieren: Sie müssen nur eine Option auswählen, um von Nutzern bereitgestellte Daten zu erheben.

	Automatische Erfassung	Manuelle Konfiguration	Codekonfiguration
Erfassungsmethode	Erfasst automatisch von Nutzern bereitgestellte Daten basierend auf dem Code Ihrer Website. Wenn Sie festlegen möchten, wo Eingaben erfasst werden, wählen Sie eine manuelle Einrichtung oder Codeeinrichtung aus.	Geben Sie ausgewählte CSS-Eigenschaften oder JavaScript-Variablen an, um von Nutzern bereitgestellte Daten zu erheben. Wenn Sie die Datenformatierung und das Hashing selbst steuern möchten, wählen Sie die Codekonfiguration aus.	Fügen Sie in Ihrer Website ein Code-Snippet ein, über das gehashte Kundendaten zum Abgleich gesendet werden. Diese Methode ist die beste Wahl, um die Genauigkeit der erweiterten Conversions zu maximieren. Denn es wird dafür gesorgt, dass beim Auslösen des Conversion-Tags konsequent formatierte Daten gesendet werden.
Komplexität	Einfach	Mittel	Komplex
Fähigkeiten	Keine besonderen Kenntnisse erforderlich	HTML und CSS	Webentwicklung

Automatische Erfassung

1. Öffnen Sie in Ihrem Webcontainer das Menü Variablen.
2. Erstellen Sie eine neue benutzerdefinierte Variable vom Typ Von Nutzern bereitgestellte Daten.
3. Legen Sie für Typ die Option Automatische Erfassung fest.
4. Geben Sie einen Namen für die Variable ein, z. B. My user-defined data.
5. Klicken Sie auf Speichern.

Manuelle Konfiguration

1. Öffnen Sie in Ihrem Webcontainer das Menü Variablen.
2. Erstellen Sie eine neue benutzerdefinierte Variable vom Typ Von Nutzern bereitgestellte Daten.
3. Legen Sie für Typ die Option Manuelle Konfiguration fest.

4. Fügen Sie für das relevante Nutzerdatenfeld, das Sie für erweiterte Conversions verwenden möchten, eine neue oder vorhandene Variable hinzu.

   Hinweis: Wenn Ihre Datenschicht bereits Variablen enthält (unabhängig davon, ob Sie CSS-Selektoren oder andere Variablentypen verwenden), können Sie sie auswählen, statt neue Variablen zu erstellen. Wenn Sie sich nicht sicher sind, folgen Sie der Anleitung. Die Variablen können gehasht oder nicht gehasht sein.

5. Wenn Sie ein Element aus dem DOM angeben möchten, erstellen Sie eine Neue Variable > Variable konfigurieren > DOM-Element.

6. Unter Auswahlmethode können Sie entweder einen CSS-Selektor oder eine ID verwenden. Tipp: Wenn sich Ihre CSS-Variablen häufig ändern, fügen Sie Ihrer Website eine HTML-ID hinzu und verwenden Sie die ID-Variable.

7. Geben Sie den CSS-Selektor oder den ID-Namen ein. Sie können das Feld „Attributname“ leer lassen.

8. Geben Sie einen Namen für die Variable „DOM-Element“ ein und klicken Sie auf Speichern. Sie kehren dann zum Bildschirm mit den Einstellungen für von Nutzern bereitgestellte Daten zurück.

9. Geben Sie der Variable Von Nutzern bereitgestellte Daten einen Namen, z. B. My user-defined data.

10. Klicken Sie auf Speichern.

Codekonfiguration

Schritt 1: Variablen für erweiterte Conversions ermitteln und festlegen

Sie können entweder nicht gehashte Daten senden, die vom Google-System gehasht werden sollen, bevor sie auf den Servern eingehen, oder vorab gehashte Daten senden. Wenn Sie vorab gehashte Daten senden, verwenden Sie Hex-SHA256. Geben Sie in beiden Fällen mindestens eines der folgenden Felder an: „email“ oder „phone_number“.
So übertragen Sie nicht gehashte Daten in die Datenschicht:

1. Speichern Sie von Nutzern bereitgestellte Daten als Schlüssel/Wert-Paare in einer JavaScript-Variablen auf Ihrer Website. Beispiel:

   var leadsUserData = {
     'email': '[e-mail]',
     'phone_number': '[phone]',
     'address': {
       first_name: 'John',
       last_name: 'Doe',
       street: '123 Lemon',
       city: 'Some city',
       region: 'CA',
       country: 'US',
       postal_code: '12345',
     },
   };
   

2. Senden Sie die Nutzerdaten zusammen mit einem Ereignis mithilfe von „dataLayer.push()“. Beispiel:

   <script>
     dataLayer.push({
       'event': 'formSubmitted',
       'leadsUserData': {
         'email': '[e-mail]',
         'phone_number': '[phone]',
         'address': {
            first_name: 'John',
            last_name: 'Doe',
            street: '123 Lemon',
            city: 'Some city',
            region: 'CA',
            country: 'US',
           postal_code: '12345',
          },
        },
     });
   <script>
   

Die Variable leadsUserData ist nun in Google Tag Manager verfügbar.

So übertragen Sie vorher gehashte Daten in die Datenschicht:

1. Hashen Sie auf Ihrer Website vom Nutzer bereitgestellte Daten mithilfe von hex-codiertem SHA256. Der Schlüssel für codierte Daten muss mit sha256_ beginnen. Beispiel:

   {'sha256_email_address':await hashEmail(email.trim()),
   }
   

2. Senden Sie die Nutzerdaten zusammen mit einem Ereignis mithilfe von dataLayer.push(). Im Beispiel unten wird eine Datenebene implementiert, bei der davon ausgegangen wird, dass Sie selbst eine Hash-Funktion geschrieben haben, die Sie asynchron ausführen.

   <script>
     dataLayer.push({
       'event': 'formSubmitted',
       'leadsUserData': {
         'sha256_email_address': await hashEmail(email.trim()),
         'sha256_phone_number': await hashPhoneNumber(phoneNumber),
         'address': {
           sha265_first_name: await hashString(firstname),
           sha256_last_name: await hashString(lastname),
           sha256_street: await hashString(streetAddress),
           postal_code: '12345',
          },
        },
     });
   <script>
   

Die Variable leadsUserData ist nun in Google Tag Manager verfügbar.

Schritt 2: Variable vom Typ „Von Nutzern bereitgestellte Daten“ erstellen

1. Öffnen Sie in Ihrem Webcontainer das Menü Variablen.
2. Erstellen Sie eine neue benutzerdefinierte Variable vom Typ Von Nutzern bereitgestellte Daten.
3. Legen Sie für Typ die Option Code fest.
4. Klicken Sie für das relevante Nutzerdatenfeld, das Sie bereitstellen möchten, auf das Drop-down-Menü und wählen Sie Neue Variable aus.
5. Wählen Sie unter Variablentyp auswählen die Option Datenschichtvariable aus.
6. Verweisen Sie in der Datenschichtvariablen auf Ihre gespeicherten Nutzerdaten. Beispiel: leadsUserData.
7. Geben Sie einen Namen für die Datenschichtvariable ein und klicken Sie auf Speichern. Sie kehren dann zum Bildschirm mit den Einstellungen für von Nutzern bereitgestellte Daten zurück.
8. Geben Sie der Variable Von Nutzern bereitgestellte Daten einen Namen, z. B. My user-defined data.
9. Klicken Sie auf Speichern.

Variable dem Google-Tag zuweisen

1. Öffnen Sie in Ihrem Webcontainer das Menü Tags.
2. Bearbeiten Sie das Google-Tag , mit dem Sie Daten an den Tagging-Server senden.
3. Fügen Sie unter Konfigurationseinstellungen einen neuen Konfigurationsparameter mit dem Namen user_data hinzu. Legen Sie für Wert die Variable Von Nutzern bereitgestellte Daten fest, z. B. {{My user-provided data}}.

4. Speichern Sie die Änderungen. Ihr Tag sollte so aussehen:

   

Serverseitiges Floodlight-Tag konfigurieren

Aktivieren Sie in Ihrem Servercontainer erweiterte Conversions, indem Sie das Floodlight-Verkaufs- oder Floodlight-Zähler-Tag einrichten.

Hinweis: Wenn die Floodlight-Tags ausgelöst werden, werden alle verfügbaren Conversion- Daten an Google gesendet, einschließlich aller von Nutzern bereitgestellten Daten. Wenn Sie Ereignisparameter ändern oder ausschließen möchten, bevor das Tag ausgelöst wird, konfigurieren und verwenden Sie die entsprechenden Transformationen und fügen Sie sie Ihrem Tag hinzu.

Mithilfe der von Nutzern bereitgestellten Daten lässt sich die Messgenauigkeit verbessern. Dabei werden auf Ihrer Website erhobene gehashte eigene Nutzerdaten gesendet. Dazu müssen Sie zuerst die Nutzungsbedingungen und Richtlinien für von Nutzern bereitgestellte Daten in Ihrem Search Ads 360-Konto akzeptieren.

Wenn Sie von Nutzern bereitgestellte Daten für erweiterte Conversions für das Web einbeziehen möchten, sollten personenbezogene Daten (Personally Identifiable Information, PII) von der Website (clientseitiger Container) gesendet werden, die wiederum vom serverseitigen Container weitergeleitet werden. Wenn Sie nicht möchten, dass die PII von einem bestimmten Tag weitergeleitet werden, verwenden Sie Transformationen, um die PII für die ausgewählten Tags zu entfernen.

Optional: Umsatzwert

Das Floodlight-Verkaufs-Tag verwendet den Parameter value des Ereignisses als Standardbetrag zur Berechnung des Umsatzes. Wenn Sie eine andere Grundlage für die Berechnung des Umsatzwerts angeben möchten, müssen Sie eine Variable einrichten, um Daten aus Ihrer Datenbank in abzurufen und sie Ihrem Floodlight-Verkaufs-Tag zuzuweisen.

Hinweis: Der Servercontainer verschlüsselt den Umsatzwert, damit Conversion-Daten nicht offengelegt werden, wenn der Server Daten an den Browser zurücksendet.

So erstellen Sie eine neue Variable:

1. Öffnen Sie in Ihrem Servercontainer das Menü Variablen.
2. Erstellen Sie eine neue benutzerdefinierte Variable für die Dateneingabe. Wenn Sie beispielsweise einen Wert aus einer Firestore-Datenbank verwenden möchten, erstellen Sie eine Variable vom Typ „{{Firestore-Suche}}“.
3. Geben Sie die Datenquellen für die Variable an.
4. Geben Sie einen Namen für die Variable ein, z. B. „Gewinnsuche“, und klicken Sie auf Speichern.

So verwenden Sie die Variable im Floodlight-Verkaufs-Tag:

1. Öffnen Sie in Ihrem Servercontainer das Menü Tags.
2. Bearbeiten Sie das Tag Floodlight-Verkäufe.

3. Im Bereich Eindeutige Parameter:

   • Wählen Sie für Datenquelle die Option Benutzerdefinierte Konfiguration aus.
   • Wählen Sie für Umsatz die zuvor erstellte Variable aus.
   • Geben Sie für Bestell-ID eine ID ein oder verwenden Sie eine Variable, um die Bestell-ID dynamisch zu generieren.

   

4. Speichern Sie das Tag.

Optional: Benutzerdefinierte Parameter

Sie können benutzerdefinierte Felder von Ihrer Webseite an die Google Marketing Platform übergeben, z. B. match_id.

Google Tag Manager

Wenn Sie benutzerdefinierte Felder für Floodlight konfigurieren möchten, stellen Sie einem Parameternamen x-dc- voran:

1. Öffnen Sie in Ihrem Webcontainer das Menü Tags.
2. Bearbeiten Sie ein GA4-Ereignis-Tag oder erstellen Sie ein neues.

3. Fügen Sie unter Ereignisparameter den Parameternamen hinzu. Um zu signalisieren, dass er an Floodlight gesendet wird, stellen Sie x-dc- voran. Wenn Sie normalerweise match_id senden würden, ändern Sie es beispielsweise in x-dc-match_id.

   

4. Speichern Sie das Tag.

gtag.js

Wenn Sie benutzerdefinierte Felder für Floodlight konfigurieren möchten, stellen Sie x-dc- dem Namen des Ereignis parameters voran:

  gtag('event', 'purchase', {
      'x-dc-match_id': [MATCH_ID],
      ...
  })

Schritt 3: Einrichtung überprüfen

Sobald Sie Daten mit dem Servercontainer senden, können Sie so prüfen, ob er ordnungsgemäß funktioniert:

1. Öffnen Sie Ihre Website.
2. Wählen Sie in Ihrem Google Tag Manager-Servercontainer die Option Vorschau aus. Der Tag Assistant wird gestartet und Ihr Servercontainer wird geladen.
3. Auf dem Tab Tags werden alle ausgelösten Tags angezeigt. Prüfen Sie, ob das von Ihnen konfigurierte Tag ausgelöst wurde.
4. Auf dem Tab Konsole werden alle Fehler angezeigt, die bei der Datenübertragung an den Servercontainer aufgetreten sind. Prüfen Sie, ob Fehler aufgetreten sind, und beheben Sie sie.

Weitere Informationen zur Fehlerbehebung bei Tag Manager-Containern finden Sie in der Hilfe zur Vorschau und Fehlerbehebung.

Nächste Schritte

Sobald Ihr Floodlight-Tag wie gewünscht funktioniert, können Sie alle entsprechenden Floodlight-Tags in einem Webcontainer entfernen, um Datendopplungen zu vermeiden.