Fehlerbehebung beim Einwilligungsmodus mit dem Tag Assistant

Dieser Artikel richtet sich an Entwickler und Administratoren, die die Implementierung des Einwilligungsmodus auf ihrer Website überprüfen und Fehler beheben möchten. Informationen zur TCF-Implementierung auf Websites finden Sie unter Fehlerbehebung bei TCF. Anleitungen zum Überprüfen von App-Implementierungen finden Sie für Android und iOS.

Sie können die Implementierung des Einwilligungsmodus in folgenden Fällen überprüfen:

• Ob auf Ihrer Website der richtige standardmäßige Einwilligungsstatus festgelegt wird, bevor Tags ausgelöst werden. Die richtige Standardeinstellung hängt von den Richtlinien Ihrer Organisation ab.
• Ob der Einwilligungsstatus auf Ihrer Website richtig aktualisiert wird, wenn Besucher ihre Einwilligung geben bzw. verweigern.
• Welche Tags welche Einwilligungsarten prüfen.
• Ob die erforderlichen Einwilligungsarten beim Auslösen der einzelnen Tags gewährt wurden und ob das Tag die Prüfungen auf zusätzliche erforderliche Einwilligungen bestanden hat.

Tag Assistant unterstützt die folgenden Einwilligungsmechanismen:

• gtag-Befehle consent
• Tags, die mit einer Tag Manager-Vorlage für den Einwilligungsmodus erstellt wurden
• Transparency and Consent Framework (TCF)

Hinweis

Sie können Tag Assistant in allen Browsern verwenden. Die besten Ergebnisse bei der Fehlerbehebung erzielen Sie, wenn Sie Google Chrome verwenden und die Browsererweiterung Tag Assistant Companion installieren.

Funktionsweise des Einwilligungsmodus überprüfen

So führen Sie das Debugging des Einwilligungsmodus durch: Wenn Sie regionsspezifische Standardeinstellungen oder Einwilligungsbanner festgelegt haben, wiederholen Sie diese Schritte mit anderen simulierten geografischen Standorten. Informationen zum Festlegen von Standorten in Chrome

gtag.js

Wenn Sie die Einrichtung des Einwilligungsmodus für Websites überprüfen möchten, starten Sie eine neue Sitzung im Tag Assistant:

1. Öffnen Sie den Google Tag Assistant.

2. Geben Sie die URL Ihrer Website ein. Ihre Website wird in einem neuen Tab geöffnet.

   Hinweis :Falls im Tag Assistant die Meldung Could not connect angezeigt wird, wird das Laden Ihres Google-Tags möglicherweise blockiert.

3. Öffnen Sie auf Ihrer Website das Cookie-Banner und akzeptieren Sie alle Parameter.

   Hinweis :Wenn Ihr Google-Tag blockiert wurde, sollte der Tag Assistant jetzt eine Verbindung zu Ihrer Website herstellen können.

4. Prüfen Sie im Tag Assistant, ob die Standardeinwilligung für die Seite richtig festgelegt ist:

   1. Wählen Sie unter Summary das früheste Ereignis vom Typ Consent aus.
   2. Prüfen Sie im Bereich API Call, ob die folgenden Parameter festgelegt wurden: ad_storage, ad_personalization, ad_user_data, analytics_storage.

   3. Alternativ können Sie im Bereich Output Ihres Tags den Tab Consent öffnen und in der Spalte On-page Default nachsehen.

      

5. So überprüfen Sie, ob die Einwilligung auf der Seite auf Grundlage Ihrer Interaktion mit dem Einwilligungsbanner aktualisiert wurde:

   1. Wählen Sie unter Summary das neueste Ereignis vom Typ Consent aus.
   2. Prüfen Sie im Bereich API-Aufruf, ob die folgenden Parameter aktualisiert wurden: ad_storage, ad_personalization, ad_user_data, analytics_storage.

   3. Alternativ können Sie im Bereich Output Ihres Tags den Tab Consent öffnen und in der Spalte On-page Update nachsehen.

      

Tag Manager

Wenn Sie die Einrichtung des Einwilligungsmodus für Websites überprüfen möchten, starten Sie eine neue Sitzung im Tag Assistant:

1. Öffnen Sie den Google Tag Assistant.

2. Geben Sie die URL Ihrer Website ein. Ihre Website wird in einem neuen Tab geöffnet.

   Hinweis :Falls im Tag Assistant die Meldung Could not connect angezeigt wird, wird das Laden Ihres Tag Manager-Containers möglicherweise blockiert.

