Erfassen, wenn ein Anzeigenklick oder ein Anzeigenaufruf zu einer Conversion führt, z. B. zu einem Kauf auf der Website eines Werbetreibenden.
Für wen ist das interessant?
In diesem Artikel werden die Grundlagen von Attribution Reporting beschrieben und einige zugrunde liegende Konzepte erläutert. Die technischen Details werden dabei jedoch nicht sehr ausführlich behandelt.
- Wenn Sie im Bereich Werbung oder Anzeigentechnologie arbeiten, informieren Sie sich über die Funktionen dieser API, die derzeit durch Drittanbieter-Cookies ermöglicht werden. Sehen Sie sich die API-Anwendungsfälle an, in denen beschrieben wird, wie die Berichte generiert werden.
- Wenn Sie ein Entwickler oder Softwareentwickler sind, können Sie die vollständige Systemübersicht aufrufen oder die API experimentieren und daran teilnehmen.
Werbetreibende und Publisher, die für die Conversion-Messung auf AdTech-Plattformen angewiesen sind, müssen die API nicht direkt verwenden. Wenn Sie als Anzeigentechnologie-Anbieter vorhaben, diese API einzubinden, erfahren Sie möglicherweise, wie Attributionsberichte funktionieren.
Was ist die Attribution Reporting API?
Heutzutage werden Conversions oft mithilfe von Drittanbieter-Cookies erfasst. Browser beschränken den Zugriff auf Drittanbieter-Cookies, da diese verwendet werden können, um Nutzer websiteübergreifend zu verfolgen und den Datenschutz der Nutzer zu beeinträchtigen.
Die Attribution Reporting API ermöglicht diese Messungen auf datenschutzfreundliche Weise ohne Drittanbieter-Cookies.
Mit dieser API können Werbetreibende und Anzeigentechnologie-Anbieter Conversions in folgenden Fällen messen:
- Klicks und Anzeigenaufrufe:
- Anzeigen in einem Drittanbieter-iFrame, z. B. Anzeigen auf einer Publisher-Website, für die ein Anzeigentechnologie-Drittanbieter verwendet wird
- Anzeigen in Erstanbieter-Kontext wie Anzeigen in einem sozialen Netzwerk oder auf Suchmaschinenergebnisseiten oder ein Publisher, der seine eigenen Anzeigen schaltet
Wenn Sie mit einigen dieser Begriffe oder Konzepte nicht vertraut sind, sehen Sie sich das Privacy Sandbox-Glossar an.
API testen
- Teste sie lokal in deinem Browser. Setzen Sie ein Flag, das den Chrome-Browser mitteilt, bestimmte experimentelle Funktionen zu aktivieren.
Wenn Sie mit der API experimentieren möchten, rufen Sie Attribution Reporting: Experiment and Party auf.
API-Änderungen
- Behalte die API-Änderungen im Blick.
- Sehen Sie sich an, warum wir voraussichtlich im ersten Halbjahr 2023 die Attribution Reporting API einführen.
Verfügbarkeit
Vorschlag | Status |
---|---|
Berichte auf Ereignisebene zu Klicks und Aufrufen Erläuterung |
In Chrome verfügbar |
Aggregierbare Berichte für Klicks und Aufrufe Erläuterung |
In Chrome verfügbar |
Conversion-Pfad: App-zu-Web Erklärung über das Web und Erklärung für Android Ankündigung zu Mailingliste |
Verfügbar in Chrome und Android für den Ursprungstest |
Conversion-Pfad: geräteübergreifend Erläuterung |
Dieses Angebot wurde archiviert. Es gibt derzeit keine Pläne für eine Implementierung. |
Ungültige aggregierte Berichte durch Berichtsüberprüfung verhindern Erläuterung |
Voraussichtlich im 1. HJ 2024 in Chrome |
Unterstützung mehrerer Ziele bei der Quellregistrierung Chromium-Programmfehler |
Ab dem 1. Quartal 2023 in Chrome verfügbar |
Standardzulassungsliste für die Richtlinie zu Berechtigungen für die Attribution Reporting API bleibt bestehen * Ankündigung in der Mailingliste |
Ab dem 1. Quartal 2023 in Chrome verfügbar |
Unterstützung von filterbasierten Deduplizierungsschlüsseln für aggregierte Berichte Ankündigung in Mailinglisten |
Ab dem 1. Quartal 2023 in Chrome verfügbar |
Unterstützung für erfolgreiche Berichte zur Quellenregistrierung im ausführlichen Debugging Debugging-Cookbook |
Ab dem 1. Quartal 2023 in Chrome verfügbar |
Weniger Verzögerungen bei aggregierten Berichten GitHub-Problem | Aktualisierte Erläuterung |
Ab dem 2. Quartal 2023 in Chrome verfügbar |
Phase 1 Lite: Flexible Ereignisebene Erläuterung der flexiblen Konfigurationen auf Ereignisebene |
Voraussichtlich in Chrome ab dem 4. Quartal 2023 |
Phase 2: Vollständig flexible Ereignisebene Erläuterung zu flexiblen Konfigurationen auf Ereignisebene |
Voraussichtlich in Chrome ab dem 1. Quartal 2024 |
Unterstützung für die Fehlerbehebung in Attributionsberichten nach der Einstellung von Drittanbieter-Cookies Feedback zu GitHub erhalten |
Voraussichtlich im 1. HJ 2024 in Chrome |
Unterstützung für die Attribution Reporting API und den Aggregation Service für Google Cloud Erläuterung der Attribution Reporting API Erläuterung zum Aggregationsdienst |
Voraussichtlich im 2. HJ 2023 in Chrome |
Anwendungsfälle und Features
Die Attribution Reporting API bietet Zugriff auf verschiedene Arten von Informationen. Dazu werden zwei Arten von Berichten verwendet, die an einen Werbetreibenden oder einen externen Anzeigentechnologie-Anbieter gesendet werden können. Diese beiden Berichtstypen können gleichzeitig verwendet werden und ergänzen sich.
- In Berichten auf Ereignisebene wird ein bestimmter Anzeigenklick oder eine bestimmte Anzeigenansicht (auf der Anzeigenseite) mit Daten auf Conversion-Seite verknüpft. Die Daten auf Conversion-Seite sind sehr begrenzt und die Daten sind Rauschen (d. h. in einigen wenigen Fällen werden zufällige Daten statt echter Berichte gesendet). So wird der Datenschutz gewahrt, weil die Zusammenführung der Nutzeridentität über mehrere Websites hinweg verhindert wird. Als zusätzlicher Datenschutz werden Berichte nicht sofort gesendet.
- Zusammenfassungsberichte sind nicht an ein bestimmtes Ereignis auf Anzeigenebene gebunden. Diese Berichte bieten umfangreichere und aussagekräftigere Conversion-Daten als Berichte auf Ereignisebene. Durch eine Kombination von Datenschutztechniken lässt sich das Risiko verringern, dass eine Identität über mehrere Websites hinweg zusammengeführt wird.
Berichte auf Ereignisebene
In Berichten auf Ereignisebene wird ein Anzeigenklick oder eine Anzeigenansicht mit groben Conversion-Daten verknüpft.

