Google Tag Assistant: sehen, welche Tags auslösen, und finden, was sie kaputt gemacht hat

Was ist Google Tag Assistant und was zeigt es an?

Google Tag Assistant ist ein webbasiertes Tool unter tagassistant.google.com, mit dem Sie Installationen des Google-Tags (gtag.js) und des Google Tag Managers prüfen und Fehler beheben, einschließlich der Tags für Google Analytics und Google Ads. Es hat den alten Vorschaumodus des Tag Managers ersetzt, der auf Drittanbieter-Cookies angewiesen war, die Browser zunehmend blockieren.

In einer einzigen Debug-Sitzung verfolgen Sie die ganze Domain Seite für Seite und sehen:

• jedes Ereignis, in der Reihenfolge des Auslösens nummeriert und nach Seite gruppiert;
• den API-Aufruf hinter jedem Ereignis, also gtag() oder dataLayer.push();
• die gesendeten Treffer mit Ziel, Typ und den Parametern jedes Treffers;
• die Werte der Datenschicht, die Ereignisse der erweiterten Analyse von Google Analytics und Fehler.

Bei Tag-Manager-Containern zeigt die Debug-Ansicht außerdem, welche Tags bei jedem Ereignis ausgelöst wurden und welche nicht, die erfassten Variablenwerte und den Einwilligungsstatus, wenn der Einwilligungsmodus aktiv ist. Diese Informationen sehen nur Sie in Ihrer Sitzung, normale Besucher sehen sie nicht.

Was Tag Assistant nicht liefert, ist ein Verlauf. Es zeigt, wie sich die Tags jetzt in Ihrem Browser verhalten. Wenn ein Tag seit letztem Dienstag nicht mehr auslöst, müssen Sie immer noch herausfinden, was sich letzten Dienstag geändert hat.

Wie starte ich eine Debug-Sitzung in Tag Assistant?

Starten Sie unter tagassistant.google.com für jede Website mit Google-Tag, oder über die Vorschau-Schaltfläche im Tag Manager, wenn Sie noch nicht veröffentlichte Änderungen im Arbeitsbereich testen möchten.

Über Tag Assistant

1. Öffnen Sie tagassistant.google.com und klicken Sie auf „Add domain“.
2. Geben Sie die URL der Website ein, beginnend mit https:// oder http://.
3. Klicken Sie auf „Connect“. Die Website öffnet sich in einem neuen Fenster mit dem Debug-Parameter _dbg in der URL.
4. Rufen Sie die Seiten und Aktionen auf, die Sie testen möchten. Tag Assistant aktualisiert sich, während Sie navigieren.

Über Google Tag Manager

1. Öffnen Sie den Container und klicken Sie auf dem Tab „Arbeitsbereich“ auf „Vorschau“. Tag Assistant öffnet sich in einem neuen Tab.
2. Geben Sie die URL ein und klicken Sie auf „Verbinden“. Die Website zeigt unten rechts „Verbunden“ an.
3. Wechseln Sie zurück zum Tag-Assistant-Tab und klicken Sie auf „Weiter“, um die Debug-Oberfläche zu öffnen.

Wenn der Debug-Parameter Ihre Website stört, deaktivieren Sie vor dem Verbinden „Debug-Signal in die URL einfügen“. Google empfiehlt die Chrome-Erweiterung Tag Assistant: Sie ermöglicht das Debuggen von Tags in iframes (nur mit der Erweiterung möglich), Pop-ups, neuen Tabs und mehreren Fenstern gleichzeitig. Zum Beenden klicken Sie oben links in der Debug-Oberfläche auf das X oder auf „Debugging beenden“. Um eine Sitzung fortzusetzen, wählen Sie die Domain unter „Active Domains“ oder „History“ auf der Startseite von Tag Assistant (die Hilfe zu Tag Assistant gibt es nur auf Englisch, daher bleiben einige Bezeichnungen englisch).

Wie lese ich, was Tag Assistant anzeigt?

Gehen Sie von links nach rechts vor: Wählen Sie ein Ereignis in der Zeitachse und prüfen Sie dann, was es gesendet und welche Tags es ausgelöst hat.