3. Öffnen Sie auf Ihrer Website das Cookie-Banner und akzeptieren Sie alle Cookies.

   Hinweis :Wenn Ihr Container blockiert wurde, sollte der Tag Assistant jetzt eine Verbindung zu Ihrer Website herstellen können.

4. Prüfen Sie im Tag Assistant, ob die Standardeinwilligung für die Seite richtig festgelegt ist:

   1. Wählen Sie unter Summary das früheste Ereignis vom Typ Consent aus.
   2. Prüfen Sie im Bereich API Call, ob die folgenden Parameter festgelegt wurden: ad_storage, ad_personalization,, ad_user_data, analytics_storage.

   3. Alternativ können Sie im Bereich Output Ihres Tags den Tab Consent öffnen und in der Spalte On-page Default nachsehen.

      

5. So überprüfen Sie, ob die Einwilligung auf der Seite auf Grundlage Ihrer Interaktion mit dem Einwilligungsbanner aktualisiert wurde:

   1. Wählen Sie unter Summary das neueste Ereignis vom Typ Consent aus.
   2. Prüfen Sie im Bereich API-Aufruf, ob die folgenden Parameter aktualisiert wurden: ad_storage, ad_personalization, ad_user_data, analytics_storage.

   3. Alternativ können Sie im Bereich Output Ihres Tags den Tab Consent öffnen und in der Spalte On-page Update nachsehen.

      

6. Sehen Sie nach, welche Tags ausgelöst oder durch den Einwilligungsstatus blockiert wurden:

   1. Wählen Sie unter Summary den Tab Tags aus.
   2. Klicken Sie auf ein Tag, um zu sehen, ob es sich entsprechend den Einwilligungseinstellungen verhalten hat.

Probleme mit der Einwilligungskonfiguration beheben

Wählen Sie ein Problem aus, um eine Anleitung zur Fehlerbehebung zu erhalten:

• Tab „Einwilligung“ leer
• Standardeinwilligung nicht festgelegt
• Standardeinwilligung wird zu spät festgelegt
• Einwilligungsstatus wird nicht aktualisiert
• Einwilligungsstatus wird nicht an regionale Einstellungen angepasst

Tab „Einwilligung“ leer

Der Tag Assistant-Tab Einwilligung ist leer, wenn der Einwilligungsmodus nicht auf der Seite implementiert ist.

Probleme beim Laden des Einwilligungsmodus beheben

Um das Problem zu beheben, müssen Sie den Einwilligungsmodus implementieren. In der folgenden Anleitung wird davon ausgegangen, dass Sie bereits ein Einwilligungsbanner auf Ihrer Website haben.

gtag.js

Video: Einwilligungmodus einrichten

Hinweis :Der Einwilligungsmodus wurde im November 2023 aktualisiert. Legen Sie die folgenden Einwilligungsparameter fest:

gtag('consent', 'default', {
      'ad_storage': 'denied',
      'analytics_storage': 'denied',
      'ad_user_data': 'denied',
      'ad_personalization': 'denied',
});

Schritt-für-Schritt-Anleitung: Einwilligungsmodus einrichten

Gehen Sie so vor, falls Sie eine Plattform zur Einwilligungsverwaltung (Consent Management Platform, CMP) zum Laden eines Einwilligungsbanners verwenden:

1. Finden Sie heraus, ob Ihre CMP den Einwilligungsmodus von Google unterstützt.
2. Rufen Sie die CMP-Einstellungen auf, um den Google-Einwilligungsmodus zu aktivieren.
3. Überprüfen Sie, ob der Einwilligungsmodus funktioniert.

Wenn Sie ein eigenes Einwilligungsbanner verwenden oder Ihre CMP nicht automatisch in den Einwilligungsmodus eingebunden wird, müssen Sie den Einwilligungsmodus manuell implementieren.

Tag Manager

Wenn Sie Tag Manager verwenden, empfehlen wir, den Einwilligungsmodus mit einer Einwilligungsplattform zu implementieren, die eine Tag Manager-Vorlage bereitstellt. So richten Sie ein Einwilligungsbanner mit Tag Manager ein:

1. Google Tag Manager öffnen
2. Öffnen Sie in Ihrem Arbeitsbereich das Menü Tags.
3. Wählen Sie Neu aus, um ein Tag zu erstellen. Klicken Sie auf Tag-Konfiguration und öffnen Sie die Galerie für Community-Vorlagen.
4. Suchen Sie nach dem Tag Ihres CMP-Anbieters und klicken Sie auf Zum Arbeitsbereich hinzufügen.
5. Füllen Sie die Felder in Ihrer Tag-Vorlage aus. Weitere Informationen zu den erforderlichen Feldern erhalten Sie von Ihrem CMP-Anbieter.
6. Wählen Sie unter „Trigger“ den Trigger Initialisierung der Einwilligung – Alle Seiten aus.
7. Speichern Sie das Tag und sehen Sie sich eine Vorschau Ihres Containers an, um zu prüfen, ob der Einwilligungsmodus funktioniert.