news.example
(angehängt an die Nutzer-ID Bob_Doe am news.example
) hat zu einem Kauf bei shop.example
geführt.
Berichte auf Ereignisebene eignen sich für:
- Optimierung Beantworten Sie Fragen wie „Wie kann ich meinen Return on Investment verbessern?“. Diese Berichte können insbesondere zur Optimierung des Anzeigen-Placements verwendet werden, da eindeutige IDs auf Anzeigenseite in den Berichten zur Verfügung gestellt werden können. Berichte auf Ereignisebene können Trainingsdaten für Modelle für maschinelles Lernen enthalten.
- Grobe Berichte, bei denen nur sehr wenige Informationen zur Conversion erforderlich sind. Das aktuelle Limit beträgt 3 Bit für Conversion-Daten für Klicks. Eine Conversion kann also einer von acht Kategorien und 1 Bit für Aufrufe zugewiesen werden. Die Codierung detaillierter Daten auf Conversion-Seite, z. B. eines bestimmten Preises oder einer Conversion-Zeit, wird in Berichten auf Ereignisebene nicht unterstützt.
- Betrugerkennung: Die Daten in einigen Berichten können bei der Erkennung und Analyse von Werbebetrug nützlich sein, da Sie Muster erkennen, mit denen sich Spam oder ungültige Aktivitäten identifizieren lassen.
Zusammenfassungsberichte
Zusammenfassende Berichte (früher „zusammengefasste Berichte“) bieten detailliertere Conversion-Daten und mehr Flexibilität beim Zusammenführen von Klick-/Aufruf- und Conversion-Daten.
Weitere Informationen zu Zusammenfassungsberichten

