Diese Seite wurde von der Cloud Translation API übersetzt.

Cookbook zur Fehlerbehebung bei Attribution Reporting

Teil 3 von 3 zum Beheben von Problemen mit Attributionsberichten. Anleitung zum Verwenden von Debug-Berichten

In diesem Rezeptbuch finden Sie eine Anleitung zur Verwendung von Debug-Berichten für verschiedene Anwendungsfälle, die in Teil 1: Einführung in Debug-Berichte 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 Erfolgs-Debugberichte generiert werden. Weitere Informationen finden Sie unter Teil 2: Debug-Berichte einrichten.
Wenn Sie Code für die Attributionsberichte implementieren, prüfen Sie in Echtzeit, ob Sie Debug-Erfolgsberichte für Ihren Endpunkt erhalten. In diesem Fall funktioniert die Einrichtung der Attributionsberichte.
Berichte zur Fehlerbehebung nach einem erfolgreichen Vorgang werden nur gesendet, wenn eine Conversion erfolgt. Prüfen Sie stattdessen, ob Ihre Integration unabhängig von Conversions richtig eingerichtet ist. Das bedeutet, dass Sie prüfen sollten, ob die Quellen erfolgreich registriert sind. Dazu können Sie ausführliche Debug-Berichte zur Erfolgreichen Registrierung der Quelle verwenden. Informationen zum Einrichten finden Sie unter Teil 2: Debug-Berichte einrichten.

Anleitung: Datenverluste analysieren und Integrationsprobleme beheben

Wenn Sie die Ergebnisse der cookiebasierten Conversion-Analyse mit Berichten zu Attributionsberichten vergleichen möchten, verwenden Sie Debug-Schlüssel und ordnen Sie Cookie-Conversions Debug-Berichten zu. De-Bug-Berichte werden sofort an Ihren Endpunkt gesendet.

Übersicht

Verwenden Sie die Debug-Schlüssel (<source_debug_key, trigger_debug_key>-Paar), um Cookie-Conversions Berichten zum erfolgreichen Debuggen zuzuordnen. Haben Sie für jede Cookie-Conversion zum Zeitpunkt der Conversion einen entsprechenden Debug-Bericht zum Erfolg erhalten?

Ja: Sie erhalten mit wenigen Ausnahmen für alle diese Berichte zu erfolgreichen Fehlerbehebungen später einen Attributionsbericht. Weitere Informationen finden Sie im Szenario für den Erfolgsbericht zur Fehlerbehebung.

Andernfalls: Die Conversion wurde nicht in den Attributionsberichten erfasst. Verwenden Sie das <source_debug_key, trigger_debug_key>-Paar (oder den Quell-Debug-Schlüssel, falls der Trigger-Debug-Schlüssel fehlt), um Cookie-Conversions detaillierten Debug-Berichten zuzuordnen. Haben Sie für jede dieser Conversions irgendwann (Quell- oder Triggerzeit) einen entsprechenden ausführlichen Debug-Bericht erhalten?

Wenn Sie keinen ausführlichen Debug-Bericht erhalten haben, kann das an Nutzerverhalten oder an einem Integrationsproblem liegen. Weitere Informationen finden Sie im Szenario ohne Debugbericht.
Wenn Sie einen ausführlichen Debug-Bericht erhalten haben, sehen Sie sich das Feld type an.
- Wenn type source-success ist, wurde die Quelle zwar registriert, der Trigger jedoch nicht. Wenn Sie den Grund für das Fehlen des Debug-Berichts für den Erfolg eingrenzen möchten, suchen Sie nach einem entsprechenden ausführlichen Debug-Bericht eines anderen Typs. In diesem Bericht wird ein Problem auf der Triggerseite angezeigt.
- Wenn type einen anderen Wert hat: Die Quelle oder der Trigger wurde nicht registriert. type gibt Aufschluss darüber. Der entsprechende Attributionsbericht (und der Bericht zur Fehlerbehebung für erfolgreiche Kampagnen) fehlen. Je nach type eines ausführlichen Debugberichts können Sie diese Informationen einfach als Datenpunkt für die Fehleranalyse verwenden (d. h. keine Maßnahmen ergreifen) oder einen Fehler melden oder die Implementierung beheben. Weitere Informationen finden Sie im Szenario für ausführliche Debugberichte.

Mögliche Szenarien

