Sie können erfassen, wann ein Klick auf eine Anzeige oder ein Aufruf zu einer Conversion führt, z. B. zu einem Kauf bei einem Website des Werbetreibenden.
Für wen ist das gedacht?
Hier finden Sie die Grundlagen von Attributionsberichten und einige Konzepte, aber nicht viele technische Details.
- Wenn Sie im Bereich Werbung oder Anzeigentechnologie tätig sind, erfahren Sie mehr darüber, wie diese API bietet Funktionen, die durch Drittanbieter-Cookies aktiviert werden. Prüfen API-Anwendungsfälle mit ausführlicheren werden die Berichte erstellt.
- Wenn du Entwickler oder Softwareentwickler bist, findest du vollständige Systemübersicht oder Experimentieren und mitmachen mit der API.
Werbetreibende und Publisher, die Anzeigentechnologie-Plattformen für Conversions nutzen muss die API nicht direkt verwendet werden. Was Sie noch interessieren könnte wissen, wie Attribution Reporting funktioniert, wenn Ihre Anzeigentechnologie integriert werden soll mit dieser API.
Was ist die Attribution Reporting API?
Heutzutage basiert die Messung von Anzeigen-Conversions häufig auf Drittanbietern Cookies. Browser schränken den Zugriff auf Drittanbieter-Cookies ein, werden verwendet, um Nutzer websiteübergreifend nachzuverfolgen und den Datenschutz für Nutzer zu beeinträchtigen.
Mit der Attribution Reporting API werden diese Messungen ohne Drittanbieter-Cookies.
Mit dieser API können Werbetreibende und Anbieter von Anzeigentechnologien Conversions in folgenden Fällen:
- Anzeigenklicks und Anzeigenaufrufe:
- Anzeigen in einem Drittanbieter-iFrame, wie z. B. Anzeigen auf einer Publisher-Website, Drittanbieter von Anzeigentechnologien.
- Anzeigen in einem eigenen Kontext, z. B. Anzeigen in sozialen Netzwerken oder in einer Suchanfrage oder ein Publisher, der seine eigenen Anzeigen bereitstellt.
Wenn Sie mit einigen dieser Begriffe oder Konzepte nicht vertraut sind, lesen Sie die Glossar zur Privacy Sandbox
API testen
- Testen Sie sie lokal im Browser. Legen Sie ein Flag fest. Dadurch wird der Chrome-Browser aufgefordert, bestimmte experimentelle Funktionen.
Wenn Sie mit der API experimentieren möchten, besuchen Sie Attributionsberichte: Experimentieren und teilnehmen
API-Änderungen
- Behalten Sie den Überblick über die API-Änderungen.
- Hier erfahren Sie, warum wir die Attribution Reporting API in der ersten Jahreshälfte 2023 eingeführt haben.
Verfügbarkeit
Vorschlag | Status |
---|---|
Conversion-Pfad: App-zu-Web Erklärende Web-App und Erklärende Android-App Ankündigung der Mailingliste |
In Chrome und Android für Ursprungstest verfügbar |
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 mithilfe der Berichtsüberprüfung verhindern Erläuterung |
Voraussichtlich im 1. Halbjahr 2024 in Chrome |
Die Standard-Zulassungsliste für die Berechtigungsrichtlinie für die Attribution Reporting API bleibt erhalten.* Ankündigung in Mailingliste |
Verfügbar in Chrome im 1. Quartal 2023 |
Konfigurierbares Berichts-Epsilon auf Ereignisebene GitHub-Problem |
Verfügbar in Chrome im 4. Quartal 2023 |
Padding für die Nutzlast von aggregierten Berichten Aktualisierte Erläuterung |
Verfügbar in Chrome im 4. Quartal 2023 |
Phase 1 Lite: Flexible Ereignisebene auf Ereignisebene Erläuterung zu flexiblen Konfigurationen auf Ereignisebene |
Verfügbar in Chrome im 4. Quartal 2023
Die Möglichkeit, die Anzahl der Attributionsberichte sowie die Anzahl bzw. Länge der Berichtsfenster anzupassen. Verfügbar in Chrome im 1. Quartal 2024 Die Möglichkeit, die Anzahl der Bits von Triggerdaten anzupassen. |
Unterstützung für die Fehlerbehebung in Attribution Reporting nach der Einstellung von Drittanbieter-Cookies Feedback auf GitHub |
Voraussichtlich im 1. Halbjahr 2024 in Chrome |
Unterstützung für Attribution Reporting API und Aggregation Service für Google Cloud Attribution Reporting API Erklärung Aggregation Service Erläuterung |
Verfügbar in Chrome im 2. Halbjahr 2023 |
Anwendungsfälle und Features
Die Attribution Reporting API bietet Zugriff auf verschiedene Arten von Statistiken mit Zwei Arten von Berichten, die an einen Werbetreibenden oder die Anzeigentechnologie eines Drittanbieters gesendet werden können Dienstanbieter. Diese beiden Berichtstypen können gleichzeitig verwendet werden. und ergänzen sich.
- In Berichten auf Ereignisebene wird eine bestimmte Anzeige Klick oder Ansicht (auf der Anzeigenseite) mit Daten auf der Conversion-Seite. Daten auf Conversion-Seite sind sehr begrenzt und die Daten sind verrauscht (d. h. für in einem kleinen Prozentsatz der Fälle werden zufällige Daten anstelle von echten Berichten gesendet. So wird die Privatsphäre der Nutzer gewahrt, da die Zusammenführung der Nutzeridentität über Websites. Um den Datenschutz zu erhöhen, werden Berichte mit einer Verzögerung gesendet.
- Zusammenfassungsberichte sind nicht an ein bestimmtes Ereignis in auf der Anzeigenseite. Diese Berichte enthalten umfassendere und genauere Conversion-Daten. als auf Ereignisebene. Eine Kombination von Datenschutztechniken trägt dazu bei, besteht das Risiko, dass Websites zusammengehören.
Berichte auf Ereignisebene
Bei Berichten auf Ereignisebene werden einem Anzeigenklick oder einer Ansicht nur grobe Conversion-Daten zugeordnet.
<ph type="x-smartling-placeholder">![Bericht auf Ereignisebene](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/event-level-report-4b1ba87d8a313.png?authuser=9&hl=de)
news.example
(anhand der Nutzer-ID Bob_Doe am news.example
) hat zu einem Kauf am shop.example
geführt.Berichte auf Ereignisebene eignen sich für Folgendes:
- Optimierung Fragen beantworten wie „Wie kann ich meinen Return on Advertising Spend (ROAS) verbessern? zu investieren?“. Diese Berichte können insbesondere zur Optimierung -Placement, da anzeigenseitige eindeutige IDs in den Berichten zur Verfügung gestellt werden können. Berichte auf Ereignisebene können Trainingsdaten für Modelle für maschinelles Lernen enthalten.
- Grobere Berichte, bei denen nur sehr wenige Informationen zum Conversion. Das aktuelle Limit liegt bei 3 Bit an Conversion-Daten für Klicks.⏤ einer Conversion kann eine von acht Kategorien⏤ und 1 Bit für Aufrufe. Codierung detaillierter Daten auf Conversion-Seite, z. B. „Bestimmter Preis“ oder „Datum und Uhrzeit der Conversion“ werden in Berichten auf Ereignisebene nicht unterstützt.
- Betrugerkennung: Die Daten in einigen Berichten können bei Werbebetrug hilfreich sein Erkennung und Analyse, indem Sie Muster erkennen, zur Identifizierung von Spam oder unzulässigen Aktivitäten.
Zusammenfassende Berichte
Zusammenfassungsberichte (früher „zusammengefasste Berichte“) bieten detailliertere Conversion-Daten und mehr Flexibilität beim Zusammenführen von Klick- oder Aufrufdaten und Conversion-Daten Daten.
Weitere Informationen zu Zusammenfassungsberichten
<ph type="x-smartling-placeholder">![Beispiel für Statistiken aus zusammenfassenden Berichten](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?authuser=9&hl=de)
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, USA.Zusammenfassungsberichte eignen sich am besten für Berichte. Diese Berichte helfen Ihnen, Fragen zu beantworten wie: „Wie hoch ist mein Return on Investment?“
Verwendung von zusammenfassenden Berichten zur Optimierung, z. B. um für eine bestimmte wird in Berichten auf Ereignisebene nicht unterstützt, Conversion-Daten zu grob sind) – ist ein Bereich aktiver Forschung.
Weitere Funktionen
Weitere Funktionen dieser API:
- App-zu-Web-Attribution: eine Anzeige in einer App sehen oder anklicken und eine Conversion im Web ausführen.
Unterstützte Browser
- In Firefox und Edge wurden keine Signale freigegeben.
- Safari und WebKit sind ausschließend und schlug eine andere API zur Messung von Anzeigen-Conversions vor: Privater Klick. Messung:
Obwohl sich die beiden APIs unterscheiden, arbeiten Chrome und WebKit in der öffnen, um die Entwicklung zu vereinfachen, indem z. B. und auf der Seite JSON-Struktur für Berichte.
Die Funktionen der Attribution Reporting API unterscheiden sich von denen des Von Safari und WebKit vorgeschlagene Private Click Measurement API Die Attribution Reporting API bietet unter anderem folgende Vorteile:
- View-through-Messung wird unterstützt.
- Berichte auf Ereignisebene können bereitgestellt werden.
- Zusammenfassungsberichte enthalten umfassende Informationen sowohl zur Klick-/Ansichtsseite als auch zur Conversion-Seite.
- Drittanbieter wie z. B. Anzeigentechnologie-Plattformen können Berichte im Namen von Publisher und Werbetreibende.
Browserkonfiguration
- Nutzer können die API über die Nutzereinstellungen unter
chrome://settings/adPrivacy
- 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 in allen sowohl in Dokumenten und Skripts auf oberster Ebene als auch in iFrames am selben Ursprung.
Beliebige Drittanbieter, z. B. ursprungsübergreifende Anzeigen-iFrames, die nicht der Seite mit einem Skript hinzugefügt wurde, das Zugriff auf oberster Ebene hat. Die API kann nicht verwendet werden. ohne das Wissen eines Publishers oder Werbetreibenden: In diesen iFrames Die Attribution Reporting API muss explizit aktiviert werden mit Berechtigungen .
<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 mit Berechtigungsrichtlinie
Eine Website kann die Attribution Reporting API für alle Parteien deaktivieren, darunter: mit Zugriff auf oberster Ebene erstellen, indem Sie den HTTP-Antwortheader senden:
Permissions-Policy: attribution-reporting=()
Wie funktioniert die Attribution Reporting API?
Mit der Attribution Reporting API können zwei Ereignisse analysiert werden, die miteinander verknüpft sind. zusammen: ein Ereignis auf der Website eines Publishers, z. B. ein Nutzer, der sich das Video ansieht oder darauf klickt Anzeige und anschließende Conversion auf der Website eines Werbetreibenden.
Berichte auf Ereignisebene
<ph type="x-smartling-placeholder">![Bericht auf Ereignisebene](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/event-level-report-ef2aec13f54f9.png?authuser=9&hl=de)
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 an einen vordefinierten Endpunkt, mit einer gewissen Verzögerung und leichten Abweichungen.
Zusammenfassende Berichte
<ph type="x-smartling-placeholder">![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?authuser=9&hl=de)
Zusammenfassungsberichte werden wie folgt erstellt:
- Ein Nutzer klickt auf eine speziell konfigurierte Anzeige oder sieht sie an. Der Browser zeichnet dieses Ereignis auf dem lokalen Gerät des Nutzers zusammen mit den vordefinierten Konfigurationsdaten für die Attribution auf.
- Wenn der Nutzer später eine Conversion ausführt, ordnet der Browser diesem detaillierten Klick- oder Aufrufereignis (das sogenannte Attributionsquellenereignis) detaillierte Conversion-Daten zu, die auch als Attributionstriggerdaten bezeichnet werden. Die Dimensionen der erfassten Details werden von einem AdTech-Unternehmen vordefiniert und der Browser folgt einer spezifischen Logik, die von der Anzeigentechnologie vorgegeben wird. Der Browser gibt diese Daten in einem aggregierbaren Bericht aus.
- Aggregierte Berichte werden vom Browser verschlüsselt und an einen AdTech-Server gesendet. Die aggregierbaren Berichte werden vom AdTech-Server an den Aggregationsdienst gesendet, um einen zusammenfassenden Bericht zu erstellen.
- Zusammenfassungsberichte werden dann für die Anzeigentechnologie-Anbieter bereitgestellt. Zusammenfassende Berichte werden nicht im gleichen Maße verzögert wie Berichte auf Ereignisebene.
Weitere Informationen zu Zusammenfassungsberichten
Datenschutz
Im Gegensatz zu Drittanbieter-Cookies wird die Attribution Reporting API können Werbeunternehmen Einblicke in Conversions ohne die Aktivität einer Person zu erfassen, für alle Websites.
Nehmen wir eine Person namens Bob. Bob sieht beim Lesen eine Anzeige.
die Nachrichten auf news.example
. Eine Woche später kauft Bob Schuhe über
shoes.example
Heute wird diese Conversion von einem Drittanbieter erfasst.
Cookie, das als websiteübergreifende Kennung verwendet wird.
Mit Drittanbieter-Cookies hat ein
Anzeigentechnologie-Unternehmen
zu Bobs Aktivitäten auf news.example
und auf
shoes.example
. Die Anzeigentechnologie
kann diese Elemente
Informationen zusammen, um ein detailliertes Profil
von Bob zu erstellen.
darunter Bodos Standort, Browsergewohnheiten und
bevorzugte Lesevorgänge auf news.example
. Dieses Profil könnte auch
Käufe, Aktivitäten und Kreditkartendaten auf Ihrem
shoes.example
Mit diesem Cross-Site-Join lassen sich
Anzeigen-Conversions. Allerdings wird dadurch der Datenschutz beeinträchtigt:
Bodos Aktivität wird websiteübergreifend sehr detailliert erfasst.
![Gegenüberstellung des heutigen Webs (verknüpfte Identität) und des zukünftigen Webs (partitionierte Identität)](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?authuser=9&hl=de)
Eine geringe Menge an Informationen wird
websiteübergreifend messen: Genug, um Conversions zu messen, aber nicht
um Bens Aktivitäten websiteübergreifend zu erfassen. Bobs
Aktivitäten auf news.example
und shoes.example
bleiben
getrennt.
Schutzmaßnahmen in jedem Berichtstyp
In Berichten auf Ereignisebene wird eine anzeigenseitige Kennung mit einem kleinen Teil Daten aus der Conversion-Seite. Sie liefern zwar websiteübergreifende Informationen zu Conversion verwenden, sind die Informationen auf Conversion-Seite zu grob, um den Nutzer Identität auf allen Websites.
Zusammenfassungsberichte liefern detaillierte Einblicke, aber nur auf aggregierter Ebene. weil die Inhalte werden diese aggregierten Berichte verschlüsselt, wenn sie an den AdTech-Anbieter gesendet werden. Informationen aus den Berichten abrufen, ohne einen Aggregationsdienst zu verwenden. Nur der Aggregationsdienst bietet Zugriff auf verrauschte Aggregate.
Für beide werden zusätzliche Datenschutzmaßnahmen wie z. B. Preisbeschränkungen auferlegt. Berichte auf Ereignisebene und aggregierte Berichte.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?authuser=9&hl=de)
Im Detail: Berichte auf Ereignisebene und Datenschutz
Berichte auf Ereignisebene liefern Informationen zu Conversions, ohne dass Nutzer*innen Websites, indem Sie die folgenden Datenschutzmechanismen befolgen:
- Es wird keine websiteübergreifende Kennung verwendet und es werden keine detaillierten websiteübergreifenden Browseraktivitäten verwendet das Gerät verlässt.
- Berichte auf Ereignisebene verknüpfen 64 Bits an Informationen auf der Anzeigenseite.
(
news.example
) mit nur 1 Bit oder 3 Bit auf der Conversion-Seite (shop.example
) 64 Bit reichen aus, um einer Nutzerkennung, aber diese 64 Bit können nur mit sehr Wenige websiteübergreifende Informationen: 1 oder 3 Bits, was nicht ausreicht, um eine Kennung.- Die 64-Bit-Anzeigen auf der Seite sind keine neuen Informationen. Eine User-ID kann bereits
die ab heute auf der Anzeigenseite verfügbar sind.
news.example
oderadtech.example
die Aktivitäten eines bestimmten Nutzers aufnews.example
bereits kennt.
- Die 64-Bit-Anzeigen auf der Seite sind keine neuen Informationen. Eine User-ID kann bereits
die ab heute auf der Anzeigenseite verfügbar sind.
- Es werden zusätzliche Schutzmaßnahmen angewendet, um Missbrauch und websiteübergreifendes Tracking zu verhindern:
<ph type="x-smartling-placeholder">
- </ph>
- Die Berichte werden mit einer Verzögerung gesendet.
- Die Conversion-Daten sind verrauscht, d. h., für einen bestimmten Prozentsatz der Zeit werden falsche Berichte erstellt.
- 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 dass Nutzer websiteübergreifend erfasst werden. Dazu werden die folgenden Datenschutzmechanismen verwendet:
- Es wird keine websiteübergreifende Kennung verwendet.
- Jede Attribution kann mehrere Beiträge zu einer resultierenden Zusammenfassung leisten Bericht. Jeder Nutzer kann mehrere Zuordnungen für eine bestimmte Klick (oder Aufruf) und Conversion.
- Die Daten werden bis zur Ebene vieler Ereignisse (viele Nutzer) aggregiert und es gibt keine einzelne Ereignisse genau beobachtet werden können. Wenn Sie sich die aggregierte Daten: Mit zunehmendem Detaillierungsgrad steigt auch das relative Rauschen. nehmen ebenfalls zu. Datensegmente, die viele Ereignisse zusammenfassen und Nutzer sind genauer, um die Nützlichkeit zu wahren.
- Die Rohberichte, die ein detailliertes Klick- oder Aufrufereignis mit detaillierten Conversion-Daten verschlüsselt und für den AdTech-Unternehmen nicht lesbar sind. Diese Daten können nur vom Aggregationsdienst gelesen werden.
- Es werden zusätzliche Schutzmaßnahmen angewendet, um Missbrauch und websiteübergreifendes Tracking zu verhindern:
<ph type="x-smartling-placeholder">
- </ph>
- Berichte werden mit willkürlichen Verzögerungen gesendet.
- Für Abfragen in verschiedenen Datensegmenten gilt eine Ratenbegrenzung.
Interagieren und Feedback geben
- Bei Fragen zur API: Problem erstellen im API-Repository.
- Aktuelle Informationen und Ankündigungen zur API erhalten Sie auf der Mailingliste für Attributionsberichte
- Bei technischen Fragen Fehler in Chromium melden
- Bei Fragen zur Implementierung und Einbindung sowie zu allgemeinen Best Practices: Problem erstellen Privacy Sandbox-Support-Repository für Entwickler.