news.example
hat zu 518 Conversions am shoes.example
und zu Gesamtausgaben von 38.174 € geführt. Die Hälfte der Conversions stammte von Nutzern aus New York City.Zusammenfassungsberichte eignen sich am besten für Anwendungsfälle der Berichterstellung. In diesen Berichten erhalten Sie Antworten auf Fragen wie „Wie hoch ist mein Return on Investment?“.
Die Verwendung von Zusammenfassungsberichten zur Optimierung – z. B. zur Optimierung im Hinblick auf einen Kaufwert, wird von Berichten auf Ereignisebene nicht unterstützt (weil die Conversion-Daten zu ungenau sind) – ist ein Bereich der aktiven Forschung.
Weitere Funktionen
Weitere Funktionen dieser API:
- App-zu-Web-Attribution: Nutzer sehen eine Anzeige in einer App oder klicken darauf und führen die Conversion im Web aus.
- Geräteübergreifende Attribution: Sie sehen eine Anzeige auf Mobilgeräten oder klicken sie an und führen die Conversion auf dem Computer aus.
Unterstützte Browser
- Firefox und Edge haben keine gemeinsamen Signale.
- Safari/Webkit ist ausschließend und hat eine andere API zum Messen von Anzeigen-Conversions vorgeschlagen: die private Klickmessung.
Unterschiede zwischen der Attribution Reporting API und der von WebKit vorgeschlagenen API
Obwohl sich die beiden APIs unterscheiden, arbeiten Chrome und WebKit in der offenen Zusammenarbeit zusammen, um die Entwicklung von Anwendungen zu vereinfachen, z. B. durch Abstimmung auf die Attributnamen und die JSON-Struktur für Berichte.
Die Funktionen der Attribution Reporting API unterscheiden sich von denen der Private Click Measurement API, die von Safari/WebKit vorgeschlagen wird. Die Attribution Reporting API bietet folgende Vorteile:
- View-through-Messungen werden unterstützt.
- Berichte auf Ereignisebene können bereitgestellt werden.
- Zusammenfassungsberichte enthalten umfassende Informationen sowohl zu Klicks bzw. Aufrufen als auch zu Conversions.
- Drittanbieter wie AdTech-Plattformen können Berichte im Namen von Publishern und Werbetreibenden erhalten.
Browserkonfiguration
- Nutzer können die API in den Nutzereinstellungen unter
chrome://settings/adPrivacy
deaktivieren. - Die API ist im Inkognitomodus nicht aktiv.
- Die API ist nicht aktiv, wenn Drittanbieter-Cookies deaktiviert sind.
Wie können Websites den Zugriff steuern?
Wenn die API in einem bestimmten Browser verfügbar ist, ist sie standardmäßig auf jeder Website verfügbar, sowohl in Dokumenten und Skripts der obersten Ebene als auch in iFrames mit demselben Ursprung.
Beliebige Drittanbieter, z. B. ursprungsübergreifende iFrames von Anzeigen, die der Seite nicht über ein Script mit Top-Level-Zugriff hinzugefügt wurden, können die API nicht ohne das Wissen des Publishers oder Werbetreibenden verwenden. In diesen iFrames muss die Attribution Reporting API explizit über die Berechtigungsrichtlinie aktiviert werden.
<iframe src="..." allow="attribution-reporting"></iframe>
Drittanbieter mit Zugriff auf oberster Ebene, die einer Seite ursprungsübergreifende iFrames hinzufügen, können die Attribution Reporting API auch über die Berechtigungsrichtlinie aktivieren.
Eine Website kann die Attribution Reporting API für alle Parteien – einschließlich Skripts mit Zugriff auf oberster Ebene – deaktivieren, indem sie den HTTP-Antwortheader senden:
Permissions-Policy: attribution-reporting=()
Wie funktioniert die Attribution Reporting API?
Mit der Attribution Reporting API lassen sich zwei Ereignisse messen, die miteinander verknüpft sind: ein Ereignis auf der Website eines Publishers, z. B. ein Nutzer sieht oder klickt eine Anzeige an oder klickt mit der Conversion auf der Website eines Werbetreibenden.
Berichte auf Ereignisebene

