Sie können erfassen, wann ein Anzeigenklick oder eine Anzeigenaufruf zu einer Conversion führt, z. B. zu einem Kauf auf der Website eines Werbetreibenden.
Für wen ist das Angebot gedacht?
Hier finden Sie die Grundlagen von Attributionsberichten und einige zugrunde liegende Konzepte, aber nur wenige technische Details.
- Wenn Sie in der Werbebranche oder in der Anzeigentechnologie tätig sind, erfahren Sie, wie diese API Funktionen bietet, die durch Drittanbieter-Cookies aktiviert werden. In den Anwendungsfällen der API finden Sie weitere Informationen dazu, wie Berichte generiert werden.
- Wenn Sie Entwickler oder Softwareingenieur sind, rufen Sie die vollständige Systemübersicht auf oder testen und beteiligen Sie sich an der API.
Werbetreibende und Publisher, die für die Conversion-Analyse auf AdTech-Plattformen zurückgreifen, müssen die API nicht direkt verwenden. Wenn Sie Ihre Anzeigentechnologie mit dieser API verknüpfen möchten, sollten Sie sich mit der Funktionsweise von Attribution Reporting vertraut machen.
Was ist die Attribution Reporting API?
Derzeit werden für die Analyse von Anzeigen-Conversions häufig Drittanbieter-Cookies verwendet. Browser schränken den Zugriff auf Drittanbieter-Cookies ein, da diese dazu verwendet werden können, Nutzer websiteübergreifend zu verfolgen und den Datenschutz zu beeinträchtigen.
Die Attribution Reporting API ermöglicht diese Analysen datenschutzfreundlich und ohne Drittanbieter-Cookies.
Mit dieser API können Werbetreibende und Anbieter von Anzeigentechnologien Conversions in folgenden Fällen erfassen:
- Anzeigenklicks und Anzeigenaufrufe
- Anzeigen in einem iFrame eines Drittanbieters, z. B. Anzeigen auf einer Publisher-Website, die einen Anzeigentechnologieanbieter von Drittanbietern verwendet.
- Anzeigen in einem eigenen Kontext, z. B. Anzeigen in einem sozialen Netzwerk oder auf einer Suchmaschinenergebnisseite oder Anzeigen eines Publishers, der seine eigenen Anzeigen ausliefert.
Wenn Ihnen einige dieser Begriffe oder Konzepte nicht geläufig sind, sehen Sie sich das Privacy Sandbox-Glossar an.
API testen
- Testen Sie lokal in Ihrem Browser. Legen Sie ein Flag fest, das dem Chrome-Browser mitteilt, bestimmte experimentelle Funktionen zu aktivieren.
Wenn Sie die API ausprobieren möchten, lesen Sie den Hilfeartikel Attribution Reporting: Experimente durchführen und teilnehmen.
API-Änderungen
- API-Änderungen im Blick behalten
- Hier erfahren Sie, warum wir die Attribution Reporting API in der ersten Jahreshälfte 2023 eingeführt haben.
Verfügbarkeit
Proposal | Status |
---|---|
Conversion journey: app-to-web Web explainer and Android explainer Mailing list announcement |
Available in Chrome and Android for origin trial |
Conversion journey: cross-device Explainer |
This proposal has been archived. There are no current plans for implementation. |
Preventing invalid aggregatable reports using report verification Explainer |
This proposal has been archived. We have implemented trigger_context_id for this use case instead. |
Default allowlist for the Attribution Reporting API Permissions-Policy will remain * Mailing list announcement |
Available in Chrome in Q1 2023 |
Configurable event-Level reporting epsilon GitHub issue |
Available in Chrome in Q4 2023 |
Padding for aggregatable reports payload Updated explainer |
Available in Chrome in Q4 2023 |
Flexible event-Level Flexible event-level configurations explainer |
Available in Chrome in Q4 2023
The ability to customize the number of attribution reports and the number/length of reporting windows. Available in Chrome in Q1 2024 The ability to customize the number of bits of trigger data. |
Support for Attribution Reporting verbose debugging reports not dependent on third-party cookies Explainer |
Available in Chrome in Q3 2024 |
Support for Attribution Reporting API and Aggregation Service for Google Cloud Attribution Reporting API Explainer Aggregation Service Explainer |
Available in Chrome in H2 2023 |
Flexible contribution filtering Explainer |
Available in Chrome in Q3 2024 |
Pre-attribution filtering: attribution scopes Explainer |
Available in Chrome in Q4 2024 |
Anwendungsfälle und Features
Die Attribution Reporting API bietet Zugriff auf verschiedene Arten von Statistiken mit zwei Berichtstypen, die an einen Werbetreibenden oder einen Drittanbieter von Anzeigentechnologien gesendet werden können. Diese beiden Berichtstypen können gleichzeitig verwendet werden und ergänzen sich.
- In Berichten auf Ereignisebene werden ein bestimmter Anzeigenklick oder -aufruf (auf Anzeigenseite) mit Daten auf Conversion-Seite verknüpft. Die Daten auf Conversion-Seite sind sehr begrenzt und die Daten sind fehlerhaft. Das bedeutet, dass in einem kleinen Prozentsatz der Fälle zufällige Daten anstelle von echten Berichten gesendet werden. So wird die Privatsphäre der Nutzer geschützt, da die Nutzeridentität nicht über Websites hinweg verknüpft wird. Zum Schutz Ihrer Daten werden Berichte mit einer Verzögerung gesendet.
- Zusammenfassungsberichte sind nicht an ein bestimmtes Ereignis auf Anzeigenseite gebunden. Diese Berichte enthalten umfassendere und aussagekräftigere Conversion-Daten als Berichte auf Ereignisebene. Durch eine Kombination von Datenschutzmethoden lässt sich das Risiko einer websiteübergreifenden Zusammenführung von Identitäten verringern.
Berichte auf Ereignisebene
In Berichten auf Ereignisebene werden Anzeigenklicks oder -aufrufe mit groben Conversion-Daten verknüpft.
![Bericht auf Ereignisebene](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/event-level-report-4b1ba87d8a313.png?authuser=4&hl=de)
news.example
(der Nutzer-ID „Max Muster“ auf news.example
zugeordnet) hat zu einem Kauf auf shop.example
geführt.Berichte auf Ereignisebene eignen sich für:
- Optimierung Beantworten Sie Fragen wie „Wie kann ich meinen ROI verbessern?“. Mit diesen Berichten lassen sich insbesondere Anzeigen-Placements optimieren, da in den Berichten eindeutige IDs auf Anzeigenseite verfügbar gemacht werden können. Berichte auf Ereignisebene können Trainingsdaten für Modelle für maschinelles Lernen liefern.
- Grobe Berichte, für die nur sehr wenige Informationen zur Conversion erforderlich sind. Derzeit sind 3 Bit Conversion-Daten für Klicks zulässig (d. h. einer Conversion kann eine von acht Kategorien zugewiesen werden) und 1 Bit für Aufrufe. Die Codierung detaillierter Conversion-Daten wie eines bestimmten Preises oder der Conversion-Zeit wird in Berichten auf Ereignisebene nicht unterstützt.
- Betrugserkennung Die Daten in einigen Berichten können für die Erkennung und Analyse von Anzeigenbetrug nützlich sein, da Sie damit Muster erkennen können, anhand derer sich Spam- oder ungültige Aktivitäten identifizieren lassen.
Zusammenfassende Berichte
Zusammenfassungsberichte (früher als zusammengefasste Berichte bezeichnet) bieten detailliertere Conversion-Daten und mehr Flexibilität beim Zusammenführen von Klick- oder Aufrufdaten und Conversion-Daten.
Weitere Informationen zu Zusammenfassungsberichten
![Beispiel für Statistiken aus Zusammenfassungsberichten](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?authuser=4&hl=de)
news.example
hat zu 518 Conversions auf shoes.example
und zu Gesamtausgaben von 38.174 $geführt. Die Hälfte der Conversions stammte von Nutzern in New York, USA.Zusammenfassungsberichte eignen sich am besten für Anwendungsfälle. Mit diesen Berichten können Sie Fragen wie „Wie hoch ist mein Return on Investment?“ beantworten.
Die Verwendung von Zusammenfassungsberichten zur Optimierung, z. B. für den Kaufwert, der in Berichten auf Ereignisebene nicht unterstützt wird, da die Conversion-Daten zu grob sind, ist ein Bereich, in dem wir aktiv forschen.
Weitere Funktionen
Weitere Funktionen dieser API:
- App-zu-Web-Attribution: Eine Anzeige in einer App wird gesehen oder angeklickt und eine Conversion wird im Web ausgeführt.
Unterstützte Browser
- Firefox und Edge haben keine Signale weitergegeben.
- Safari und Webkit sind negativ und haben eine andere API zur Messung von Anzeigen-Conversions vorgeschlagen, die Private Click Measurement (Messung privater Klicks) heißt.
Obwohl sich die beiden APIs unterscheiden, arbeiten Chrome und WebKit gemeinsam daran, die Entwicklung zu vereinfachen, z. B. durch die Angleichung der Attributnamen und der JSON-Struktur für Berichte.
Die Attribution Reporting API unterscheidet sich von der von Safari und WebKit vorgeschlagenen Private Click Measurement API. Mit der Attribution Reporting API können Sie Folgendes tun:
- Die Messung von View-through-Conversions wird unterstützt.
- Berichte auf Ereignisebene können bereitgestellt werden.
- Zusammenfassungsberichte enthalten umfangreiche Informationen sowohl zu Klicks/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 über die Nutzereinstellungen unter
chrome://settings/adPrivacy
deaktivieren. - Die API ist im Inkognitomodus nicht aktiv.
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 Scripts auf oberster Ebene als auch in Iframes mit demselben Ursprung.
Unbefugte Dritte, z. B. ursprungsübergreifende Anzeigen-iFrames, die der Seite nicht mit einem Script mit Zugriff auf höchster Ebene hinzugefügt wurden, können die API nicht ohne Wissen des Publishers oder Werbetreibenden verwenden. In diesen iFrames muss die Attribution Reporting API mit der Berechtigungsrichtlinie explizit aktiviert werden.
<iframe src="..." allow="attribution-reporting"></iframe>
Drittanbieter mit Zugriff auf die oberste Ebene, die einer Seite ursprungsübergreifende iFrames hinzufügen, können die Attribution Reporting API auch mit der Berechtigungsrichtlinie aktivieren.
Eine Website kann die Attribution Reporting API für alle Beteiligten deaktivieren, einschließlich Scripts mit Zugriff auf höchster Ebene, indem der HTTP-Antwortheader gesendet wird:
Permissions-Policy: attribution-reporting=()
Wie funktioniert die Attribution Reporting API?
Die Attribution Reporting API ermöglicht es, zwei miteinander verknüpfte Ereignisse zu messen, z. B. wenn sich ein Nutzer auf der Website eines Publishers eine Anzeige ansieht oder darauf klickt und später eine Conversion auf der Website eines Werbetreibenden erfolgt.
Berichte auf Ereignisebene
![Bericht auf Ereignisebene](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/event-level-report-ef2aec13f54f9.png?authuser=4&hl=de)
Der Browser gleicht Klicks oder Aufrufe mit Conversion-Daten ab, die von einer AdTech-Plattform definiert wurden.
Später sendet der Browser die resultierenden Berichte mit einer gewissen Verzögerung und mit einigen Fehlern an einen vordefinierten Endpunkt.
Zusammenfassende Berichte
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?authuser=4&hl=de)
Zusammenfassungsberichte werden so erstellt:
- Ein Nutzer sieht sich eine speziell konfigurierte Anzeige an oder klickt darauf. Der Browser auf dem Gerät des Nutzers erfasst dieses Ereignis und erhebt gleichzeitig vorab festgelegte Attributionskonfigurationsdaten.
- Wenn der Nutzer später eine Conversion ausführt, gleicht der Browser dieses detaillierte Klick- oder Aufrufereignis (auch Attributionsquellereignis genannt) mit detaillierten Conversion-Daten (auch Attributionsauslöserdaten genannt) ab. Dabei wird der Detaillierungsgrad vorab durch ein Anzeigentechnologien-Unternehmen festgelegt und der Browser folgt einer spezifischen Logik, die durch die AdTech definiert wird. Die Daten gibt der Browser dann in einem aggregierbaren Bericht aus.
- Aggregierbare Berichte werden durch den Browser verschlüsselt und an einen AdTech-Server gesendet. Von dort werden die Berichte an den Aggregationsdienst gesendet, damit dieser einen Zusammenfassungsbericht erstellt.
- Die Zusammenfassungsberichte werden dann der AdTech zur Verfügung gestellt. Beachten Sie dabei, dass Zusammenfassungsberichte nicht im selben Maße verzögert werden wie Berichte auf Ereignisebene.
Weitere Informationen zu Zusammenfassungsberichten
Datenschutz
Im Gegensatz zu Drittanbieter-Cookies können Werbeunternehmen mit der Attribution Reporting API Informationen zu Conversions erhalten, ohne die Aktivitäten eines Nutzers websiteübergreifend zu erfassen.
Nehmen wir an, es geht um eine Person namens Max. Bob sieht eine Anzeige, während er sich die Nachrichten auf news.example
ansieht. Eine Woche später kauft Bob Schuhe bei shoes.example
.
Heutzutage würde diese Conversion über ein Drittanbieter-Cookie erfasst, das als websiteübergreifende Kennung verwendet wird.
Mit Drittanbieter-Cookies kann ein Anbieter von Anzeigentechnologien auf viele Details zu den Aktivitäten von Max auf news.example
und shoes.example
zugreifen. Die Anzeigentechnologie kann diese Informationen zusammenführen, um ein detailliertes Profil von Max zu erstellen, einschließlich seines Standorts, seiner Browsergewohnheiten und seiner bevorzugten Lesematerialien auf news.example
. Dieses Profil kann auch Käufe, Aktivitäten und Kreditkarteninformationen auf shoes.example
enthalten. Diese websiteübergreifende Verknüpfung ist nützlich, um Anzeigen-Conversions zu erfassen. Das beeinträchtigt jedoch den Datenschutz der Nutzer: Jonas' Aktivitäten werden auf Websites mit hoher Detailgenauigkeit erfasst.
![Vergleich des heutigen Webs (zusammengeführte Identität) mit dem Web der Zukunft (partitionierte Identität)](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?authuser=4&hl=de)
Es werden nur wenige Informationen zwischen Websites zusammengeführt – ausreichend, um Conversions zu messen, aber nicht genug, um die Aktivitäten von Max auf Websites im Detail zu verfolgen. Die Aktivitäten von Bob auf news.example
und shoes.example
bleiben getrennt.
Schutzmaßnahmen für die einzelnen Berichtstypen
In Berichten auf Ereignisebene wird eine Anzeigen-ID mit einer kleinen Menge an conversion-seitigen Daten verknüpft. Sie enthalten zwar websiteübergreifende Informationen zu einer Conversion, diese sind jedoch zu grob, um die Nutzeridentität plattformübergreifend zu verknüpfen.
Zusammenfassungsberichte liefern detaillierte Informationen, aber nur auf aggregierter Ebene. Da der Inhalt dieser aggregierbaren Berichte verschlüsselt wird, wenn sie an die Anzeigentechnologie gesendet werden, kann die Anzeigentechnologie ohne Aggregationsdienst keine Informationen aus den Berichten abrufen. Der Aggregationsdienst bietet nur Zugriff auf fehlerbehaftete Aggregate.
Zusätzliche Datenschutzmaßnahmen wie Ratenbeschränkungen gelten sowohl für Berichte auf Ereignisebene als auch für aggregierte Berichte.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?authuser=4&hl=de)
Im Detail: Berichte auf Ereignisebene und Datenschutz
Berichte auf Ereignisebene liefern Conversion-Statistiken, ohne dass Nutzer websiteübergreifend getrackt werden. Dabei werden die folgenden Datenschutzmechanismen verwendet:
- Es wird keine websiteübergreifende Kennung verwendet und keine detaillierten websiteübergreifenden Browseraktivitäten verlassen das Gerät.
- In Berichten auf Ereignisebene werden 64 Bit an Informationen auf Anzeigenseite (
news.example
) mit nur 1 Bit oder 3 Bits auf Conversion-Seite (shop.example
) verknüpft. 64 Bit reichen aus, 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, was nicht ausreicht, um eine Kennung zu speichern.- Die 64 Bit auf Anzeigenseite sind keine neuen Informationen. Eine Nutzer-ID kann bereits auf der Anzeigenseite verfügbar sein.
news.example
oderadtech.example
kennen bereits die Aktivitäten eines bestimmten Nutzers aufnews.example
.
- Die 64 Bit auf Anzeigenseite sind keine neuen Informationen. Eine Nutzer-ID kann bereits auf der Anzeigenseite verfügbar sein.
- Zusätzliche Schutzmaßnahmen werden angewendet, um Missbrauch und websiteübergreifendes Tracking zu verhindern:
- Die Berichte werden mit einer Verzögerung gesendet.
- Die Conversion-Daten sind verfälscht: In einem bestimmten Prozentsatz der Fälle werden gefälschte Berichte generiert.
- Die Anzahl der Berichte zu zugeordneten Conversions ist pro Klick oder Aufruf begrenzt.
Im Detail: Zusammenfassungsberichte und Datenschutz
In Zusammenfassungsberichten werden Klick- oder Aufrufereignisse mit detaillierten Conversion-Daten verknüpft. Sie liefern Conversion-Statistiken, ohne Nutzer websiteübergreifend zu erfassen. Dazu werden die folgenden Datenschutzmechanismen verwendet:
- Es wird keine websiteübergreifende Kennung verwendet.
- Jede Attribution kann mehrere Beiträge zu einem zusammengefassten Bericht leisten. Ein einzelner Nutzer kann mehrere Attributionen für einen bestimmten Klick (oder eine bestimmte Wiedergabe) und eine Conversion auslösen.
- Die Daten werden auf Ebene vieler Ereignisse (vieler Nutzer) aggregiert und einzelne Ereignisse können nicht genau beobachtet werden. Bei den aggregierten Daten steigt der relative Rauschanteil mit zunehmender Detailebene. Datenaufschlüsselungen, die viele Ereignisse und Nutzer zusammenfassen, sind genauer, um die Nützlichkeit zu erhalten.
- Die Rohberichte, in denen ein detailliertes Klick- oder Aufrufereignis mit detaillierten Conversion-Daten verknüpft wird, sind verschlüsselt und können vom AdTech-Unternehmen nicht gelesen werden. Diese Daten können nur vom Aggregationsdienst gelesen werden.
- Zusätzliche Schutzmaßnahmen werden angewendet, um Missbrauch und websiteübergreifendes Tracking zu verhindern:
- Berichte werden mit zufälligen Verzögerungen gesendet.
- Abfragen auf verschiedene Datensegmente sind ratenbegrenzt.
Feedback geben und erhalten
- Bei Fragen zur API: Erstellen Sie ein Problem im API-Repository.
- API-Updates und -Ankündigungen finden Sie in der Attribution Reporting-Mailingliste.
- Wenn Sie technische Fragen haben, erstellen Sie in Chromium einen Eintrag für das Problem.
- Bei Fragen zur Implementierung, Integration und allgemeinen Best Practices: Erstellen Sie ein Problem im Entwicklersupport-Repository für die Privacy Sandbox.