Google Floodlight-Tags

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

Mit dem serverseitigen Tag Manager können Sie Ihre Google Floodlight-Tags für Verkäufe und Zähler von der Webseite auf den Server verschieben. Wenn Sie diese Tags auf den Server verschieben, muss weniger Code auf der Seite ausgeführt werden. Außerdem werden so die Seitenladezeiten verkürzt.

Hinweis

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

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

Von Ihrem Floodlight-Konto können nur Conversion-Daten an Google Tag Manager gesendet werden, wenn Sie ein Tag vom Typ Conversion-Verknüpfung eingerichtet haben.

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

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

  1. Öffnen Sie im Arbeitsbereich des Servercontainers 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, bei dem das serverseitige Tag der Conversion-Verknüpfung ausgelöst wird.
    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. Details zum Tag vom Typ „Conversion-Verknüpfung“

Schritt 2: Floodlight-Tags einrichten

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

Floodlight-Zähler

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

  1. Wählen Sie im Arbeitsbereich des Servercontainers links auf der Seite das Menü Tags aus.
  2. Klicken Sie auf Neu, um ein neues Tag hinzuzufügen.

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

    Dialogfeld zum Auswählen eines Tag-Typs mit hervorgehobenem Floodlight-Zähler-Tag

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

    • Werbetreibenden-ID: Die Werbetreibenden-ID wird auf der Detailseite des Werbetreibenden direkt unter dem Namen des Werbetreibenden angezeigt. Sie können diesen Wert auch src= in einem generierten Floodlight-Tag-Snippet entnehmen.
    • Gruppen-Tag-String: Geben Sie in der Aktivitätstabelle die Aktivität an, mit der Sie arbeiten möchten, und suchen Sie in einer Spalte rechts nach dem Gruppen-Tag-String. Sie können diesen Wert auch type= in einem generierten 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 Spalte rechts nach dem Aktivitäts-Tag-String. Sie können diesen Wert auch cat= in einem generierten 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 innerhalb eines 24-Stunden-Zeitraums wird gezählt, d. h. von Mitternacht bis Mitternacht Eastern Time (USA).
    • Pro Sitzung: Pro Nutzer und Sitzung wird eine Conversion gezählt. 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 die Option Alle Seiten die beste Option.

    Dialogfeld zum Auswählen des Triggers mit hervorgehobenem Trigger „Alle Seiten“

  8. Geben Sie einen Tag-Namen ein und klicken Sie auf Speichern.

    Screenshot, auf dem das Feld für den Namen des Floodlight-Zähler-Tags in das Floodlight-Zähler-Tag geändert wurde

Floodlight-Verkäufe

So richten Sie ein Floodlight-Verkaufs-Tag ein:

  1. Wählen Sie im Arbeitsbereich des Servercontainers 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: Mit dem Floodlight-Verkaufs-Tag werden die folgenden Werte automatisch aus dem entsprechenden E-Commerce-Feld erfasst:

    *   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 in Campaign Manager 360 an. Klicken Sie auf Werbetreibende und dann auf den Namen des Werbetreibenden. Geben 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 direkt unter dem Namen des Werbetreibenden angezeigt. Sie können diesen Wert auch src= in einem generierten Floodlight-Tag-Snippet entnehmen.
    • Gruppen-Tag-String: Geben Sie in der Aktivitätstabelle die Aktivität an, mit der Sie arbeiten möchten, und suchen Sie in einer Spalte rechts nach dem Gruppen-Tag-String. Sie können diesen Wert auch type= in einem generierten 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 Spalte rechts nach dem Aktivitäts-Tag-String. Sie können diesen Wert auch cat= in einem generierten 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 innerhalb eines 24-Stunden-Zeitraums wird gezählt, d. h. von Mitternacht bis Mitternacht Eastern Time (USA).
    • Pro Sitzung: Pro Nutzer und Sitzung wird eine Conversion gezählt. 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 die Option Alle Seiten die beste Option.

  8. Geben Sie einen Tag-Namen ein und klicken Sie auf Speichern.

Optional: Erweiterte Conversions einrichten

