Einige Privacy Sandbox-Technologien werden eingestellt.

Weitere Informationen

Privacy Sandbox-Funktionsstatus enthält weitere Informationen zum Status einzelner APIs und Plattformfunktionen.

Diese Seite wurde von der Cloud Translation API übersetzt.

Cookbook zur Fehlerbehebung bei Attribution Reporting

Teil 3 von 3 zum Debuggen von Attribution Reporting. Hier finden Sie eine Anleitung zur Verwendung von Debug-Berichten.

In diesem Cookbook finden Sie Anleitungen zur Verwendung von Debug-Berichten für verschiedene Anwendungsfälle, die in Teil 1: Einführung in Debug-Berichte beschrieben werden.

Glossar

The reporting origin is the origin that sets the Attribution Reporting source and trigger headers. All reports generated by the browser are sent to this origin. In this guidance, we use https://adtech.example as the example reporting origin.
An attribution report (report for short) is the final report (event-level or aggregatable) that contains the measurement data you've requested.
A debug report contains additional data about an attribution report, or about a source or trigger event. Receiving a debug report does not necessarily mean that something is working incorrectly! There are two types of debug reports
A transitional debug report is a debug report that requires a cookie to be set in order to be generated and sent. Transitional debug reports will be unavailable if a cookie is not set, and once third-party cookies are deprecated. All debug reports described in this guide are transitional debug reports.
Success debug reports track successful generation of an attribution report. They relate directly to an attribution report. Success debug reports have been available since Chrome 101 (April 2022).
Verbose debug reports can track missing reports and help you determine why they're missing. They indicate cases where the browser did not record a source or trigger event, (which means it will not generate an attribution report), and cases where an attribution report can't be generated or sent for some reason. Verbose debug reports include a type field that describes the reason why a source event, trigger event or attribution report was not generated. Verbose debug reports are available starting in Chrome 109 (Stable in January 2023).
Debug keys are unique identifiers you can set on both the source side and the trigger side. Debug keys enable you to map cookie-based conversions and attribution-based conversions. When you've set up your system to generate debug reports and set debug keys, the browser will include these debug keys in all attribution reports and debug reports.

For more concepts and key terms used throughout our documentation, refer to the Privacy Sandbox glossary.

Anleitung: Integration in Echtzeit prüfen

Richten Sie Ihr System so ein, dass Debug-Berichte zum Erfolg generiert werden. Teil 2: Debug-Berichte einrichten
Wenn Sie Code für Attributionsberichte bereitstellen, sollten Sie in Echtzeit prüfen, ob Sie Debug-Berichte zu erfolgreichen Ereignissen an Ihrem Endpunkt erhalten. Wenn ja, funktioniert die Einrichtung der Attribution Reporting API.
Erfolgreiche Debug-Berichte werden nur gesendet, wenn eine Conversion erfolgt. Stattdessen sollten Sie prüfen, ob Ihre Integration unabhängig von Conversions richtig eingerichtet ist, d. h., ob Quellen erfolgreich registriert werden. Dazu können Sie sich auf erfolgreiche Quellregistrierung und ausführliche Debugging-Berichte verlassen. Informationen zum Einrichten finden Sie unter Teil 2: Debug-Berichte einrichten.

Anleitung: Verluste analysieren und Fehlerbehebung bei der Integration

Wenn Sie Ergebnisse der cookiebasierten Conversion-Analyse mit Attribution Reporting-Berichten vergleichen möchten, verwenden Sie Debug-Schlüssel und ordnen Sie Cookie-Conversions Debug-Berichten zu. Denken Sie daran, dass Debug-Berichte sofort an Ihren Endpunkt gesendet werden.

Übersicht

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

Ja: Für alle diese Debug-Berichte zum Erfolg können Sie später einen Attributionsbericht erhalten – mit einigen Ausnahmen. Weitere Informationen finden Sie im Szenario für den Debugging-Bericht bei Erfolg.

