WPConsent
WPConsent

WPConsent-Dokumentation

Dokumentation, Referenzmaterialien und Tutorials für WPConsent

Auslösen von GTM-Tags auf Grundlage der Einwilligung

Möchten Sie, dass Ihre Google Tag Manager-Tags erst dann ausgelöst werden, wenn Besucher ihre Zustimmung gegeben haben? WPConsent überträgt ein benutzerdefiniertes Ereignis- und Präferenzobjekt an den GTM-Datenlayer, sodass Sie Trigger erstellen können, die die Entscheidungen jedes Besuchers berücksichtigen. Diese Anleitung führt Sie durch die Auslösung von GTM-Tags auf der Grundlage der Zustimmung mit WPConsent.

Inhaltsverzeichnis

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

  • Ein Google Tag Manager-Container, der auf Ihrer Website installiert ist
  • WPConsent mit aktiviertem Cookie-Banner installiert
  • Skriptblockierung in WPConsent >> Einstellungen aktiviert
  • Grundlegende Kenntnisse über GTM-Trigger und -Variablen

Das dataLayer-Ereignis verstehen

Jedes Mal, wenn eine Einwilligung verarbeitet wird, überträgt WPConsent das folgende Objekt an die Datenebene:

{
  'event': 'wpconsent_consent_processed',
  'wpconsentPreferences': {
    'essential': true,
    'statistics': true,
    'marketing': false
  }
}

Der Name der Veranstaltung lautet immer wpconsent_consent_processed. Das wpconsentPreferences Das Objekt enthält 1 boolesche Eigenschaft pro Cookie-Kategorie. Ein Wert von true bedeutet, dass der Besucher diese Kategorie akzeptiert hat. Ein Wert von false bedeutet, dass sie es abgelehnt haben.

Das essential Kategorie ist immer true da essentielle Cookies nicht deaktiviert werden können.

Dieses Ereignis wird in zwei Situationen ausgelöst:

  • Wenn ein Besucher zum ersten Mal mit dem Banner interagiert (akzeptiert, ablehnt oder Einstellungen speichert)
  • Bei nachfolgenden Seitenaufrufen, wenn bereits gespeicherte Einstellungen im Cookie vorhanden sind

Service-Level-Einstellungen

Wenn Dienste umschalten ist aktiviert in WPConsent >> Einstellungen >> Cookies, das wpconsentPreferences Das Objekt enthält neben den Kategorie-Slugs auch einzelne Service-Slugs:

{
  'event': 'wpconsent_consent_processed',
  'wpconsentPreferences': {
    'essential': true,
    'statistics': true,
    'marketing': false,
    'google-analytics': true,
    'facebook-pixel': false
  }
}

Service-Slugs sind die bereinigten Namen der einzelnen Dienste in Ihrer Cookie-Datenbank. Dies ermöglicht Ihnen eine detaillierte Kontrolle: Sie können ein Tag nur dann auslösen, wenn der jeweilige Dienst akzeptiert wird, und nicht, wenn die gesamte Kategorie akzeptiert wird.

Weitere Veranstaltungen

WPConsent sendet auch ein DOM. CustomEvent benannt wpconsent_consent_processed auf dem document Objekt. Dies ist unabhängig vom dataLayer-Push und nützlich, wenn Sie benutzerdefiniertes JavaScript außerhalb von GTM schreiben. Für die GTM-Konfiguration benötigen Sie nur das dataLayer-Ereignis.

Erstellen des benutzerdefinierten Ereignisauslösers

Öffnen Sie zunächst Ihren GTM-Container und erstellen Sie einen Trigger, der auf das WPConsent-Einwilligungsereignis wartet.

  1. Navigieren Sie zu „Trigger“ und klicken Sie auf „Neu“.
  2. Den Auslöser benennen WPConsent - Consent Processed.
  3. Klicken Sie auf „Triggerkonfiguration“ und wählen Sie „Benutzerdefiniertes Ereignis“ aus.
  4. Set Name der Veranstaltung zu wpconsent_consent_processed.
  5. Dieser Trigger wird bei allen benutzerdefinierten Ereignissen ausgelöst.
  6. Klicken Sie abschließend auf „Speichern“.

Konfiguration des benutzerdefinierten Ereignisauslösers von GTM

Dieser Trigger wird jedes Mal ausgelöst, wenn WPConsent das Zustimmungsereignis an die Datenebene übermittelt.

Erstellen von Datenebenenvariablen

Erstellen Sie anschließend eine GTM-Variable für jede Einwilligungskategorie, die Sie in Ihren Tag-Bedingungen überprüfen möchten.