Die Sitzung öffnet sich in der Ansicht „Summary“. Wenn auf der Seite mehrere Google-Tags oder Container laufen, wählen Sie oben einen aus; die Treffer werden dann nach dieser ID gefiltert. Die linke Spalte ist die Zeitachse der Ereignisse; Ereignisse mit dem Symbol <> sind integrierte Ereignisse, die das Google-Tag beim Laden sendet.

Ein Tag unter „Tags Fired“ beendet die Prüfung nicht. Öffnen Sie den Treffer und lesen Sie die Parameter: Ein Kauf-Tag, das mit Wert 0 oder ohne Währung auslöst, schadet der Gebotsstrategie genauso wie ein Tag, das gar nicht auslöst. Tag Assistant warnt außerdem, wenn ein Ereignis an ein Google-Produkt gesendet wird, ohne dass vorher das passende Google-Tag ausgelöst wurde.

Warum löst mein Google-Tag nicht aus?

Meist hört ein Tag wegen einer Änderung auf zu funktionieren: an der Website, am Container, an der Einwilligung oder am Seitenablauf. Die Tabelle zeigt die üblichen Ursachen und wie sie sich zeigen.

Manche Grenzen liegen am Tool: AMP-Seiten werden nicht unterstützt, und Tags in iframes lassen sich nur mit der Chrome-Erweiterung debuggen. Lädt das Google-Tag erst, nachdem Tag Assistant die Verbindung versucht hat, klicken Sie auf „Retry“. Einwilligungstools können Google-Tags blockieren, wenn sie nicht für die Einwilligungs-API von Google eingerichtet sind; dazu gibt es einen eigenen Beitrag darüber, wie Sie beweisen, dass das Einwilligungsbanner den Conversion-Rückgang verursacht hat.

Wie isoliere ich, welche Änderung das Tag kaputt gemacht hat?

Tag Assistant sagt Ihnen, dass das Tag heute defekt ist. Um herauszufinden, welche Änderung das verursacht hat, suchen Sie den letzten Tag, an dem es funktionierte, und legen alles nebeneinander, was sich an diesem Tag und kurz davor geändert hat.

1. Letzten funktionierenden Tag finden
2. Änderungen davor auflisten
3. Verdacht in Tag Assistant testen
4. Beheben und Korrektur protokollieren

Ermitteln Sie das Datum des Ausfalls in Ihren Berichten: den Tag, an dem GA4-Ereignisse oder Google-Ads-Conversions auf null fallen oder sprunghaft sinken. Sammeln Sie dann die Änderungen aus diesem Zeitraum: im Tag Manager veröffentlichte Containerversionen (die Liste unter Versionen zeigt, wann jede veröffentlicht wurde und von wem), Website-Releases, CMS- oder Theme-Updates sowie Änderungen am Einwilligungsbanner, am Checkout oder an Formularen. Öffnen Sie die Version, die dem Ausfall am nächsten liegt, und prüfen Sie, welche Tags, Trigger und Variablen sie geändert hat; der Beitrag zum Versionsverlauf im Google Tag Manager zeigt, wie.

Testen Sie danach einen Verdacht nach dem anderen. Öffnen Sie die Vorschau der Version vor dem Ausfall und der aktuellen, durchlaufen Sie denselben Ablauf (zum Beispiel ein Testformular absenden) und vergleichen Sie „Tags Fired“ und die Treffer. Löst die alte Version aus und die neue nicht, liegt die Ursache im Container. Scheitern beide, suchen Sie auf der Website.

Mit allen Änderungen auf einer Zeitachse dauert das Minuten statt eines Nachmittags: Sie würden sehen, dass eine Containerversion und ein Checkout-Release am Tag vor dem Einbruch live gingen, und diese beiden zuerst testen. In Changeline protokolliert das Team Änderungen an Website, Tags und Einwilligung mit Datum, Verantwortlichem und Grund, und Änderungen in Google Ads werden über eine schreibgeschützte Verbindung automatisch importiert. So stehen ein Tracking-Ausfall und eine Gebotsänderung aus derselben Woche nebeneinander.