Falls nicht: Die Conversion wurde nicht im Attribution Reporting erfasst. Verwenden Sie das <source_debug_key, trigger_debug_key>-Paar (oder den Quell-Debug-Schlüssel, wenn der Trigger-Debug-Schlüssel fehlt), um Cookie-Conversions Debug-Berichten mit ausführlichen Informationen 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 am Nutzerverhalten oder an einem Integrationsproblem liegen. Weitere Informationen finden Sie im Szenario ohne Debugging-Bericht.
Wenn Sie einen ausführlichen Debug-Bericht erhalten haben, sehen Sie sich das Feld type an.
- Wenn type gleich source-success ist, wurde die Quelle erfolgreich registriert, der Trigger jedoch nicht. Um den Grund für das Fehlen des Debug-Berichts zum Erfolg einzugrenzen, suchen Sie nach einem entsprechenden ausführlichen Debug-Bericht eines anderen Typs. Dieser Bericht weist auf ein Problem auf der Triggerseite hin.
- Wenn type einen anderen Wert hat, wurde die Quelle oder der Trigger nicht registriert. type gibt Aufschluss darüber. Der entsprechende Attributionsbericht (und der Debug-Bericht zum Erfolg) fehlt. Je nach type eines ausführlichen Debug-Berichts können Sie diese Informationen einfach als Datenpunkt für die Verlustanalyse betrachten (d. h. keine Maßnahmen für Sie) oder einen Fehler melden oder Ihre Implementierung beheben. Weitere Informationen finden Sie im Szenario für ausführliche Debugging-Berichte.

. Implementierungsprobleme zu erkennen.

Mögliche Szenarien

Erfolgsbericht zur Fehlerbehebung

Wenn Sie für eine bestimmte Cookie-Conversion einen Debug-Bericht mit dem Status „Erfolgreich“ erhalten haben, bedeutet das, dass diese Conversion erfolgreich mit Attribution Reporting registriert wurde.

Sie erhalten später einen Attributionsbericht für diese Conversion – mit einigen Ausnahmen:

Nutzerverhalten: Löschen von Daten nach der Conversion und vor dem Senden des Attributionsberichts, Schließen des Browsers 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. Diese Verzögerung kann als Verlust betrachtet werden.
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, bedeutet das, dass die Quellenregistrierung erfolgreich war. Je nachdem, ob die Triggerregistrierung später auch erfolgreich ist, erhalten Sie möglicherweise einen Bericht für diese Conversion.

Dabei ist Folgendes zu beachten:

Ausführlicher Debug-Bericht eines 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 daher später auch keinen Attributionsbericht, da ein ausführlicher Bericht bedeutet, dass ein meldepflichtiger Fehler aufgetreten ist. Die Quellenregistrierung, die Triggerregistrierung, die Berichterstellung oder das Senden von Berichten wurde durch ein Problem 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 vom type des jeweiligen ausführlichen Berichts ab. Referenz zu ausführlichen Berichten

Keine Debugging-Berichte

Wenn Sie für eine bestimmte Cookie-Conversion nur einen Attributionsbericht erhalten haben (keinen Debug-Bericht zum Erfolg und keinen ausführlichen Debug-Bericht), bedeutet das, dass etwas die Generierung der Debug-Berichte verhindert hat. Mögliche Ursachen:

Nutzereinstellungen (der Nutzer hat Drittanbieter-Cookies deaktiviert)
Fehlendes Cookie oder fehlende Schlüssel zur Fehlerbehebung (Schlüssel zur Fehlerbehebung wurden aufgrund eines fehlenden Cookies gelöscht). Öffnen Sie in chrome://attribution-internals den Tab Logs und prüfen Sie, ob dort Probleme angezeigt werden.
Netzwerkprobleme, die zum Zeitpunkt der Quelle oder des Triggers aufgetreten sind, aber nicht beim Senden des Attributionsberichts.

Erhalten Sie Attributionsberichte?