Wenn Sie ein eigenes Einwilligungsbanner verwenden oder Ihre CMP nicht automatisch in den Einwilligungsmodus eingebunden wird, müssen Sie den Einwilligungsmodus manuell implementieren.

Standardeinwilligung nicht festgelegt

Wenn Sie eine Standardeinwilligung für alle Parameter des Einwilligungsmodus festlegen, können Sie die Funktionsweise des Tags basierend auf der standardmäßigen Implementierung des Einwilligungsbanners effizient verwalten. Weitere Informationen zu den Einwilligungsanforderungen von Google

Problemlösung: Standardeinwilligung nicht festgelegt

gtag.js

Verschieben Sie den gesamten Code, mit dem gtag-Standardbefehle für die Einwilligung aufgerufen werden, weiter nach oben auf der Seite, über alle Tag-Snippets oder anderen Code, mit denen die Einwilligung verwendet wird.

Legen Sie die folgenden Einwilligungsparameter fest:

gtag('consent', 'default', {
      'ad_storage': 'denied',
      'analytics_storage': 'denied',
      'ad_user_data': 'denied',
      'ad_personalization': 'denied',
});

Legen Sie keine asynchronen Standardstatus für die Einwilligung fest.

Tag Manager

Wenn Sie in Tag Manager eine CMP-Tag-Vorlage verwenden, lesen Sie in der CMP-Dokumentation nach, wie Sie die Standardeinwilligung mit der Tag Manager-Vorlage festlegen.

Das Tag muss Standardwerte für die Einwilligung für mindestens die folgenden vier Parameter laden:

• ad_storage
• ad_user_data
• ad_personalization
• analytics_storage

Wenn Sie ein eigenes Einwilligungsbanner verwenden oder Ihre CMP nicht automatisch in den Einwilligungsmodus eingebunden wird, müssen Sie den Einwilligungsmodus manuell implementieren.

Standardeinwilligung wird zu spät festgelegt

Auf der Website muss der standardmäßige Einwilligungsstatus festgelegt werden, bevor Tags oder anderer Code die Einwilligung verwenden oder aktualisieren. Wird er zu spät festgelegt, wird möglicherweise nicht die erwartete Wirkung erzielt. Weitere Informationen zu den Einwilligungsanforderungen von Google

Im folgenden Szenario hat das Anzeigen-Tag beispielsweise bereits ein Cookie gelesen oder geschrieben, bevor die Standardeinwilligung festgelegt wurde:

1. Besucher öffnet Seite
2. Auslösung von Anzeigen-Tags
3. Standardeinwilligung auf „Verweigert“ festgelegt

Tag Assistant meldet einen Fehler:

Probleme beim Festlegen der Standardeinwilligung beheben

gtag.js

Verschieben Sie den gesamten Code, mit dem gtag-Standardbefehle für die Einwilligung aufgerufen werden, weiter nach oben auf der Seite, über alle Tag-Snippets oder anderen Code, mit denen die Einwilligung verwendet wird.

Legen Sie die folgenden Einwilligungsparameter fest:

gtag('consent', 'default', {
      'ad_storage': 'denied',
      'analytics_storage': 'denied',
      'ad_user_data': 'denied',
      'ad_personalization': 'denied',
});

Legen Sie keine asynchronen Standardstatus für die Einwilligung fest.

Tag Manager

Wenn ein Tag für eine Einwilligungsvorlage die Standardeinwilligung festgelegt hat:

1. Bearbeiten Sie den Trigger des Tag-Vorlagentags, mit dem die Einwilligung geschrieben wird, sodass er bei der Initialisierung der Einwilligung ausgelöst wird.
2. Alle anderen Tags: Lösen Sie die Tags aus, nachdem die Einwilligung initialisiert wurde. Wenn Sie beispielsweise ein Tag beim Seitenaufbau auslösen möchten, verwenden Sie den Trigger Initialisierung – Alle Seiten.

Achtung: Verwenden Sie in Tag Manager kein benutzerdefiniertes HTML-Tag, um den Befehl gtag consent aufzurufen. Legen Sie stattdessen Einwilligungsstatus mit einem Vorlagentag fest, das die API für benutzerdefinierte Vorlagen verwendet.