Der Browser gleicht Klicks oder Aufrufe mit Conversion-Daten ab, die von einem Anzeigentechnologie-Anbieter definiert wurden.
Später sendet der Browser die resultierenden Berichte mit einer gewissen Verzögerung und mit einer gewissen Verzögerung an einen vordefinierten Endpunkt.
Zusammenfassungsberichte

Zusammenfassungsberichte werden wie folgt erstellt:
- Ein Nutzer klickt auf eine speziell konfigurierte Anzeige oder sieht sie an. Der Browser auf dem lokalen Gerät des Nutzers zeichnet dieses Ereignis zusammen mit zuvor festgelegten Konfigurationsdaten für die Attribution auf.
- Wenn der Nutzer später eine Conversion ausführt, gleicht der Browser dieses detaillierte Klick- oder Aufrufereignis (Attributionsquelle) mit detaillierten Conversion-Daten ab, die als Attributionstrigger-Daten bezeichnet werden. Die Abmessungen der erfassten Details sind von einem AdTech-Unternehmen vordefiniert und der Browser folgt einer bestimmten Logik, die von diesem definiert wird. Der Browser gibt diese Daten in einem aggregierbaren Bericht aus.
- Aggregierbare Berichte werden vom Browser verschlüsselt und an einen AdTech-Server gesendet. Vom AdTech-Server werden die aggregierten Berichte an den Aggregationsdienst gesendet, um einen zusammenfassenden Bericht zu generieren.
- Zusammenfassende Berichte werden dann für AdTech zur Verfügung gestellt. Beachten Sie, dass Zusammenfassungsberichte nicht im selben Maße verzögert werden wie Berichte auf Ereignisebene.
Weitere Informationen zu Zusammenfassungsberichten
Datenschutz
Anders als Drittanbieter-Cookies können Werbeunternehmen mit der Attribution Reporting API Informationen zu Conversions erhalten, ohne die Aktivitäten einer Person auf verschiedenen Websites zu erfassen.
Nehmen wir eine Person namens Bob. Bob sieht eine Anzeige,
während er die Nachrichten auf news.example
liest. Eine Woche später kauft Bob Schuhe bei shoes.example
.
Heute wird diese Conversion über ein Drittanbieter-Cookie erfasst, das als websiteübergreifende Kennung verwendet wird.
Mit Drittanbieter-Cookies kann ein Anzeigentechnologie-Unternehmen auf viele Details zu Bens Aktivitäten auf news.example
und shoes.example
zugreifen. Die Anzeigentechnologie kann diese Informationen zusammenführen, um ein detailliertes Profil von Ben zu erstellen, einschließlich Bobs Standort, Surfgewohnheiten und bevorzugter Lesevorgänge auf news.example
. Dieses Profil kann auch Käufe, Aktivitäten und Kreditkartendaten für shoes.example
enthalten. Diese websiteübergreifende Verbindung ist nützlich, um Anzeigen-Conversions zu messen. Dies beeinträchtigt jedoch den Datenschutz:
Bobs Aktivität wird auf Websites mit einer hohen Detailtiefe erfasst.
Eine geringe Menge an Informationen wird auf den Websites zusammengeführt – genug, um Conversions zu messen, aber nicht genug, um Bens Aktivitäten websiteübergreifend im Detail zu verfolgen. Bodos Aktivitäten auf news.example
und shoes.example
bleiben getrennt.
Schutzmaßnahmen in den einzelnen Berichtstypen
In Berichten auf Ereignisebene wird eine anzeigenseitige ID mit einer kleinen Datenmenge auf Conversion-Seite verknüpft. Sie liefern zwar websiteübergreifende Informationen zu einer Conversion, aber die Informationen auf Conversion-Seite sind zu ungenau, um die Nutzeridentität websiteübergreifend zu verknüpfen.
Zusammenfassungsberichte liefern detaillierte Informationen, jedoch nur auf aggregierter Ebene. Da die Inhalte dieser aggregierten Berichte verschlüsselt werden, wenn sie an das AdTech-Team gesendet werden, kann das AdTech-Team keine Informationen aus den Berichten abrufen, ohne einen Aggregationsdienst zu verwenden. Der Aggregationsdienst bietet nur Zugriff auf Rauschen-Aggregatfunktionen.
Sowohl auf Ereignisebene als auch auf aggregierten Berichten gelten zusätzliche Datenschutzmaßnahmen wie Ratenbegrenzungen.

