Mit Transformationen die für Tags verfügbaren Ereignisparameter steuern

Dieses Dokument richtet sich an Nutzer von Server-Side-Tagging, die steuern möchten, welche Ereignisparameter für Tags verfügbar gemacht werden.

Ein serverseitiger Container enthält einen Client , der eingehende HTTP-Anfragen akzeptiert. Die Informationen in der HTTP-Anfrage werden in ein Ereignisdatenobjekt übersetzt. Ihre Server-Side-Tags lesen das Ereignisdatenobjekt.

Was sind Transformationen?

Mit Transformationen können Sie Ereignisparameter, die von Ihrem Client ausgegeben werden, einbeziehen, ausschließen oder ändern, bevor sie für Tags verfügbar gemacht werden. So haben Sie die Möglichkeit, vertrauliche Informationen zu schützen und genau zu steuern, welche Ereignisparameter für die weitere Verarbeitung verfügbar sind.

Mit Transformationen können Sie Regeln erstellen, um Folgendes zu tun:

• Nur explizit definierte Ereignisparameter für Tags freigeben
• Ereignisparameter erweitern, indem Sie Regeln zum Bearbeiten oder Hinzufügen von Ereignisparametern erstellen
• Eingehende Informationen unkenntlich machen, indem Sie Ereignisparameter aus Tags ausschließen

Sie können eine Transformation auf alle Ihre Tags, gesamte Tag-Typen oder eine einzeln ausgewählte Gruppe anwenden. Außerdem können Sie eine Reihe von Bedingungen festlegen, die erfüllt sein müssen, bevor die Transformation ausgeführt wird.

Variablen werden jedes Mal ausgewertet, wenn eine Transformation ausgeführt wird. Je nachdem, was Ihre Transformationen tun, können Ihre Variablen unterschiedliche Werte annehmen.

Tags erlauben, Ereignisparameter zu verwenden

Mit der Transformation Parameter zulassen können Sie bestimmte Ereignisparameter angeben, die für Ihre Tags verfügbar gemacht werden sollen. Ereignisparameter, die nicht explizit definiert sind, werden verworfen.

So erlauben Sie Tags, bestimmte Ereignisparameter zu verwenden:

1. Öffnen Sie in Ihrem Arbeitsbereich das Menü Transformationen.
2. Erstellen Sie eine neue Transformationsregel.
3. Klicken Sie auf Transformationskonfiguration und wählen Sie Parameter zulassen aus.
4. Fügen Sie Ereignisparameter hinzu, die von Tags verwendet werden können. Alle gängigen Ereignis parameter ansehen.
5. Optional: Unter Bedingungen für Übereinstimmung können Sie Regeln dafür definieren, wann die Transformation aktiviert werden soll. Standardmäßig werden Transformationsregeln immer angewendet.
6. Wählen Sie unter Betroffene Tags die Tag-Typen oder einzelnen Tags aus, die auf diese Transformation sregel reagieren sollen. Standardmäßig wird die Transformation auf alle Tags angewendet.
7. Geben Sie der Transformationsregel einen Namen und speichern Sie sie.

Beispiel: Bestimmte Informationen in Ihrer BigQuery-Tabelle protokollieren

Wenn Sie steuern, welche Parameter protokolliert werden, haben Sie folgende Möglichkeiten:

• Sie können dafür sorgen, dass keine vertraulichen Informationen in Ihrem internen Datenspeicher protokolliert werden.
• Sie können eine übermäßige Protokollierung vermeiden und so Speicher- und Cloud-Kosten sparen.
• Sie können relevante Messwerte für Monitoring und Berichte speichern.

Anleitung

So lassen Sie nur bestimmte Parameter protokollieren:

1. Erstellen Sie eine neue Transformationsregel.
2. Klicken Sie auf Transformationskonfiguration und wählen Sie Parameter zulassen aus.
3. Fügen Sie unter Zulässige Parameter die benötigten Parameter hinzu, z. B. event_name, page_hostname, page_path, client_id usw.
4. Wählen Sie unter Betroffene Tags das Tag aus, das Daten an Ihr Data Warehouse sendet. Für BigQuery können Sie die addEventCallback und BigQuery APIs in einem benutzerdefinierten Tag verwenden oder in der Community-Galerie für Vorlagen nach vorgefertigten Optionen suchen, um Ihren Servercontainer zu überwachen.
5. Geben Sie der Transformation einen Namen und speichern Sie sie. Sie sollte so aussehen:

Ereignisparameter erweitern

Mit der Transformation Ereignis erweitern können Sie Werte von Ereignisparametern ändern oder neue Parameter hinzufügen, die für Tags verfügbar gemacht werden sollen.

So ändern oder fügen Sie bestimmte Ereignisparameter hinzu:

1. Öffnen Sie in Ihrem Arbeitsbereich das Menü Transformationen.
2. Erstellen Sie eine neue Transformationsregel.
3. Klicken Sie auf „Transformationskonfiguration“ und wählen Sie Ereignis erweitern aus.

4. Unter Zu erweiternde Parameter:

   • Wenn Sie vorhandene Ereignisparameter ändern möchten, geben Sie den Parameter, den Sie ändern möchten, unter Name ein und fügen Sie einen neuen Wert hinzu. Alle gängigen Ereignis parameter ansehen.

   • Wenn Sie einen neuen Wert für das Ereignisdatenobjekt hinzufügen möchten, geben Sie einen Namen und eine Variable Ihrer Wahl ein.

5. Optional: Unter Bedingungen für Übereinstimmung können Sie Regeln dafür definieren, wann die Transformation aktiviert werden soll. Standardmäßig werden Transformationsregeln immer angewendet.

6. Wählen Sie unter Betroffene Tags die Tag-Typen oder einzelnen Tags aus, die auf diese Transformation sregel reagieren sollen. Standardmäßig wird die Transformation auf alle Tags angewendet.

7. Geben Sie der Transformationsregel einen Namen und speichern Sie sie.

Beispiel: Wertbezogene Gebote für Kaufereignisse einrichten

Mit wertbezogenen Geboten können Sie die Kampagnenleistung verbessern, indem Sie Ihre Werbeausgaben so optimieren, dass Sie Nutzer ansprechen, die für Ihr Unternehmen einen höheren Wert haben. Sobald Sie wertbezogene Gebote eingerichtet haben, werden in Google Ads anhand Ihres Conversion-Werts Gebote festgelegt, die für Sie wertvoller sind. Die Transformation Ereignis erweitern ist nützlich, um wertbezogene Gebote serverseitig einzurichten.

Anleitung

Die folgende Anleitung gilt nur, wenn im Conversion-Tracking-Tag von Google Ads kein Conversion-Wert angegeben ist.

So richten Sie wertbezogene Gebote ein:

1. Erstellen Sie eine neue Transformationsregel.
2. Klicken Sie auf Transformationskonfiguration und wählen Sie Ereignis erweitern aus.
3. Fügen Sie unter Zu erweiternde Parameter eine neue Zeile hinzu. Richten Sie eine Variable ein, um den Geldwert Ihres Artikels in die Transformation zu laden:
   1. Geben Sie unter Name den Namen des Werts ein, den Sie anpassen möchten, z. B. value. Ersetzen Sie alle value-Felder, da sie den Geldwert eines Ereignisses darstellen.
   2. Konfigurieren Sie unter Wert eine Variable, die Preise aus Ihrer Datenbank abruft. Wenn Sie beispielsweise Produktdaten in Firestore speichern, fügen Sie eine Variable für die Firestore-Suche hinzu.
4. Legen Sie unter Bedingungen für Übereinstimmung fest, dass diese Transformation nur auf bestimmte Ereignisse angewendet werden soll. Wenn Sie wertbezogene Gebote nur für Kaufereignisse anwenden möchten, legen Sie Folgendes fest: {{Event Name}} entspricht purchase.
5. Fügen Sie unter Betroffene Tags alle Google Ads-Conversion-Tracking-Tags hinzu, auf die diese Transformation angewendet werden soll.
6. Geben Sie Ihrem Tag einen Namen und speichern Sie ihn. Er sollte so aussehen:

Ereignisparameter aus Tags ausschließen

Die Transformation Parameter ausschließen ist nützlich, um bestimmte Ereignisparameter aus Ihren Tags zu entfernen.

Achtung: Wenn die Parameter, die von Tags benötigt werden, ausgeschlossen werden, funktionieren die Tags möglicherweise nicht wie erwartet. Prüfen Sie, auf welche Parameter Ihre Tags angewiesen sind, bevor Sie Parameter transformieren.

So schließen Sie bestimmte Ereignisparameter aus Tags aus:

1. Öffnen Sie in Ihrem Arbeitsbereich das Menü Transformationen.
2. Erstellen Sie eine neue Transformationsregel.
3. Klicken Sie auf „Transformationskonfiguration“ und wählen Sie Parameter ausschließen aus.
4. Fügen Sie Ereignisparameter hinzu, die von Tags nicht verwendet werden können. Alle gängigen Ereignis parameter ansehen.
5. Optional: Unter Bedingungen für Übereinstimmung können Sie Regeln dafür definieren, wann die Transformation aktiviert werden soll. Standardmäßig werden Transformationsregeln immer angewendet.
6. Wählen Sie unter Betroffene Tags die Tag-Typen oder einzelnen Tags aus, die auf diese Transformation sregel reagieren sollen. Standardmäßig wird die Transformation auf alle Tags angewendet.
7. Geben Sie der Transformationsregel einen Namen und speichern Sie sie.

Beispiel: Bestimmte benutzerdefinierte Dimensionen von Google Analytics basierend auf der Nutzereinwilligung ausschließen

Mit der Transformation Parameter ausschließen können Sie steuern, welche Erstanbieterdaten an Google gesendet werden. Wenn ein Nutzer beispielsweise Cookies für analytics_storage ablehnt, können Sie bestimmte benutzerdefinierte Dimensionen entfernen.

Anleitung

So entfernen Sie eine benutzerdefinierte Dimension:

1. Erstellen Sie eine neue Transformationsregel.
2. Klicken Sie auf Transformationskonfiguration und wählen Sie Parameter ausschließen aus.
3. Fügen Sie unter Ausgeschlossene Parameter eine neue Zeile hinzu und legen Sie die benutzerdefinierten Dimensionen fest, die Sie ausschließen möchten, z. B. payment_type, payment_status.
4. Legen Sie unter Bedingungen für Übereinstimmung fest, dass die Transformation nur angewendet werden soll, wenn ein Nutzer analytics_storage Cookies ablehnt.
   Formulieren Sie die folgenden Bedingungen:
   • {{gcs}} entspricht G100
   • {{gcs}} entspricht G110
5. Optional: Fügen Sie unter Betroffene Tags alle Tags hinzu, auf die diese Transformation angewendet werden soll.
6. Geben Sie Ihrem Tag einen Namen und speichern Sie ihn. Er sollte so aussehen:

Prüfen, ob Ihre Transformationsregeln angewendet werden

Sie können Ihre Transformationsregeln prüfen, indem Sie eine Vorschau Ihres Arbeitsbereichs aufrufen:

1. Öffnen Sie Ihre Website.

2. Wählen Sie in Ihrem Google Tag Manager-Servercontainer Vorschau aus.

   Der Tag Assistant wird gestartet und lädt Ihren Servercontainer.

3. Wenn Sie alle Tags und Aktionen sehen möchten, die für ein Ereignis ausgelöst wurden, wählen Sie links einen Ereignisnamen aus der Liste aus.

Prüfen, ob eine Transformation ausgeführt wurde:

1. Öffnen Sie für das Ereignis, das Sie prüfen möchten, den Tab Tags.

2. Wählen Sie ein ausgelöstes Tag aus, um die Tag-Eigenschaften, ausgehenden HTTP-Anfragen, auslösenden Trigger und Transformationen aufzurufen.

   Hinweis: Transformationen wirken sich nur auf ausgelöste Tags aus. Eine Transformation kann dazu führen, dass ein Tag nicht ausgelöst wird, wenn sie erforderliche Ereignisparameterfelder ändert oder entfernt.

3. In der Übersicht Tag-Details sehen Sie, welche Transformationen für ein Tag ausgeführt wurden und in welcher Reihenfolge. Die Standardreihenfolge ist:

   1. Parameter zulassen
   2. Parameter erweitern
   3. Parameter ausschließen

   

4. Klicken Sie auf eine Transformation, um Details dazu aufzurufen. Die Ereignisparameter, die an das Tag übergeben wurden, werden im Bereich Ereignisdaten angezeigt.

   

5. Wenn Sie auf das Feld Ereignisdaten klicken, sehen Sie den Status der Ereignisparameter, nachdem alle Transformationen ausgeführt wurden. Wenn Sie sowohl die ursprünglichen als auch die transformierten Ereignisparameter sehen möchten, klicken Sie das Kästchen Original anzeigen an.