Variable für Marketing-Einwilligung:

  1. Gehen Sie zu „Variablen“ und klicken Sie unter „Benutzerdefinierte Variablen“ auf „Neu “.
  2. Name DLV - Marketing Consent.
  3. Klicken Sie auf „Variable Konfiguration“ und wählen Sie „Datenebenenvariable“ aus.
  4. Set Datenschicht Variable Name zu wpconsentPreferences.marketing.
  5. Behalten Sie die Datenebenenversion als Version 2 bei.
  6. Klicken Sie dann auf „Speichern“.

GTM-Datenlayer-Variable für Marketing-Einwilligung

Statistik-Zustimmungsvariable:

Wiederholen Sie die gleichen Schritte mit diesen Werten:

  • Name: DLV - Statistics Consent
  • Datenebene Variable Name: wpconsentPreferences.statistics

Sie haben nun 2 Variablen, die Folgendes zurückgeben true oder false abhängig von den Einwilligungsoptionen des Besuchers.

Erstellen von Service-Level-Variablen (optional)

Für Service-Level-Variablen muss „Toggle Services“ unter „WPConsent >> Einstellungen“ aktiviert sein.

Wenn Sie die Zustimmung für einen bestimmten Dienst statt für eine ganze Kategorie überprüfen müssen, erstellen Sie eine Variable unter Verwendung des Dienst-Slugs.

Um beispielsweise speziell die Einwilligung für Google Analytics zu überprüfen:

  1. Erstellen Sie eine neue Datenebenenvariable.
  2. Name DLV - Google Analytics Consent.
  3. Set Datenschicht Variable Name zu wpconsentPreferences.google-analytics.
  4. Klicken Sie dann auf „Speichern“.

Ersetzen google-analytics mit dem Slug eines beliebigen Dienstes in Ihrer WPConsent-Cookie-Datenbank. Zu den gängigen Slugs gehören facebook-pixel, google-adsund hotjar.

Konfigurieren der Bedingungen für das Auslösen von Tags

Fügen Sie nun jedem Tag, für das eine Einwilligung erforderlich ist, den Auslöser und eine Einwilligungsbedingung hinzu.

Beispiel: Meta-Pixel-Tag

  1. Öffnen Sie Ihr Meta-Pixel-Tag in GTM.
  2. Entfernen Sie unter „Triggering“ alle vorhandenen Trigger (wie „All Pages“).
  3. Klicken Sie auf das Symbol „+“, um einen neuen Auslöser hinzuzufügen.
  4. Wählen Sie Ihre WPConsent - Consent Processed Auslöser.
  5. Ändern Dieser Auslöser wird von „Alle benutzerdefinierten Ereignisse“ auf „Einige benutzerdefinierte Ereignisse“ gesetzt.
  6. Fügen Sie die Bedingung hinzu: DLV - Marketing Consent entspricht true.
  7. Klicken Sie abschließend auf „Speichern“.

Tag-Auslösebedingung mit Zustimmungsprüfung

Das Meta-Pixel-Tag wird jetzt nur ausgelöst, wenn beide Bedingungen erfüllt sind:

  1. Das wpconsent_consent_processed Das Ereignis erscheint im Datenlayer.
  2. Der Besucher hat seine Zustimmung zum Marketing gegeben.

Beispiel: Google Analytics-Tag (ohne Einwilligungsmodus)

Wenn Sie den Google Consent Mode nicht verwenden und GA4 ausschließlich über GTM-Trigger steuern möchten:

  1. Öffnen Sie Ihr GA4-Konfigurations-Tag.
  2. Ersetzen Sie dessen Auslöser durch WPConsent - Consent Processed.
  3. Auf Feuer einstellen Einige benutzerdefinierte Ereignisse wo DLV - Statistics Consent entspricht true.
  4. Klicken Sie dann auf „Speichern“.

Tipp: Wenn Sie bereits den Google Consent Mode v2 verwenden, benötigen Sie keine GTM-Trigger für GA4- oder Google Ads-Tags. Der Consent Mode übernimmt dies automatisch.

Umgang mit wiederkehrenden Besuchern

Das wpconsent_consent_processed Das Ereignis wird bei jedem Laden der Seite ausgelöst, wenn gespeicherte Einstellungen vorhanden sind, nicht nur bei der ersten Interaktion mit dem Banner. Das bedeutet, dass Ihre Tag-Konfiguration aus dem vorherigen Schritt bereits wiederkehrende Besucher korrekt verarbeitet.

