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

• 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

1. Richten Sie Ihr System so ein, dass Debug-Berichte zum Erfolg generiert werden. Teil 2: Debug-Berichte einrichten
2. 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.
3. 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.

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.

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.