Zum Inhalt springen
Workspace öffnen
Hilfethemen durchsuchen
Debug-Modus

Prüfen Sie, ob Velo vor Ihren Google-Tags läuft.

Aktivieren Sie den Debug-Modus von Velo, um zu prüfen, ob der Consent-Mode-Standard vor jedem Google-Tag gesetzt wird, und korrigieren Sie sonst die Reihenfolge.

4 Min. LesezeitGeprüft am 1. November 2026

Debug-Modus aktivieren

Der Debug-Modus zeigt, was Velo beim Laden einer Seite tut. Er läuft nur dort, wo Sie ihn aktivieren.

Am schnellsten geht es ohne Code. Hängen Sie velo_debug=1 an die Seitenadresse an und laden Sie die Seite.

Nur ein Beispiel · verwenden Sie Ihre eigene Seite
https://example.com/?velo_debug=1

Enthält die Adresse bereits ein ?, hängen Sie stattdessen &velo_debug=1 an.

Sie können ihn auch in Ihrem Setup aktivieren:

  • Fügen Sie data-velo-debug="true" zum Script-Tag von Velo hinzu.
  • Fügen Sie ?debug=true am Ende des src des Skripts an.
  • Setzen Sie in Google Tag Manager im Velo-CMP-Tag den Haken bei Debug mode.
Entfernen Sie die Änderungen am Setup, wenn Sie fertig sind.

Ein Attribut, ein src-Parameter oder eine GTM-Einstellung aktiviert den Debug-Modus für alle Besucher. Entfernen Sie sie nach dem Test und veröffentlichen Sie erneut.

Die Meldungen des Debug-Modus lesen

Bei aktivem Debug-Modus erscheint auf der Seite ein kleines Velo debug-Panel. Dieselben Angaben gehen in die Browser-Konsole, in Zeilen, die mit [Velo debug] beginnen. Öffnen Sie die Entwicklertools Ihres Browsers und wählen Sie Console, um sie zu sehen.

Was das Debug-Panel meldet
EintragWorauf Sie achten sollten
Consent defaultPass bedeutet, dass Velo den Standard vor jedem Google-Tag gesetzt hat. Late bedeutet, dass ein Google-Tag zuerst lief. Siehe Ein Google-Tag lud vor Velo.
Consent modeAdvanced bedeutet, dass Velo Consent-Mode-Befehle sendet. Basic bedeutet, dass es keine sendet und Ihre Google-Tags auf die Einwilligung warten. Siehe Basic und Advanced Consent Mode.
RegionDie Region des Besuchers und ob dort Opt-in gilt. In einer Opt-in-Region sollte jedes Signal mit „denied“ starten.
Developer IDDie Google-Developer-ID, die Velo setzt. Google erkennt daran, welche Consent-Plattform die Einwilligung gesetzt hat.
Consent updatesEin Eintrag bei jeder Entscheidung oder Änderung des Besuchers, mit den Signalen, die dabei gesetzt werden.

Testen Sie in einem frischen privaten Fenster, damit eine gespeicherte Entscheidung den ersten Besuch nicht verdeckt. Stimmen Sie zu, lehnen Sie ab und speichern Sie eine Teilauswahl. Prüfen Sie, ob jedes Mal ein Update erscheint.

Ein Google-Tag lud vor Velo

Zeigt der Debug-Modus late, lief ein Google-Tag, bevor Velo den Consent-Mode-Standard gesetzt hat. Dieses Tag lief ohne Consent-Status. Man nennt das späte Einwilligung (late consent). Beheben Sie die Reihenfolge, bevor Sie sich auf Ihre Testergebnisse verlassen.

Schritt 1: Google Tag Gateway prüfen

Prüfen Sie das immer zuerst. Nutzt das späte Tag Google Tag Gateway, fügt Ihr CDN oder Server das Tag möglicherweise vor Velo in die Seite ein. Das Verschieben des Script-Tags von Velo in Ihrem Code behebt das nicht.

Schnell erkennen Sie es daran, wovon das Tag lädt. Öffnen Sie die Entwicklertools, wählen Sie Network und laden Sie die Seite neu. Suchen Sie gtm.js oder gtag/js. Lädt es von Ihrer eigenen Domain statt von googletagmanager.com, nutzt es Tag Gateway. Sie können auch den Tag-Gateway-Status Ihres Google-Tags prüfen.

Ist das der Fall, folgen Sie den empfohlenen Tag-Gateway-Setups, damit Velo zuerst läuft.

Schritt 2: Velo an die erste Stelle setzen

Nutzt das Tag kein Tag Gateway, ändern Sie die Reihenfolge auf der Seite.

  • Direkte Installation: Verschieben Sie das Script-Tag von Velo im <head> über jedes Google-Tag. Laden Sie Velo nicht mit async nach gtag. Ein asynchrones Skript kann nach dem darunterliegenden Code laufen.
  • Google Tag Manager: Lösen Sie das Velo-CMP-Tag bei Consent Initialization – All Pages aus, nicht mit einem Seitenaufruf-Trigger.

Laden Sie die Seite mit ?velo_debug=1 neu und prüfen Sie, ob der Consent-Standard jetzt pass zeigt.

Dieselbe Prüfung im Scanner ansehen

Die Seite Scanner in Ihrem Velo-Workspace führt dieselbe Prüfung bei jedem Scan aus. Suchen Sie unter Consent Mode nach Consent default is set before Google tags. Schlägt sie fehl, folgen Sie den Schritten oben.

Eine zweite Meinung im Tag Assistant einholen

Der Tag Assistant von Google zeigt den Consent-Status, den jedes Google-Tag gesehen hat. Verbinden Sie ihn in einer frischen Sitzung mit Ihrer veröffentlichten Website. Das erste Consent-Event sollte der Standard von Velo sein, bevor ein Google-Tag auslöst.

Siehe Test im Tag Assistant und Googles Anleitung zur Fehlersuche bei Consent Mode.