Dies ist ein Sonderfall, in dem Sie keinen Debug-Bericht erhalten: Wenn Sie für eine bestimmte Cookie-Conversion keinerlei Berichte erhalten haben (weder einen Debug-Bericht noch einen Attributionsbericht), ist ein nicht meldbarer Fehler aufgetreten. Mögliche Ursachen:

Grundlegendes Integrationsproblem. Informationen zur Fehlerbehebung finden Sie unter Grundlegende Integrationsprobleme beheben.
Mögliche Netzwerkprobleme.
Nutzereinstellungen in Browsereinstellungen wie Privacy Sandbox sind deaktiviert.

Referenz für ausführliche Debugging-Berichte

Jeder ausführliche Debug-Bericht enthält ein type-Feld, in dem der Grund für das Verwerfen des entsprechenden Attributionsberichts angegeben ist. Anhand der Referenz können Sie für jede type im ausführlichen Bericht die erforderliche Maßnahme ermitteln.

Hinweis:Wenn der 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 aggregierbaren Berichten verknüpft sind. In allen anderen Fällen handelt es sich entweder um einen Bericht auf Ereignisebene oder um einen aggregierbaren Bericht.

Registrierung der Quelle erfolgreich

Eine Quelle wurde registriert.

source-success: Details und Berichtstext

Berichte zu Datenschutzeinschränkungen

Diese Berichte sind zu erwarten. Sie weisen auf Datenschutzbeschränkungen hin, um die Offenlegung von Nutzeridentitäten über Websites hinweg 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 Meldung 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 festlegen, welche Berichte Sie erhalten möchten, indem Sie Prioritäten festlegen. Details und Berichtstext

Berichte zu Speicherbeschränkungen

Diese Berichte sind zu erwarten. Sie geben Speicherplatzbeschränkungen an, 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 Filterung, Deduplizierung, Prioritäten oder zeitfensterbasierte Filterung verwenden. Prüfen Sie zur Sicherheit die entsprechenden benutzerdefinierten Regeln, um zu bestätigen, dass der Bericht, der diesem ausführlichen Bericht entspricht, tatsächlich ein Bericht ist, den Sie entfernen möchten. Wenn das stimmt, müssen Sie 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

Andere ausführliche Berichte

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

trigger-no-matching-source: Möglicherweise liegt ein Implementierungsproblem vor. Prüfen Sie, ob die Einrichtung von <reporting origin, destination> fehlerhaft ist. Das ist möglicherweise auch ein normales API-Verhalten. Das kann beispielsweise der Fall sein, wenn der Nutzer nach der Interaktion mit einer Anzeige und vor der Conversion Daten gelöscht hat oder eine Conversion ausgeführt hat, ohne jemals eine zugehörige Anzeige gesehen zu haben. Details und Berichtstext
trigger-aggregate-no-contributions: Das ist wahrscheinlich nicht das gewünschte Verhalten. Fehlerbehebung bei Ihrem Triggerregistrierungscode: Achten Sie darauf, dass Ihre Beitragskonfiguration korrekt ist. Details und Berichtstext
trigger-aggregate-insufficient-budget: Das ist wahrscheinlich nicht das gewünschte Verhalten. Prüfen Sie den Registrierungscode für den Trigger noch einmal, um sicherzugehen, dass die Summe aller Beiträge das Beitragsbudget nicht überschreitet. Details und Berichtstext

Unerwartete Fehler (potenzielle Browserfehler)

Diese Berichte sind unerwartet. Möglicherweise liegt ein Browserfehler vor. Melden Sie einen Programmfehler und geben Sie in der Beschreibung die Schritte zur Reproduktion des Problems an.

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: Debug-Berichte einrichten, um Ihr System so einzurichten, dass Debug-Berichte für erfolgreiche Vorgänge und ausführliche Debug-Berichte generiert werden.

So können Sie anhand von cookiebasierten Conversion-Informationen die entsprechenden Debug- 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 Debug-Bericht „Erfolg“ (wird sofort gesendet), der dasselbe <source_debug_key, trigger_debug_key>-Paar wie diese cookiebasierte Conversion enthält.