Im Detail: Berichte auf Ereignisebene und Datenschutz
Berichte auf Ereignisebene bieten Conversion-Informationen, ohne Nutzer websiteübergreifend zu erfassen. Dabei gelten die folgenden Datenschutzmechanismen:
- Es wird keine websiteübergreifende ID verwendet und keine detaillierten websiteübergreifenden Browseraktivitäten verlassen das Gerät.
- In Berichten auf Ereignisebene werden 64 Bit auf Anzeigenebene (
news.example
) mit nur 1 Bit oder 3 Bit auf der Conversion-Seite (shop.example
) verknüpft. 64 Bit sind ausreichend, um einer einzelnen Nutzer-ID zugeordnet zu werden. Diese 64 Bit können jedoch nur mit sehr wenigen websiteübergreifenden Informationen verknüpft werden: 1 Bit oder 3 Bits, die nicht ausreichen, um eine Kennung zu speichern.- Die 64-Bits auf Anzeigenseite sind keine neuen Informationen. Eine User-ID ist schon heute auf der
Anzeigenseite verfügbar.
news.example
oderadtech.example
sind bereits über die Aktivität eines bestimmten Nutzers aufnews.example
informiert.
- Die 64-Bits auf Anzeigenseite sind keine neuen Informationen. Eine User-ID ist schon heute auf der
Anzeigenseite verfügbar.
- Es werden zusätzliche Schutzmaßnahmen angewendet, um Missbrauch und websiteübergreifendes Tracking zu verhindern:
- Die Berichte werden mit einer Verzögerung gesendet.
- Die Conversion-Daten sind Rauschen: In einem bestimmten Prozentsatz der Fälle werden gefälschte Berichte generiert.
- Die Anzahl der zugeordneten Conversion-Berichte ist pro Klick oder Aufruf begrenzt.
Im Detail: Zusammenfassungsberichte und Datenschutz
In Zusammenfassungsberichten wird ein Klick- oder Aufrufereignis mit detaillierten Conversion-Daten verknüpft. Sie liefern Informationen zu Conversions, ohne Nutzer websiteübergreifend zu tracken. Dabei werden die folgenden Datenschutzmechanismen angewendet:
- Es wird keine websiteübergreifende Kennung verwendet.
- Jede Attribution kann mehrere Beiträge zu einem zusammenfassenden Bericht leisten. Jeder Nutzer kann mehrere Attributionen für einen bestimmten Klick (oder Aufruf) und eine Conversion auslösen.
- Die Daten werden bis zur Ebene vieler Ereignisse (viele Nutzer) aggregiert und einzelne Ereignisse können nicht präzise beobachtet werden. Wenn Sie sich die aggregierten Daten ansehen, nimmt mit zunehmender Detailgenauigkeit auch das relative Rauschen in den Daten zu. Datensegmente, in denen viele Ereignisse und Nutzer aggregiert werden, sind genauer, um die Nützlichkeit zu bewahren.
- Die Rohdatenberichte, die ein detailliertes Klick- oder Aufrufereignis mit detaillierten Conversion-Daten verknüpfen, sind verschlüsselt und können vom AdTech-Unternehmen nicht gelesen werden. Diese Daten können nur vom Aggregationsdienst gelesen werden.
- Es werden zusätzliche Schutzmaßnahmen angewendet, um Missbrauch und websiteübergreifendes Tracking zu verhindern:
- Berichte werden mit zufälligen Verzögerungen gesendet.
- Für Abfragen von verschiedenen Datensegmenten gilt eine Ratenbegrenzung.
Reagieren und Feedback geben
- Bei Fragen zur API: Erstellen Sie ein Problem im API-Repository.
- In der Mailingliste für Attribution Reporting finden Sie aktuelle Informationen und Ankündigungen zur API.
- Wenn Sie technische Fragen haben, melden Sie einen Chromium-Programmfehler.
- Bei Fragen zur Implementierung, Integration und allgemeinen Best Practices: Erstellen Sie ein Problem im Repository des Privacy Sandbox-Entwicklersupports.