Bericht zur Fehlerbehebung bei Erfolg

Wenn Sie für eine bestimmte Cookie-Conversion einen erfolgreichen Debug-Bericht erhalten haben, wurde diese Conversion in den Attributionsberichten erfolgreich registriert.

Sie erhalten später einen Attributionsbericht für diese Conversion.⏤ Es gibt jedoch einige Ausnahmen:

Nutzerverhalten: Daten werden nach der Conversion gelöscht und der Attributionsbericht wird nicht gesendet. Der Browser wird geschlossen usw. Wenn ein Nutzer seinen Browser nach der Conversion schließt und ihn eine Woche lang nicht öffnet, wird der Bericht erst nach einer Woche oder später gesendet. Sie können diese Verzögerung als Verlust betrachten.
Nur auf 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 Triggerregistrierung später auch erfolgreich ist, erhalten Sie möglicherweise einen Bericht für diese Conversion.

Es gibt jedoch eine Einschränkung:

Ausführlicher Debugbericht eines beliebigen anderen Typs

Wenn Sie für eine bestimmte Cookie-Conversion einen ausführlichen Debug-Bericht eines anderen Typs erhalten haben, erhalten Sie keinen Debug-Bericht zum Erfolg und später auch keinen Attributionsbericht. Ein ausführlicher Bericht bedeutet, dass ein berichtsfähiger Fehler aufgetreten ist. Die Registrierung der Quelle, der Trigger, die Berichterstellung oder das Senden von Berichten wurde verhindert. Mögliche Ursachen:

Datenschutzeinschränkungen
Speichergrenzwerte
Benutzerdefinierte Regeln
Implementierungsproblem in Ihrem Code
Browserfehler

Einige davon sind ganz normal. Welche Aktion ausgeführt werden soll, hängt von der type des jeweiligen ausführlichen Berichts ab. Weitere Informationen finden Sie in der Referenz zu ausführlichen Berichten.

Keine Debug-Berichte

Wenn Sie für eine bestimmte Cookie-Conversion nur einen Attributionsbericht erhalten haben (keinen Erfolgs- oder ausführlichen Debug-Bericht), konnte der Debug-Bericht aus einem bestimmten Grund nicht erstellt werden. Mögliche Ursachen:

Nutzereinstellungen (der Nutzer hat Drittanbieter-Cookies deaktiviert)
Fehlendes Cookie oder fehlende Debug-Schlüssel (Debug-Schlü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 angezeigt wird.
Netzwerkprobleme, die zum Zeitpunkt der Quelle oder des Auslösers aufgetreten sind, aber nicht zum Zeitpunkt des Sendens des Attributionsberichts.

Erhalten Sie Attributionsberichte?

Dies ist ein Sonderfall des Nichterhalts eines Debug-Berichts: Wenn Sie für eine bestimmte Cookie-Conversion keine Berichte erhalten haben (weder Debug-Berichte noch Attributionsberichte), ist ein nicht berichtbarer Fehler aufgetreten. Mögliche Ursachen:

Grundlegendes Integrationsproblem. Wie Sie diese Probleme beheben, erfahren Sie unter Grundlegende Integrationsprobleme beheben.
Mögliche Netzwerkprobleme.
Nutzereinstellungen in den Browsereinstellungen, z. B. Privacy Sandbox, sind deaktiviert.

Ausführliche Debugberichte

Jeder ausführliche Debug-Bericht enthält ein type-Feld, in dem der Grund für das Aussetzen des entsprechenden Attributionsberichts angegeben ist. Anhand der Referenz können Sie für jede type des ausführlichen Berichts ermitteln, welche Maßnahmen ergriffen werden müssen.

Hinweis:Wenn die type eines ausführlichen Berichts mit trigger-event beginnt, kann er nur für Quell- oder Triggerereignisse generiert werden, die mit Berichten auf Ereignisebene verknüpft sind. Wenn die type eines ausführlichen Berichts mit trigger-aggregate beginnt, kann er nur für Quell- oder Triggerereignisse generiert werden, die mit aggregierten Berichten verknüpft sind. In allen anderen Fällen bezieht er sich entweder auf einen Bericht auf Ereignisebene oder einen aggregierten Bericht.

Quelle erfolgreich registriert

Eine Quelle wurde erfolgreich registriert.

source-success: Details und Berichtskörper

Berichte zu Datenschutzeinschränkungen

Diese Meldungen sind zu erwarten. Sie geben Datenschutzeinschränkungen an, um die Weitergabe von Nutzeridentitäten zwischen Websites zu reduzieren.

source-destination-limit: Details und Berichtskörper
source-noised: Details und Berichtskörper
trigger-attributions-per-source-destination-limit: Details und Berichtskörper
trigger-reporting-origin-limit: Details und Berichtskörper
trigger-event-noise: Details und Berichtskörper
trigger-event-excessive-reports: Dieser Wert wird generiert, wenn die Berichtszahl das Limit überschreitet. Sie können maximal eine Conversion für Aufrufe und drei für Klicks erfassen. Sie können festlegen, welche Berichte Sie erhalten möchten, indem Sie Prioritäten festlegen. Details und Berichtskörper

Berichte zu Speicherplatzlimits

Diese Meldungen sind zu erwarten. Sie geben Speicherlimits an, um eine übermäßige Ressourcennutzung zu verhindern.

source-storage-limit: Details und Berichtskörper
trigger-event-storage-limit: Details und Berichtskörper
trigger-aggregate-storage-limit: Details und Berichtskörper

Berichte zu benutzerdefinierten Regeln

Diese Berichte sind zu erwarten, wenn Sie Filter, Deduplizierung, Prioritäten oder fensterbasierte Filter verwenden. Prüfen Sie zur Sicherheit die entsprechenden benutzerdefinierten Regeln, um sicherzugehen, dass der Bericht, der dem ausführlichen Bericht entspricht, tatsächlich der Bericht ist, den Sie löschen möchten. Wenn das der Fall ist, müssen Sie nichts unternehmen.

trigger-no-matching-filter-data: Details und Berichtskörper
trigger-event-no-matching-configuration: Details und Berichtskörper
trigger-event-deduplicated: Details und Berichtskörper
trigger-aggregate-deduplicated: Details und Berichtskörper
trigger-event-low-priority: Details und Berichtskörper
trigger-event-report-window-passed: Details und Berichtskörper
trigger-aggregate-report-window-passed: Details und Berichtskörper

Andere ausführliche Berichte

Diese Berichte können auf potenzielle Implementierungsprobleme in Ihrem Code hinweisen.

trigger-no-matching-source: Das kann ein Implementierungsproblem sein. Prüfen Sie, ob die <reporting origin, destination>-Einrichtung fehlerfrei ist. Das kann auch ein normales API-Verhalten sein. Beispielsweise hat der Nutzer nach einer Interaktion mit einer Anzeige und vor einer Conversion Daten gelöscht oder er hat eine Conversion ausgeführt, ohne eine zugehörige Anzeige gesehen zu haben. Details und Berichtskörper
trigger-aggregate-no-contributions: Das ist wahrscheinlich nicht das gewünschte Verhalten Ihres Codes. Fehlerbehebung für den Triggerregistrierungscode durchführen und prüfen, ob die Beitragskonfiguration korrekt ist. Details und Berichtskörper
trigger-aggregate-insufficient-budget: Das ist wahrscheinlich nicht das gewünschte Verhalten Ihres Codes. Prüfe den Code zur Triggerregistrierung noch einmal, um sicherzugehen, dass die Summe aller Beiträge das Beitragsbudget nicht überschreitet. Details und Berichtskörper

Unerwartete Fehler (mögliche Browserfehler)

Diese Meldungen sind unerwartet. Möglicherweise liegt ein Browserfehler vor. Melden Sie einen Fehler und geben Sie in der Beschreibung die Schritte an, mit denen er reproduziert werden kann.

source-unknown-error: Details und Berichtskörper
trigger-unknown-error: Details und Berichtskörper

Beispiel für eine Verlustanalyse

Schritt 1: Einrichtung und Zuordnung mit Cookies

Folgen Sie der Anleitung unter Teil 2: Debug-Berichte einrichten, um Ihr System so einzurichten, dass Erfolgs-Debugberichte und ausführliche Debugberichte generiert werden.

So können Sie anhand von cookiebasierten Conversion-Informationen die entsprechenden Debugging- oder Attributionsberichte aufrufen.

Schritt 2: Erfolgreiche Registrierungen und fehlende Berichte ermitteln

Angenommen, Sie haben mit Ihrem cookiebasierten System 100 Conversions erfasst.

Suchen Sie jedes Mal, wenn Sie eine cookiebasierte Conversion erfassen, nach dem sofort gesendeten Debug-Bericht zum Erfolg, der dasselbe <source_debug_key, trigger_debug_key>-Paar wie diese cookiebasierte Conversion enthält.

Angenommen, Sie haben einen Bericht zur Fehlerbehebung für 70 dieser Cookie-Conversions erhalten.

Wenn Sie einen Erfolgsbericht erhalten, wurde die Attribution erfolgreich erfasst. Sie können davon ausgehen, dass Sie mit wenigen Ausnahmen für jeden Erfolgsbericht einen Attributionsbericht erhalten.
Sie können diese Ausnahmen überwachen. Suchen Sie dazu in den Attributionsberichten, die in den nächsten Tagen/Wochen (je nach Ablaufdatum) an Ihren Endpunkt gesendet werden, nach den Attributionsberichten mit demselben Debug-Schlüsselpaar wie in jedem Debug-Bericht für den Erfolg. Warten Sie etwas: Berichte werden möglicherweise nicht sofort am Ende jedes Zeitraums gesendet. Angenommen, Sie finden nur 60 Attributionsberichte. Die 10 fehlenden Attributionsberichte können auf Nutzerverhalten zurückzuführen sein.

Hinweis:Möglicherweise haben Sie Attributionsberichte auf Ereignisebene, die keiner cookiebasierten Conversion zugeordnet werden können. Das sind höchstwahrscheinlich Berichte mit vielen Ausreißern, die von der API zufällig generiert wurden. Sie können dies überprüfen, indem Sie nach ausführlichen Debugberichten vom Typ source-noised suchen, die denselben Debug-Schlüssel für die Quelle wie Ihr Bericht auf Ereignisebene haben.

Schritt 3: Kurze Verlustbewertung

100 − 70 = 30 Erfolgsberichte für die Fehlerbehebung fehlen. Das bedeutet, dass diese 30 Conversions, die in Ihrer cookiebasierten Implementierung erfasst wurden, nicht in den Attributionsberichten berücksichtigt wurden. Für diese erhalten Sie keine Attributionsberichte.

Da Sie 100 cookiebasierte Conversions und nur 70 attributionsbasierte Conversions haben, beträgt der Verlust 30%. Sie sehen 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 (Triggerregistrierung) oder früher zur Zeitpunkt der Quellenregistrierung erhalten haben. Verwenden Sie die Schlüssel der cookiebasierten Conversions, um sie ausführlichen Debugberichten zuzuordnen.

Angenommen, es gibt 10 Schlüssel, für die es keinen ausführlichen Debug-Bericht gibt. Prüfen Sie, ob es ein Integrationsproblem gibt. Andernfalls kann das an Nutzerverhalten liegen.
Sie haben 20 ausführliche Debug-Berichte. Sie können die Verlustanalyse jetzt verfeinern. Analysieren Sie das Feld type jedes ausführlichen Berichts. Sie stellen beispielsweise fest, dass:
- 10 Berichte (= 10% in unserem Beispiel) fehlen aufgrund von pending destination limit.
- 5 Berichte (= 5%) fehlen aufgrund von trigger-aggregate-no-contributions.
- 5 Berichte (= 5%) fehlen aufgrund von unknown-error.

Schritt 5: Maßnahmen ergreifen und Probleme beheben

Nachdem Sie nun wissen, warum Berichte fehlen, können Sie diese Informationen nutzen.

Welche Aktion ausgeführt werden soll, hängt von der type des jeweiligen ausführlichen Berichts ab. Weitere Informationen finden Sie in der Referenz zu ausführlichen Berichten. Beispiel:

pending-destination-limit ist ein Datenschutzmechanismus. Sie müssen nichts unternehmen. Verwenden Sie diese Zahl als Datenpunkt, um die Sichtbarkeit und Überwachung zu verbessern.
trigger-aggregate-no-contributions kann ein Hinweis auf ein Implementierungsproblem auf Ihrer Seite sein. Analysieren Sie das genauer. Verwenden Sie die Details im Text des ausführlichen Berichts, um das Problem zu beheben.
unknown-error kann ein Hinweis auf einen Browserfehler oder Netzwerkfehler sein. Wenn das Problem wiederholt auftritt, melden Sie einen Fehler an die Browserentwickler.