Wenn Sie keine erweiterten Conversions verwenden, fahren Sie mit Einrichtung validieren fort.

So konfigurieren Sie erweiterte Conversions:

Variable für von Nutzern bereitgestellte Daten einrichten

Sie haben drei Möglichkeiten, erweiterte Conversions in Tag Manager zu implementieren. Sie müssen nur eine Option auswählen, um von Nutzern bereitgestellte Daten zu erheben.

Automatische Erfassung Manuelle Konfiguration Codekonfiguration
Erfassungsmethode Erfasst von Nutzern bereitgestellte Daten automatisch anhand des Codes Ihrer Website.

Wenn Sie steuern möchten, wo Eingaben erfasst werden, wählen Sie eine manuelle oder Codeeinrichtung.		 Geben Sie bestimmte CSS-Eigenschaften oder JavaScript-Variablen an, um von Nutzern bereitgestellte Daten zu erheben.

Wenn Sie die Kontrolle über die Datenformatierung und das Hashen übernehmen müssen, entscheiden Sie sich für die Codekonfiguration.		 Fügen Sie ein Code-Snippet auf Ihrer Website ein, über das gehashte Kundendaten zum Abgleich gesendet werden.
Diese Methode ist die beste Wahl, um die Genauigkeit erweiterter Conversions zu maximieren, da Sie bei jedem Auslösen des Conversion-Tags einheitlich formatierte Daten senden können.
Komplexität Einfach Medium Komplex
Ballkünste Keine besonderen Fähigkeiten erforderlich HTML und CSS Webentwicklung

Automatische Erfassung

  1. Klicken Sie in Ihrem Webcontainer auf das Menü Variablen.
  2. Erstellen Sie eine neue benutzerdefinierte Variable vom Typ Von Nutzern bereitgestellte Daten.
  3. Wählen Sie für den Typ die Option Automatische Erfassung aus.
  4. Benennen Sie die Variable, z. B. My user-defined data.
  5. Klicken Sie auf Speichern.

