Teil 3 von 3 zur Fehlerbehebung in Attribution Reporting. Anleitungen zur Verwendung von Fehlerbehebungsberichten
In dieser Rezeptesammlung finden Sie eine Anleitung zur Verwendung von Fehlerbehebungsberichten für verschiedene Anwendungsfälle, die in Teil 1: Einführung in Fehlerbehebungsberichte beschrieben werden.
Glossar
- Die Quelle der Berichterstellung ist die Quelle, über die die Header Quelle und Trigger von Attribution Reporting festgelegt werden.
Alle vom Browser erstellten Berichte werden an diesen Ursprung gesendet. In dieser Anleitung verwenden wir
https://adtech.example
als Beispielquelle für die Berichterstellung. - Ein Attributionsbericht (kurz Bericht) ist der Abschlussbericht (auf Ereignisebene oder aggregierbar), der die angeforderten Messdaten enthält.
- Ein Debug-Bericht enthält zusätzliche Daten zu einem Attributionsbericht oder zu einer Quelle oder einem Triggerereignis. Wenn Sie einen Debug-Bericht erhalten, bedeutet das nicht unbedingt, dass ein Fehler vorliegt. Es gibt zwei Arten von Fehlerbehebungsberichten.
- Ein Debug-Bericht vom Typ „Transitional“ ist ein Debugging-Bericht, für den ein Cookie festgelegt werden muss, damit er generiert und gesendet wird. Berichte zur vorübergehenden Fehlerbehebung sind nicht mehr verfügbar, wenn kein Cookie gesetzt wird oder Drittanbieter-Cookies nicht mehr unterstützt werden. Alle in diesem Leitfaden beschriebenen Fehlerbehebungsberichte sind Übergangsberichte.
- In Berichten zur Fehlerbehebung wird die erfolgreiche Erstellung eines Attributionsberichts erfasst. Sie beziehen sich direkt auf einen Attributionsbericht. Berichte zur Fehlerbehebung sind seit Chrome 101 (April 2022) verfügbar.
- Mit ausführlichen Debugging-Berichten können Sie fehlende Berichte verfolgen und herausfinden, warum sie fehlen. Sie weisen auf Fälle hin, in denen der Browser keine Quelle oder kein Trigger-Ereignis aufgezeichnet hat und somit keinen Attributionsbericht generiert. Außerdem werden Fälle angezeigt, in denen aus irgendeinem Grund kein Attributionsbericht generiert oder gesendet werden kann.
Ausführliche Fehlerbehebungsberichte enthalten ein
type
-Feld, das den Grund beschreibt, warum kein Quellereignis, Triggerereignis oder Attributionsbericht generiert wurde. Berichte zur ausführlichen Fehlerbehebung sind ab Chrome 109 verfügbar (stabil im Januar 2023). - Fehlerbehebungsschlüssel sind eindeutige Kennungen, die Sie sowohl auf der Quell- als auch auf der Trigger-Seite festlegen können. Mit Schlüsseln zur Fehlerbehebung können Sie auf Cookies und Attribution basierende Conversions zuordnen. Wenn Sie Ihr System so eingerichtet haben, dass Fehlerbehebungsberichte generiert und Fehlerbehebungsschlüssel festgelegt werden, nimmt der Browser diese Fehlerbehebungsschlüssel in alle Attributions- und Fehlerbehebungsberichte auf.
Weitere Konzepte und Schlüsselbegriffe, die in unserer Dokumentation verwendet werden, finden Sie im Privacy Sandbox-Glossar.
Anleitung: Integration in Echtzeit prüfen
- Richten Sie Ihr System so ein, dass Berichte zur erfolgreichen Fehlerbehebung generiert werden. Weitere Informationen finden Sie in Teil 2: Fehlerbehebungsberichte einrichten.
- Prüfen Sie bei jeder Bereitstellung von Attribution Reporting-Code in Echtzeit, ob Sie Debug-Berichte zu erfolgreichen Ergebnissen auf Ihrem Endpunkt erhalten. In diesem Fall funktioniert der Attribution Reporting erfolgreich.
- Berichte zur erfolgreichen Fehlerbehebung werden nur gesendet, wenn eine Conversion erfolgt. Stattdessen sollten Sie prüfen, ob Ihre Integration unabhängig von den Conversions korrekt eingerichtet ist, d. h., Sie möchten prüfen, ob die Quellen erfolgreich registriert wurden. Dazu sind die ausführlichen Fehlerbehebungsberichte der erfolgreichen Quellenregistrierung erforderlich. Informationen zur Einrichtung finden Sie in Teil 2: Fehlerbehebungsberichte einrichten.
Anleitung: Verlust analysieren und Probleme mit der Integration beheben
Wenn Sie die Ergebnisse der cookiebasierten Conversion-Analyse mit Attribution Reporting-Berichten vergleichen möchten, verwenden Sie Schlüssel zur Fehlerbehebung und ordnen Sie Cookie-Conversions mit Debug-Berichten zu. Debug-Berichte werden sofort an Ihren Endpunkt gesendet.
Überblick
Verwenden Sie die Schlüssel zur Fehlerbehebung (das <source_debug_key, trigger_debug_key>
-Paar), um Cookie-Conversions entsprechenden Berichten zur Fehlerbehebung zuzuordnen.
Haben Sie für jede Cookie-Conversion zum Zeitpunkt der Conversion einen entsprechenden Bericht zur Fehlerbehebung erhalten?
Falls ja: Für alle diese Berichte zur Fehlerbehebung erhalten Sie später – mit wenigen Ausnahmen – einen Attributionsbericht. Weitere Informationen finden Sie im Szenario für den Debug-Bericht zur erfolgreichen Fehlerbehebung.
Wenn nicht: Die Conversion wurde nicht in Attribution Reporting registriert. Verwenden Sie das <source_debug_key, trigger_debug_key>
-Paar (oder den Schlüssel zur Fehlerbehebung für die Quelle, wenn der Trigger-Schlüssel zur Fehlerbehebung nicht vorhanden ist), um Cookie-Conversions ausführlichen Fehlerbehebungsberichten zuzuordnen. Haben Sie für jede dieser Conversions einen entsprechenden ausführlichen Debug-Bericht erhalten (Quellen- oder Triggerzeit)?
Wenn Sie keinen ausführlichen Debug-Bericht erhalten haben, kann dies auf ein Nutzerverhalten oder ein Integrationsfehler zurückzuführen sein. Weitere Informationen finden Sie im Szenario ohne Debug-Bericht.
Wenn Sie einen ausführlichen Debug-Bericht erhalten haben, sehen Sie sich das Feld
type
an.Wenn der
type
source-success
ist, bedeutet dies, dass die Quelle erfolgreich registriert wurde, der Trigger jedoch nicht. Wenn Sie den Grund für das Fehlen des Erfolgsberichts zur Fehlerbehebung eingrenzen möchten, suchen Sie nach einem entsprechenden ausführlichen Debug-Bericht eines anderen Typs, in dem ein Problem auf der Triggerseite angezeigt wird.Wenn
type
etwas anderes ist: Die Quelle oder der Trigger wurde nicht registriert.type
verrät Ihnen die Gründe. Der entsprechende Attributionsbericht und der Bericht zur Fehlerbehebung fehlen. Abhängig von dentype
eines ausführlichen Debug-Berichts möchten Sie diese Informationen vielleicht nur als Verlustanalysedatenpunkt betrachten, d. h. keine Maßnahme für Sie, oder einen Fehler melden oder Ihre Implementierung beheben. Weitere Informationen finden Sie im Szenario des ausführlichen Debug-Berichts.
Mögliche Szenarien
Bericht zur erfolgreichen Fehlerbehebung
Wenn Sie für eine Cookie-Conversion einen Debug-Bericht erhalten, bedeutet das, dass diese Conversion für Attribution Reporting registriert wurde.
Sie erhalten später einen Attributionsbericht für diese Conversion⏤. Es gibt aber ein paar Ausnahmen:
- Nutzerverhalten: Daten werden nach der Conversion gelöscht, bevor der Attributionsbericht gesendet wird, oder schließt den Browser. Wenn ein Nutzer seinen Browser nach der Conversion schließt und eine Woche lang nicht öffnet, wird der Bericht eine Woche oder länger nicht gesendet. Diese Verzögerung kannst du als Verlust betrachten.
- Nur für Ereignisebene: Ein Bericht auf Ereignisebene wird durch einen anderen Bericht mit höherer Priorität ersetzt.
- Mögliche Netzwerkprobleme.
Ausführlicher Debug-Bericht vom Typ source-success
Wenn Sie für die Quelle einer bestimmten Cookie-Conversion einen ausführlichen Debug-Bericht vom Typ source-success
erhalten haben, war die Registrierung der Quelle erfolgreich. Je nachdem, ob die Trigger-Registrierung später ebenfalls erfolgreich ist, erhalten Sie möglicherweise keinen Bericht für diese Conversion.
Dies muss jedoch beachtet werden:
Ausführlicher Debug-Bericht anderer Typen
Wenn Sie für eine Cookie-Conversion einen ausführlichen Debug-Bericht eines anderen Typs erhalten haben, erhalten Sie keinen Bericht zur erfolgreichen Fehlerbehebung. Daher auch später auch kein Attributionsbericht, da ein ausführlicher Bericht bedeutet, dass ein berichtsfähiger Fehler aufgetreten ist. Ein Fehler hat die Registrierung der Quelle, die Auslösung der Registrierung, das Generieren von Berichten oder das Senden von Berichten verhindert. Mögliche Ursachen:
- Datenschutzbeschränkungen
- Speichergrenzwerte
- Benutzerdefinierte Regeln
- Implementierungsproblem in Ihrem Code
- Browserfehler
Einige davon sind zu erwarten. Welche Maßnahme Sie ergreifen sollten, hängt von den type
der einzelnen ausführlichen Berichte ab. Sehen Sie sich die Referenz zu ausführlichen Berichten an.
Keine Debug-Berichte
Wenn Sie für eine Cookie-Conversion nur einen Attributionsbericht erhalten, also keinen Bericht zur erfolgreichen Fehlerbehebung und keinen ausführlichen Debug-Bericht, wurden die Debug-Berichte aufgrund eines Fehlers nicht erstellt. Mögliche Ursachen:
- Nutzereinstellungen (Nutzer hat Drittanbieter-Cookies deaktiviert)
- Fehlendes Cookie oder fehlende Schlüssel zur Fehlerbehebung (der Fehlerbehebungsschlüssel wurde aufgrund eines fehlenden Cookies gelöscht). Öffnen Sie in
chrome://attribution-internals
den Tab Protokolle und prüfen Sie, ob dort ein Problem auftritt. - Netzwerkprobleme, die an der Quelle oder beim Auslösen, aber nicht beim Senden des Attributionsberichts aufgetreten sind.
Erhalten Sie Attributionsberichte?
In diesem Fall wird kein Debug-Bericht zur Verfügung gestellt: Wenn Sie für eine bestimmte Cookie-Conversion keine Berichte erhalten haben (kein Debug-Bericht oder kein Attributionsbericht), ist ein nicht gemeldeter Fehler aufgetreten. Mögliche Ursachen:
- Grundlegendes Integrationsproblem. Unter Grundlegende Integrationsprobleme beheben erfahren Sie, wie Sie diese Probleme beheben können.
- Mögliche Netzwerkprobleme.
- Nutzereinstellungen wie die Privacy Sandbox in den Browsereinstellungen deaktiviert.
Ausführliche Referenz zu Debug-Berichten
Jeder ausführliche Debug-Bericht enthält ein type
-Feld, in dem der Grund für das Löschen des entsprechenden Attributionsberichts angegeben ist. Anhand der Referenz können Sie für jeden type
ausführlichen Bericht entscheiden, welche Maßnahmen Sie ergreifen sollten.
Registrierung der Quelle erfolgreich
Eine Quelle wurde erfolgreich registriert.
source-success
- Details und Berichtstext
Berichte zu Datenschutzeinschränkungen
Diese Berichte sind zu erwarten. Sie weisen darauf hin, dass Einschränkungen beim Datenschutz gelten, um den Verlust von websiteübergreifenden Nutzeridentitäten zu reduzieren.
source-destination-limit
- Details und Berichtstext
source-noised
- Details und Berichtstext
trigger-attributions-per-source-destination-limit
- Details und Berichtstext
trigger-reporting-origin-limit
- Details und Berichtstext
trigger-event-noise
- Details und Berichtstext
trigger-event-excessive-reports
- Diese wird generiert, wenn die Anzahl der Berichte das Limit überschreitet. Sie können maximal eine Conversion für Aufrufe und drei für Klicks registrieren. Sie können konfigurieren, welche Berichte Sie erhalten möchten, indem Sie Prioritäten festlegen. Details und Berichtstext
Berichte zu Speichereinschränkungen
Diese Berichte sind zu erwarten. Sie weisen auf Speichereinschränkungen hin, um eine übermäßige Ressourcennutzung zu verhindern.
source-storage-limit
- Details und Berichtstext
trigger-event-storage-limit
- Details und Berichtstext
trigger-aggregate-storage-limit
- Details und Berichtstext
Berichte zu benutzerdefinierten Regeln
Diese Berichte sind zu erwarten, wenn Sie Filter, Deduplizierung, Prioritäten oder zeitfensterbasierte Filter verwenden. Prüfen Sie noch einmal die entsprechenden benutzerdefinierten Regeln, um sicherzustellen, dass der Bericht, der diesem ausführlichen Bericht entspricht, tatsächlich gelöscht werden soll. Wenn diese Angaben korrekt sind, musst du nichts weiter unternehmen.
trigger-no-matching-filter-data
- Details und Berichtstext
trigger-event-no-matching-configuration
- Details und Berichtstext
trigger-event-deduplicated
- Details und Berichtstext
trigger-aggregate-deduplicated
- Details und Berichtstext
trigger-event-low-priority
- Details und Berichtstext
trigger-event-report-window-passed
- Details und Berichtstext
trigger-aggregate-report-window-passed
- Details und Berichtstext
Weitere ausführliche Berichte
Diese Berichte können auf potenzielle Implementierungsprobleme im Code hinweisen.
trigger-no-matching-source
- Möglicherweise liegt ein Problem bei der Implementierung vor. Achte darauf, dass bei der Einrichtung von
<reporting origin, destination>
keine Fehlkonfiguration vorliegt. Dies kann auch dem zu erwartenden API-Verhalten entsprechen. Beispiel: Der Nutzer hat nach der Interaktion mit einer Anzeige und vor der Conversion Daten gelöscht oder er führt eine Conversion aus, ohne jemals eine verknüpfte Anzeige gesehen zu haben. Details und Berichtstext trigger-aggregate-no-contributions
- Dies ist wahrscheinlich nicht das gewünschte Verhalten Ihres Codes. Beheben Sie Probleme mit dem Trigger-Registrierungscode. Achten Sie darauf, dass Ihre Beitragskonfiguration korrekt ist. Details und Berichtstext
trigger-aggregate-insufficient-budget
- Dies ist wahrscheinlich nicht das gewünschte Verhalten Ihres Codes. Überprüfe deinen Trigger-Registrierungscode noch einmal, um sicherzustellen, dass die Summe aller Beiträge das Beitragsbudget nicht überschreitet. Details und Berichtstext
Unerwartete Fehler (mögliche Browserfehler)
Diese Berichte sind unerwartet. Möglicherweise liegt ein Browserfehler vor. Melden Sie den Fehler und geben Sie in Ihrer Beschreibung die Schritte an, mit denen der Fehler reproduziert werden kann.
source-unknown-error
- Details und Berichtstext
trigger-unknown-error
- Details und Berichtstext
Beispiel für eine Verlustanalyse
Schritt 1: Einrichtung und Zuordnung mit Cookies
Folgen Sie der Anleitung in Teil 2: Fehlerbehebungsberichte einrichten, um Ihr System so einzurichten, dass Berichte zur erfolgreichen Fehlerbehebung und ausführliche Fehlerbehebungsberichte generiert werden.
So können Sie Cookie-basierte Conversion-Informationen zum Abrufen der entsprechenden Fehlerbehebungs- oder Attributionsberichte verwenden.
Schritt 2: Erfolgreiche Registrierungen und fehlende Berichte identifizieren
In diesem Beispiel wird davon ausgegangen, dass Sie mit Ihrem Cookie-basierten System 100 Conversions erfasst haben.
Suchen Sie jedes Mal, wenn Sie eine cookiebasierte Conversion erfassen, nach dem Bericht zur Fehlerbehebung, der sofort gesendet wird und dasselbe <source_debug_key, trigger_debug_key>
-Paar wie diese cookiebasierte Conversion enthält.
Angenommen, Sie haben für 70 dieser Cookie-Conversions einen Bericht zur Fehlerbehebung erhalten.
- Erfolgsberichte bedeuten, dass die Attribution erfolgreich erfasst wurde. Sie können also davon ausgehen, dass Sie einen Attributionsbericht erhalten, der dem jeweiligen Erfolgsbericht entspricht – mit einigen Ausnahmen.
- Sie können diese Ausnahmen überwachen. Da Attributionsberichte im Laufe der nächsten Tage/Wochen (je nach Ablauf) an Ihren Endpunkt gesendet werden, suchen Sie nach den Attributionsberichten, die dieselben Schlüssel zur Fehlerbehebung wie in den anderen Berichten zur Fehlerbehebung enthalten. Warten Sie einige Zeit: Berichte werden möglicherweise nicht sofort am Ende jedes Fensters gesendet. Angenommen, Sie finden nur 60 Attributionsberichte. Die zehn fehlenden Attributionsberichte können auf das Nutzerverhalten zurückzuführen sein.
Schritt 3: Kurze Verlustbewertung
100–70 = 30 Erfolgsberichte zur Fehlerbehebung fehlen. Das bedeutet, dass diese 30 Conversions, die über Ihre cookiebasierte Implementierung erfasst wurden, nicht in Attribution Reporting erfasst wurden. Sie erhalten dafür keine Attributionsberichte.
Da Sie 100 cookiebasierte Conversions und nur 70 Attributionsbasierte Conversions haben, entfallen 30%. Sie haben jetzt eine kurze Verlustbewertung.
Schritt 4: Ursachen analysieren
Wenn Sie herausfinden möchten, warum diese Berichte fehlen, suchen Sie nach entsprechenden ausführlichen Debug-Berichten, die Sie zum Zeitpunkt der Conversion (Trigger-Registrierung) oder früher bei der Registrierung der Quelle erhalten haben. Verwenden Sie die Schlüssel der cookiebasierten Conversions, um diese ausführlichen Fehlerbehebungsberichten zuzuordnen.
- Angenommen, es gibt zehn Schlüssel, für die es keinen ausführlichen Debug-Bericht gibt. Prüfen Sie, ob ein Integrationsproblem vorliegt. Ist dies nicht der Fall, kann dies auf das Nutzerverhalten zurückzuführen sein.
- Ihnen stehen 20 ausführliche Fehlerbehebungsberichte zur Verfügung. Sie können Ihre Verlustanalyse jetzt verfeinern. Analysieren Sie das Feld
type
jedes ausführlichen Berichts. Beispiele:- 10 Berichte fehlen (in unserem Beispiel = 10 %) aus folgendem Grund:
pending destination limit
- 5 Berichte (= 5%) fehlen aufgrund von „
trigger-aggregate-no-contributions
“. - 5 Berichte (= 5%) fehlen aufgrund von „
unknown-error
“.
- 10 Berichte fehlen (in unserem Beispiel = 10 %) aus folgendem Grund:
Schritt 5: Maßnahmen ergreifen und Probleme beheben
Sie wissen jetzt, warum Berichte fehlen, und können entsprechend reagieren.
Welche Maßnahme Sie ergreifen sollten, hängt von den type
der einzelnen ausführlichen Berichte ab. Weitere Informationen finden Sie in der Referenz zu ausführlichen Berichten. Beispiel:
pending-destination-limit
ist ein Datenschutz. Sie müssen nichts weiter unternehmen. Verwenden Sie diese Zahl als Datenpunkt für Ihre eigene Sichtbarkeit und Überwachung.trigger-aggregate-no-contributions
könnte ein Hinweis auf ein Implementierungsproblem auf Ihrer Seite sein. Analysieren Sie das genauer. Verwenden Sie die Details im Text des ausführlichen Berichts, um den Fehler bei Bedarf zu beheben.unknown-error
kann auf einen Browser- oder Netzwerkfehler hindeuten. Wenn dieser Fehler wiederholt auftritt, melden Sie den Browser-Entwicklern einen Fehler.