Einwilligungsstatus wird nicht aktualisiert

Wenn ein Websitebesucher mit Ihrem Einwilligungsbanner interagiert, sollte ein update-Befehl für die Einwilligung gesendet werden. Falls der Einwilligungsstatus nicht aktualisiert wird, prüfen Sie, ob Sie einen entsprechenden Mechanismus implementiert haben.

Probleme mit dem Einwilligungsmodus beheben

gtag.js

Verwenden Sie den gtag.js-Befehl update, um den Einwilligungsstatus zu aktualisieren, nachdem ein Besucher mit Ihrem Banner interagiert hat. Sie müssen für jeden Parameter, für den Sie einen Einwilligungsstandard festlegen, einen Aktualisierungsmechanismus haben. Außerdem muss ein Nutzer seine Einwilligung sowohl für granted als auch für denied aktualisieren können.

Im folgenden Beispiel wird gezeigt, wie die Funktion consentGrantedAdStorage den Einwilligungsstatus aktualisiert, wenn ein Besucher im Einwilligungsbanner Werbe-Cookies akzeptiert.

<script>
function consentGrantedAdStorage() {
  gtag('consent', 'update', {
    'ad_storage': 'granted'
  });
  }
</script>
<!-- Invoke your consent function when a user interacts with your banner -->
<body>
  ...
  <button onclick="consentGrantedAdStorage()">Yes</button>
  ...
</body>

Tag Manager

Wenn Sie ein Tag für eine Einwilligungsvorlage verwenden, um die Standardeinstellung für die Einwilligung festzulegen, muss damit auch der Einwilligungsstatus aktualisiert werden. Weitere Informationen finden Sie in der Dokumentation Ihres CMP-Anbieters.

Achtung :Verwenden Sie in Tag Manager kein benutzerdefiniertes HTML-Tag, um den Befehl gtag consent aufzurufen. Legen Sie stattdessen Einwilligungsstatus mit einem Vorlagentag fest, das die API für benutzerdefinierte Vorlagen verwendet.

Einwilligungsstatus wird nicht an regionale Einstellungen angepasst

Sie können je nach Region des Besuchers unterschiedliche Standardeinstellungen für die Einwilligung festlegen. Wenn Sie Standardeinstellungen für die Einwilligung für verschiedene Regionen implementiert haben, können Sie mit den folgenden Schritten überprüfen, ob Ihre Einstellungen funktionieren.

Problemlösung: Der Einwilligungsmodus wird nicht an die Region des Nutzers angepasst

gtag.js

1. Legen Sie in Ihrem Browser den Standort des Besuchers auf eine Region fest, die Sie überprüfen möchten. Informationen zum Festlegen von Standorten in Chrome
2. Überprüfen Sie, ob der Einwilligungsmodus funktioniert.

3. Wenn der Einwilligungsmodus nicht an die Region des Nutzers angepasst wird, prüfen Sie den Quellcode. Beispiel:

     gtag('consent', 'default', {
       'analytics_storage': 'denied',
       'region': ['ES', 'US-AK']
     });
   
     gtag('consent', 'default', {
       'ad_storage': 'denied'
     });

   Im Beispiel wird eine regionale Standardeinstellung für die Einwilligung für einen Parameter festgelegt, nicht aber für den anderen. Achten Sie beim Prüfen des regionalen Verhaltens darauf, dass alle Parameter gemäß den Organisationsrichtlinien funktionieren. Weitere Informationen zum Einrichten von geografischen Regionen

Tag Manager

1. Legen Sie in Ihrem Browser den Standort des Besuchers auf eine Region fest, die Sie überprüfen möchten. Informationen zum Festlegen von Standorten in Chrome
2. Überprüfen Sie, ob der Einwilligungsmodus funktioniert.
3. Wenn der Einwilligungsmodus nicht an die Region des Nutzers angepasst wird, prüfen Sie die Einstellungen Ihres Einwilligungstags (siehe Geografische Regionen einrichten).

Nächste Schritte

Das Google-Tag ist einwilligungssensitiv. Das Verhalten wird also an die Nutzereinwilligung angepasst. Wenn Sie das Laden des Google-Tags blockieren, bis ein Nutzer seine Einwilligung erteilt, sind die geschätzten Conversions weniger genau und die Verhaltensmodellierung in Google Analytics 4 ist nicht verfügbar. Heben Sie die Blockierung Ihres Google-Tags auf, um optimale Analyseergebnisse zu erhalten.

Weitere Informationen zu den Auswirkungen des Einwilligungsmodus