Manuelle Konfiguration

  1. Klicken Sie in Ihrem Webcontainer auf das Menü Variablen.
  2. Erstellen Sie eine neue benutzerdefinierte Variable vom Typ Von Nutzern bereitgestellte Daten.
  3. Legen Sie als Typ Manuelle Konfiguration fest.

  4. Fügen Sie für das entsprechende Datenfeld, das Sie über erweiterte Conversions bereitstellen möchten, eine neue oder vorhandene Variable hinzu.

  5. Wenn Sie ein Element aus dem DOM angeben möchten, erstellen Sie Neue Variable > Variablenkonfiguration > 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. Benennen Sie die Variable für das DOM-Element und speichern Sie sie. Sie sehen wieder die Einstellungen für Von Nutzern bereitgestellte Daten.

  9. Benennen Sie die Variable für Von Nutzern bereitgestellte Daten, 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 Google hashen, bevor die Daten die Server erreichen, oder vorab gehashte Daten. Wenn Sie vorab gehashte Daten senden möchten, codieren Sie die Daten mit hexadezimal codiertem SHA256. Geben Sie in jedem Fall 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 auf Ihrer Website als Schlüssel/Wert-Paare in einer JavaScript-Variablen. Beispiel:

    var leadsUserData = {
  'email': 'name@example.com',
  'phone_number': '+11234567890',
  '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 mithilfe von dataLayer.push() zusammen mit einem Ereignis. Beispiel:

    <script>
  dataLayer.push({
    'event': 'formSubmitted',
    'leadsUserData': {
      'email': 'name@example.com',
      'phone_number': '+11234567890',
      '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 jetzt in Google Tag Manager verfügbar.

So übertragen Sie vorab 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 mithilfe von dataLayer.push() zusammen mit einem Ereignis. Das folgende Beispiel zeigt eine Datenschichtimplementierung, 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 jetzt in Google Tag Manager verfügbar.

Schritt 2: Variable für von Nutzern bereitgestellte Daten erstellen

  1. Klicken Sie in Ihrem Webcontainer auf das Menü Variablen.
  2. Erstellen Sie eine neue benutzerdefinierte Variable vom Typ Von Nutzern bereitgestellte Daten.
  3. Legen Sie für Typ Code fest.
  4. Klicken Sie für das entsprechende Datenfeld, das Sie bereitstellen möchten, auf das Drop-down-Menü und wählen Sie Neue Variable aus.
  5. Klicken Sie unter Variablentyp auswählen auf Datenschichtvariable.
  6. Verweisen Sie in der Datenschichtvariablen auf Ihre gespeicherten Nutzerdaten. Beispiel: leadsUserData.
  7. Benennen Sie die Datenschichtvariable und klicken Sie auf Speichern. Sie sehen wieder die Einstellungen für Von Nutzern bereitgestellte Daten.
  8. Benennen Sie die Variable für Von Nutzern bereitgestellte Daten, 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, über das Daten an den Tagging-Server gesendet werden.
  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. Das Tag sollte wie folgt aussehen:

    Screenshot der endgültigen Google-Tag-Konfiguration, die auf die Variable für von Nutzern bereitgestellte Daten verweist

Serverseitiges Floodlight-Tag konfigurieren

Aktivieren Sie in Ihrem Servercontainer erweiterte Conversions im Floodlight-Verkaufs- oder Floodlight-Zähler-Tag.

  1. Klicken Sie das Kästchen Von Nutzern übermittelte Daten einbeziehen an.
    alt_text
  2. Klicken Sie auf Speichern, um die Änderungen zu speichern.

Optional: Umsatzwert

Im Floodlight-Verkaufs-Tag wird der Parameter value des Ereignisses als Standardwert verwendet, um den Umsatz zu berechnen. Wenn Sie eine andere Grundlage für die Berechnung des Umsatzwerts festlegen möchten, müssen Sie eine Variable einrichten, um Daten aus Ihrer Datenbank abzurufen und sie Ihrem Floodlight-Verkaufs-Tag zuzuweisen.

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 &lcub;&lcub;Firestore-Lookup.
  3. Geben Sie die Datenquellen für die Variable an.
  4. Benennen Sie die Variable zum Beispiel "Gewinnsuche" und speichern Sie sie.

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

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

  3. Im Abschnitt Eindeutige Parameter:

    • Wählen Sie als Datenquelle die Option Benutzerdefinierte Konfiguration aus.
    • Wählen Sie unter Umsatz die Variable aus, die Sie zuvor erstellt haben.
    • Geben Sie für Bestell-ID eine ID ein oder verwenden Sie eine Variable, um die Bestell-ID dynamisch auszufüllen.

    Floodlight-Verkaufs-Tracking mit Umsatzwert

  4. Speichern Sie das Tag.

Optional: Benutzerdefinierte Parameter

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

Google Tag Manager

Wenn Sie benutzerdefinierte Felder für Floodlight konfigurieren möchten, stellen Sie dem 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. Stellen Sie x-dc- voran, um zu signalisieren, dass die Übertragung an Floodlight erfolgt. Wenn Sie beispielsweise normalerweise match_id senden würden, ändern Sie es in x-dc-match_id.

    Konfiguration der Parameter „dc-“ im GA4-Web-Tag.

  4. Speichern Sie das Tag.

gtag.js

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

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

Schritt 3: Einrichtung überprüfen

Sobald Sie mit dem Senden von Daten mit dem Servercontainer beginnen, können Sie folgendermaßen prüfen, ob er ordnungsgemäß funktioniert:

  1. Öffnen Sie Ihre Website.
  2. Wählen Sie im Google Tag Manager-Servercontainer die Option Vorschau aus. Der Tag Assistant startet und lädt den Servercontainer.
  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 während der Datenübertragung an den Servercontainer aufgetreten sind. Suchen Sie nach Fehlern und beheben Sie sie.

Weitere Informationen zur Fehlerbehebung für Tag Manager-Container finden Sie in der Vorschau- und Debug-Hilfe.

Weitere Informationen

Sobald Ihr Floodlight-Tag wie beabsichtigt funktioniert, können Sie äquivalente Floodlight-Tags aus einem Webcontainer entfernen, um Datenduplikate zu vermeiden.