Beispiel: Ein Kunde fragt, warum die Google-Ads-Leads am Donnerstag auf null gefallen sind. Tag Assistant zeigt das Formular-Tag unter „Tags Not Fired“. Auf der Zeitachse stehen für Mittwoch zwei Einträge: eine Containerversion, die ein Chat-Widget hinzufügte, und ein Website-Release, das das Formularereignis von form_submit in lead_submit umbenannte. In der Vorschau des alten Containers auf der aktuellen Website schlägt das Tag weiterhin fehl, also ist der Container nicht die Ursache: Der Trigger wartet auf ein Ereignis, das die Website nicht mehr sendet. Den Trigger anzupassen behebt das Problem, und die Antwort an den Kunden passt in einen Satz mit Datum. Namen und Zahlen sind frei gewählt.

Wie teile ich eine Debug-Sitzung oder teste eine ältere Containerversion?

Sie können die Debug-Sitzung an Kollegen oder Entwickler weitergeben, statt das Problem per E-Mail zu beschreiben.

• Vorschau des Arbeitsbereichs teilen: Klicken Sie in Tag Assistant auf „Weitere Aktionen“ und dann auf „Freigeben“. Geben Sie im Dialog „Debug-Sitzung teilen“ die Domain der Website ein, kopieren Sie die Vorschau-URL und senden Sie sie.
• Ältere Version in der Vorschau öffnen: Gehen Sie im Tag Manager zu „Versionen“, öffnen Sie bei der Version „Weitere Aktionen“ und wählen Sie „Vorschau“, oder die Option zum Freigeben der Vorschau, um sie an jemand anderen zu senden.
• Sitzung exportieren: Tag Assistant kann Debug-Sitzungen exportieren und importieren, sodass ein Entwickler genau das öffnet, was Sie gesehen haben.

Der Vorschaumodus funktioniert nur in dem Browser, in dem Sie ihn gestartet haben, oder für Personen, für die Sie ihn freigegeben haben. Die Version vor dem Ausfall gegen die aktuelle Website zu testen, ist der schnellste Weg, ein Container-Problem von einem Website-Problem zu unterscheiden.

Wie verhindere ich, dass Tags beim nächsten Release unbemerkt ausfallen?

Behandeln Sie Tracking wie Code: Jede Änderung bekommt einen Namen, ein Datum und einen Test.

1. Benennen Sie jede Containerversion. Der Tag Manager fragt beim Veröffentlichen nach Versionsname und Versionsbeschreibung, und das Beispiel von Google lautet „GA page view tag - initial launch“. Ein klarer Name ist Ihr erster Hinweis, wenn Sie Monate später einen Ausfall suchen.
2. Prüfen Sie nach jedem Website-Release mit Tag Assistant, nicht nur nach Änderungen im Tag Manager. Viele Ausfälle kommen von der Website: eine umbenannte Klasse, eine neue Vorlage, ein verschobener Checkout-Schritt.
3. Testen Sie die umsatzrelevanten Ereignisse wie Kauf, Lead und Registrierung von Anfang bis Ende und öffnen Sie die Treffer, um Wert, Währung und Transaktions-ID zu prüfen.
4. Protokollieren Sie die Änderung dort, wo das ganze Team sie sieht, mit Grund und Urheber, neben Kampagnen- und Website-Änderungen. Eine Vorlage für ein Marketing-Änderungsprotokoll reicht für den Anfang, und der Ratgeber zum Marketing-Änderungsprotokoll erklärt, was Sie festhalten sollten.
5. Markieren Sie Tracking-Korrekturen in Ihren Berichten. Wenn die Conversions nach einer Korrektur zurückkommen, setzen Sie eine Notiz, damit niemand das als Leistungssteigerung liest; siehe Anmerkungen in GA4.

Hat ein defektes Tag bereits eine Woche Conversions gekostet, hilft der Ratgeber, wie Sie einem Kunden einen Conversion-Rückgang erklären, Datum, Ursache und Korrektur sauber darzustellen.