Teil 1 von 3 zur Fehlerbehebung bei Attributionsberichten Hier erfahren Sie, warum das Debugging wichtig ist und wann Sie Debugging-Berichte beim Testen verwenden sollten.
Warum Sie Debugging-Berichte benötigen
Wenn Sie die Attribution Reporting API testen, sollten Sie prüfen, ob Ihre Integration ordnungsgemäß funktioniert, und Lücken in den Messergebnissen zwischen Ihren auf Cookies basierende Implementierung und die Implementierung von Attribution Reporting sowie die Behebung von Problemen mit der Integration.
Für diese Aufgaben sind Debugging-Berichte erforderlich. Daher empfehlen wir Ihnen dringend, sie einzurichten.
Glossar
Wichtige Aspekte von Fehlerbehebungsberichten
Zwei Arten von Fehlerbehebungsberichten
Es stehen zwei Arten von Fehlerbehebungsberichten zur Verfügung. Sie sollten beide verwenden, da sie unterschiedliche Anwendungsfälle erfüllen.
Berichte zur Fehlerbehebung
In Berichten zur Fehlerbehebung wird die erfolgreiche Erstellung eines Attributionsberichts erfasst. Sie beziehen sich auf direkt zu einem Attributionsbericht.
Berichte zur Fehlerbehebung sind seit Chrome 101 (April 2022) verfügbar.
Ausführliche Debugging-Berichte
Ausführliche Debugging-Berichte bieten einen besseren Einblick in die Quelle und die auslösenden Ereignisse. So können Sie entweder prüfen, ob Quellen erfolgreich registriert wurden, oder fehlende Berichte verfolgen und feststellen, warum sie fehlen (Fehler in Quelle oder Trigger-Ereignisse, Fehler beim Senden oder Erstellen des Berichts). Ausführliche Debug-Berichte enthalten folgende Informationen:
- Fälle, in denen der Browser eine Quelle erfolgreich registriert hat.
- Fälle, in denen vom Browser eine Quelle nicht erfolgreich registriert oder ein Ereignis ausgelöst wurde, d. h., es wird kein Attributionsbericht erstellt.
- Fälle, in denen ein Attributionsbericht aus irgendeinem Grund nicht erstellt oder gesendet werden kann.
Ausführliche Fehlerbehebungsberichte enthalten ein type-Feld, das entweder eine erfolgreiche Quellenregistrierung oder den Grund beschreibt, warum ein Quellen-, Trigger- oder Attributionsbericht nicht generiert wurde.
Berichte zur ausführlichen Fehlerbehebung sind seit Chrome 109 (Januar 2023) verfügbar – mit Ausnahme von ausführlichen Debug-Berichten zur erfolgreichen Quellregistrierung, die später in Chrome 112 hinzugefügt werden.
Sehen Sie sich Beispielberichte in Teil 2: Berichte zur Fehlerbehebung einrichten an.
Fehlerbehebungsberichte basieren auf Cookies
Wenn Sie Debugging-Berichte verwenden möchten, muss die Quelle der Berichterstellung ein Cookie setzen.
Wenn der für den Empfang von Berichten konfigurierte Ursprung ein Drittanbieter ist, ist dieses Cookie ein Drittanbieter Cookie. Dies hat einige wesentliche Auswirkungen:
- Debugging-Berichte werden nur erstellt, wenn Drittanbieter-Cookies im Browser des Nutzers zulässig.
- Debug-Berichte sind nicht mehr verfügbar, nachdem Drittanbieter-Cookies eingestellt.
Debug-Berichte werden sofort gesendet
Debug-Berichte werden vom Browser sofort an den Ursprung der Berichterstellung gesendet. Dieses im Gegensatz zu Attributionsberichten, die mit einem Verspätung.
Berichte zur Fehlerbehebung werden generiert und gesendet, sobald wird der entsprechende Attributionsbericht erstellt, also bei Registrierung.
Ausführliche Debug-Berichte werden sofort nach der Quelle oder dem Trigger gesendet Registrierung.
Debugging-Berichte haben unterschiedliche Endpunktpfade
Wie bei den Attributionsberichten werden auch alle Fehlerbehebungsberichte an den Ursprung der Berichterstellung gesendet. Debugging-Berichte werden an drei separate Endpunkte des Ursprungs der Berichterstellung gesendet:
- Endpunkt für Erfolgs-Debug-Berichte, Ereignisebene
- Endpunkt für Erfolgs-Debug-Berichte, aggregierbar
- Endpunkt für ausführliche Fehlerbehebungsberichte, auf Ereignisebene und aggregierbar.
Weitere Informationen finden Sie in Teil 2: Berichte zur Fehlerbehebung einrichten.
Anwendungsfälle
Einfache Prüfung der Integration in Echtzeit
Im Gegensatz zu Attributionsberichten werden Debug-Berichte sofort an Ihren Endpunkt gesendet die aus Datenschutzgründen verzögert werden. Verwenden Sie Debugging-Berichte als Echtzeitsignal dafür, Die Attribution Reporting API funktioniert.
Weitere Informationen dazu finden Sie in Teil 3: Debugging-Cookbook.
Verlustanalyse
Im Gegensatz zu Drittanbieter-Cookies werden in Attribution Reporting API mit integriertem Datenschutz Schutzmechanismen, die ein Gleichgewicht zwischen Nutzen und Datenschutz. Das bedeutet, dass Sie mit der Attribution Reporting API möglicherweise alle Messdaten erfassen können, die Sie derzeit mit Cookies. Nicht alle Conversions, die wird ein Attributionsbericht erstellt.
Beispiel: Für Berichte auf Ereignisebene können Sie höchstens eine Conversion erfassen. pro Impression. Das bedeutet, dass Sie für eine bestimmte Anzeigenimpression nur einen Attributionsbericht erhalten, unabhängig davon, wie oft der Nutzer eine Conversion ausführt.
Verwenden Sie Debugging-Berichte, um einen Einblick in die Unterschiede zwischen Ihren Cookie-basierten Messergebnissen und den Ergebnissen der Attribution Reporting API Ermitteln, welche Conversions erfasst und wie viele Conversions erfasst werden nicht gemeldet werden, und insbesondere welche und warum.
Informationen zum Ausführen einer Verlustanalyse finden Sie in Teil 3: Fehlerbehebung im Cookbook.
Fehlerbehebung
Verluste durch Datenschutz oder Ressourcenschutz sind zu erwarten, andere Verluste kann unbeabsichtigt sein. Fehlkonfigurationen in Ihrer Implementierung oder Fehler im Browser selbst können dazu führen, dass Berichte fehlen.
Mithilfe von Debug-Berichten können Sie Implementierungsprobleme auf Ihrer Seite erkennen und beheben oder können Browserteams einen potenziellen Fehler melden. Eine Anleitung dazu finden Sie unter Teil 3: Fehlerbehebung im Cookbook
Erweiterte Konfigurationsprüfung
Mit einigen Funktionen der Attribution Reporting API können Sie die Verhaltensweisen. Beispiele hierfür sind Filterregeln, Deduplizierungsregeln und Prioritätsregeln.
Wenn Sie diese Funktionen nutzen, verwenden Sie Debugging-Berichte, um zu überprüfen, ob Ihre Logik zum gewünschten Verhalten in ohne auf Attributionsberichte warten zu müssen. Weitere Informationen hierzu finden Sie in Teil 3: Fehlerbehebung im Cookbook.
Lokale Tests mit aggregierbaren Berichten
Im Gegensatz zu zusammengefassten Attributionsberichten, die verschlüsselt sind, Die unverschlüsselte Nutzlast muss enthalten sein.
Verwenden Sie aggregierte Debugging-Berichte, um den Inhalt von aggregierten Berichten zu validieren, und mit dem lokalen Aggregationstool zusammenfassende Berichte zu Testzwecken zu erstellen.
Aggregationsdienst-Berichte noch einmal verarbeiten
Ein weiterer Vorteil des Debug-Modus besteht darin, dass Sie Berichte noch einmal verarbeiten können. Wenn Sie Berichte mehrmals verarbeiten möchten, müssen Sie also Debug-Berichte aktivieren. Sie können Berichte in folgenden Fällen erneut verarbeiten:
- wenn Sie versuchen, den Aggregationsdienst zu debuggen.
- verschiedene Batch-Strategien auszuprobieren.
- mit verschiedenen Epsilon-Werten.
Datenwiederherstellung
Wir empfehlen Anzeigentechnologie-Anbietern, den Debug-Modus zu aktivieren, um entsprechende Berichte zu erhalten. So können sie ihre Berichtsdaten wiederherstellen. Dies ist bei Problemen mit dem Aggregationsdienst nützlich, z. B. bei nicht verfügbaren oder nicht reagierenden Diensten, die dazu führen können, dass der Zusammenfassungsbericht nicht erstellt werden kann.