Angenommen, Sie haben für 70 dieser Cookie-Conversions einen Debug-Bericht mit dem Status „Erfolgreich“ erhalten.

Erfolgsberichte bedeuten, dass die Zuordnung erfolgreich erfasst wurde. Sie können also davon ausgehen, dass Sie für jeden Erfolgsbericht einen entsprechenden Zuordnungsbericht erhalten – mit einigen Ausnahmen.
Sie können diese Ausnahmen überwachen. Suchen Sie dazu in den nächsten Tagen oder Wochen (je nach Ablaufdatum) nach den Attributionsberichten, die dasselbe Debug-Schlüsselpaar wie die einzelnen Debug-Berichte für erfolgreiche Ereignisse haben. Warten Sie etwas: Berichte werden möglicherweise nicht sofort am Ende jedes Zeitraums gesendet. Angenommen, Sie finden nur 60 Attributionsberichte. Die 10 fehlenden Attributionsberichte sind möglicherweise auf das Nutzerverhalten zurückzuführen.

Hinweis:Möglicherweise haben Sie Attributionsberichte auf Ereignisebene, die keiner cookiebasierten Conversion zugeordnet werden. Wahrscheinlich handelt es sich um Berichte mit Rauschen, die zufällig von der API generiert wurden. Sie können dies überprüfen, indem Sie nach ausführlichen Debug-Berichten vom Typ source-noised suchen, die denselben Quell-Debug-Schlüssel wie Ihr Bericht auf Ereignisebene haben.

Schritt 3: Kurze Verlustanalyse

100 – 70 = 30 Debug-Berichte für erfolgreiche Vorgänge fehlen. Das bedeutet, dass diese 30 Conversions, die in Ihrer cookiebasierten Implementierung erfasst wurden, nicht mit Attribution Reporting aufgezeichnet wurden. Sie erhalten keine Attributionsberichte für diese.

Da Sie 100 auf Cookies basierende Conversions und nur 70 auf Attribution basierende Conversions haben, beträgt Ihr Verlust 30%. Sie erhalten eine kurze Verlustanalyse.

Schritt 4: Ursachen analysieren

Um herauszufinden, warum diese Berichte fehlen, suchen Sie nach entsprechenden ausführlichen Debug-Berichten, die Sie zum Zeitpunkt der Conversion (Triggerregistrierung) oder früher zum Zeitpunkt der Quellregistrierung erhalten haben. Verwenden Sie die Schlüssel der cookiebasierten Conversions, um sie detaillierten Debug-Berichten zuzuordnen.

Angenommen, es gibt 10 Schlüssel, für die kein ausführlicher Debug-Bericht vorhanden ist. Prüfen Sie, ob es ein Integrationsproblem gibt. Wenn nicht, kann das am Nutzerverhalten liegen.
Sie haben 20 ausführliche Debug-Berichte. Sie können Ihre Verlustanalyse jetzt verfeinern. Analysieren Sie das Feld type jedes ausführlichen Berichts. Beispiele:
- 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 Fehler beheben

Nachdem Sie nun wissen, warum Berichte fehlen, können Sie entsprechende Maßnahmen ergreifen.

Welche Maßnahme Sie ergreifen sollten, hängt vom type des jeweiligen ausführlichen Berichts ab. Weitere Informationen finden Sie in der Referenz zu ausführlichen Berichten. Beispiel:

pending-destination-limit ist ein Datenschutz. Es besteht kein Handlungsbedarf. Verwenden Sie diese Zahl als Datenpunkt für Ihre eigene Sichtbarkeit und Ihr eigenes Monitoring.
trigger-aggregate-no-contributions kann auf ein Implementierungsproblem auf Ihrer Seite hinweisen. Analysiere das genauer. Anhand der Details im Text des ausführlichen Berichts können Sie das Problem bei Bedarf beheben.
unknown-error kann auf einen Browserfehler oder Netzwerkfehler hindeuten. Wenn dieses Problem wiederholt auftritt, melden Sie es den Browserentwicklern.