Wenn ein Besucher mit bestehenden Einwilligungspräferenzen auf Ihre Website zurückkehrt:

  1. WPConsent liest das gespeicherte Einstellungs-Cookie.
  2. Es drückt die wpconsent_consent_processed Ereignis mit den gespeicherten Einstellungen.
  3. GTM wertet Ihre Auslösebedingungen aus und löst die entsprechenden Tags aus.

Es sind keine zusätzlichen Trigger für Seitenaufrufe erforderlich.

WPConsent unterstützt zwei Ansätze zur Steuerung von Tags, die Sie auch kombiniert verwenden können.

Google-Zustimmungsmodus v2 steuert automatisch integrierte Google-Tags. Wenn diese Option aktiviert ist, setzt WPConsent die Standard-Einwilligungsstatus auf denied und aktualisiert sie auf granted wenn Besucher Cookies akzeptieren. Google-Tags passen ihr Verhalten dann automatisch an.

Am besten geeignet für: GA4, Google Ads und andere Google-Dienste, die den Zustimmungsmodus nativ unterstützen.

GTM-Trigger (dieser Leitfaden)

Mit benutzerdefinierten GTM-Triggern können Sie genau steuern, wann ein Tag ausgelöst wird. Sie legen die genauen Bedingungen fest.

Am besten geeignet für:

  • Nicht-Google-Tags (Meta Pixel, LinkedIn, TikTok, HubSpot usw.)
  • Service-Level-Kontrolle, bei der Sie einzelne Services und nicht Kategorien überprüfen müssen
  • Tags von Anbietern, die den Google Consent Mode nicht unterstützen
  • Situationen, in denen Sie genau sehen möchten, wann Tags im GTM-Vorschaumodus ausgelöst werden

Beides zusammen verwenden

Die empfohlene Konfiguration für die meisten Websites lautet:

  1. Aktivieren Sie den Google-Einwilligungsmodus v2 für Google-Tags.
  2. Verwenden Sie die GTM-Trigger aus diesem Leitfaden für alle Nicht-Google-Tags.

Google-Tags profitieren von der cookielosen Messung im Zustimmungsmodus, bei der bereits vor der Einwilligung anonymisierte Daten erfasst werden. Nicht-Google-Tags benötigen explizite Auslöser, da sie die Signale des Zustimmungsmodus nicht verstehen.

Überprüfen Ihrer Einrichtung

Testen Sie Ihre Einrichtung vor der Veröffentlichung im GTM-Vorschaumodus.

  1. Klicken Sie in Ihrem GTM-Arbeitsbereich auf „Vorschau “.
  2. Öffnen Sie Ihre Website in der Registerkarte „GTM-Debug-Browser“.
  3. Löschen Sie die Cookies Ihrer Website, um einen neuen Besucher zu simulieren.
  4. Laden Sie die Seite neu. Ihre Tracking-Tags sollten noch nicht ausgelöst werden.
  5. Akzeptieren Sie alle Cookies im WPConsent-Banner.
  6. Suchen Sie im GTM-Debugger nach dem wpconsent_consent_processed Veranstaltung in der Zusammenfassung Feld auf der linken Seite.
  7. Klicken Sie auf das Ereignis. In der Datenebene Registerkarte, überprüfen Sie die wpconsentPreferences Das Objekt zeigt die richtigen Werte an.
  8. Überprüfen Sie den Abschnitt „Tags Fired“, um sicherzustellen, dass Ihre Tags nach dem Zustimmungsereignis ausgelöst wurden.

Testen des Ablehnungsablaufs:

  1. Löschen Sie erneut die Cookies Ihrer Website und laden Sie die Seite neu.
  2. Alle Cookies (oder bestimmte Kategorien) im Banner ablehnen.
  3. Überprüfen Sie, ob Ihre Marketing-Tags nicht ausgelöst wurden.
  4. Überprüfen Sie, ob Statistik-Tags nur ausgelöst werden, wenn Sie die Statistikkategorie akzeptiert haben.

Testen eines wiederkehrenden Besuchers:

  1. Cookies akzeptieren und dann zu einer anderen Seite Ihrer Website navigieren.
  2. Bestätigen Sie die wpconsent_consent_processed Ereignis wird beim Laden der neuen Seite ausgelöst.
  3. Bestätigen Sie, dass Ihre Tags basierend auf den gespeicherten Einstellungen ausgelöst werden.

Fehlersuche

Stellen Sie sicher, dass Ihr Tag das WPConsent - Consent Processed Trigger mit einer Zustimmungsbedingung. Wenn das Tag noch ein Alle Seiten Trigger hinzugefügt, wird er beim Laden der Seite ausgelöst, bevor die Einwilligung verarbeitet wird. Entfernen Sie den Trigger „Alle Seiten“.

Datenebenenvariablen zeigen „undefiniert“ an

Das wpconsentPreferences Das Objekt existiert erst nach der Verarbeitung der Einwilligung im Datenlayer. Wenn Sie die Variable überprüfen, bevor der Besucher mit dem Banner interagiert (und keine gespeicherten Einstellungen vorhanden sind), gibt sie undefinedDies ist das erwartete Verhalten.

Überprüfen Sie, ob das Cookie-Banner von WPConsent aktiviert ist und die Skriptblockierung aktiv ist. Wenn das Banner deaktiviert ist, wird das Frontend-JavaScript nicht geladen und es werden keine dataLayer-Ereignisse übertragen.

Überprüfen Sie auch, ob Google Tag Manager nicht durch die automatische Skriptblockierung von WPConsent blockiert wird. GTM wird von der Blockierung ausgeschlossen, wenn der Google-Zustimmungsmodus aktiviert ist.

Service-Level-Variablen fehlen

Service-Level-Slugs erscheinen nur in der wpconsentPreferences Objekt, wenn Dienste umschalten ist aktiviert in WPConsent >> Einstellungen >> CookiesOhne diese Einstellung enthält das Objekt nur Eigenschaften auf Kategorieebene (essential, statistics, marketing).

Tags werden beim Laden der Seite ausgelöst, aber nicht beim Zustimmungsereignis (oder umgekehrt).

Das wpconsent_consent_processed Das Ereignis wird sowohl bei der ersten Zustimmung als auch beim späteren Laden der Seite mit gespeicherten Einstellungen ausgelöst. Wenn Sie feststellen, dass Tags nur in einem Szenario ausgelöst werden, überprüfen Sie Ihre Trigger-Konfiguration. Der Trigger muss auf Alle benutzerdefinierten Ereignisse oder Einige benutzerdefinierte Ereignisse mit einer Zustimmungsbedingung, die nicht auf eine bestimmte Seite beschränkt ist.

Häufig gestellte Fragen

Kann ich diesen Ansatz auch für Nicht-Google-Tags wie Meta Pixel oder TikTok verwenden?

Ja. Diese Anleitung funktioniert für alle Tags in GTM. Das dataLayer-Ereignis und die Variablen sind nicht spezifisch für Google. Sie können sie zur Steuerung von Meta Pixel, LinkedIn Insight, TikTok Pixel, HubSpot und allen anderen Tags verwenden.

Bei Google-Tags (GA4, Google Ads) verwaltet der Consent Mode die Einwilligung automatisch, sodass Sie keine GTM-Trigger benötigen. Bei Nicht-Google-Tags benötigen Sie weiterhin den in dieser Anleitung beschriebenen GTM-Trigger-Ansatz, da diese Anbieter keine Consent Mode-Signale unterstützen.

Warum zeigen meine Datenebenenvariablen „undefined“ an, bevor das Banner erscheint?

Das wpconsentPreferences Das Objekt existiert erst nach der Verarbeitung der Einwilligung im dataLayer. Bevor ein Besucher mit dem Banner interagiert (und wenn keine gespeicherten Einstellungen vorhanden sind), gibt die Variable undefinedIhre Tags werden nicht ausgelöst, da die Auslösebedingung nicht erfüllt ist.

Aktivieren Dienste umschalten in WPConsent >> Einstellungen. Erstellen Sie dann eine Datenebenenvariable unter Verwendung des Service-Slugs, z. B. wpconsentPreferences.google-analyticsSiehe die Erstellen von Service-Level-Variablen Abschnitt für Details.

Schlussfolgerung

Sie haben benutzerdefinierte GTM-Trigger eingerichtet, die Tags erst dann auslösen, wenn Besucher ihre Zustimmung über WPConsent erteilt haben. Ihre Tracking-Tags berücksichtigen nun die Cookie-Einstellungen jedes Besuchers, sodass Ihre Website konform bleibt und Sie dennoch die benötigten Daten erfassen können.

Informationen dazu, wie WPConsent Google-Tags automatisch verarbeitet, finden Sie in der Anleitung zum Einrichten des Google Consent Mode v2. Details dazu, wie WPConsent Skripte vor der Einwilligung blockiert, finden Sie in der Anleitung zum automatischen Blockieren von Skripten.

War dieser Artikel hilfreich?
Ja Nein

Verwandte Artikel

Wie können wir helfen?

Brauchen Sie Unterstützung?

Sie können die gesuchte Antwort nicht finden?
Kontakt zum Support

  

    Erhalten Sie kostenlose Tipps und Ressourcen direkt in Ihren Posteingang, zusammen mit über 50.000 anderen
  

  

    

    
      

  

  

    Folgen Sie uns