Attribution Reporting API

Konzepte und Nutzung

Werbetreibende mchten hufig messen, wie viele Nutzer eine Werbung sehen und anschlieend ein Produkt ansehen und kaufen (Konversionen). Dies ermglicht es ihnen herauszufinden, welche Werbeplatzierungen ihnen die hchste Rendite bringen, sodass sie ihre Werbestrategie entsprechend anpassen knnen. Der Prozess der Konversionsmessung umfasst blicherweise das Erfassen von Daten wie:

• Welche Nutzer konvertiert haben (z. B. ein Produkt gekauft oder sich fr einen Dienst angemeldet haben) und wie viele.
• Die geografischen Regionen, in denen sie sich befinden.
• Auf welchen Websites die Anzeigen platziert wurden.
• Wie viele Produkte verkauft oder Dienste abonniert wurden usw.
• Wie viel Umsatz generiert wurde.

Traditionell wurde im Web die Konversion mit Third-Party-Tracking-Cookies gemessen. Eine Werbung wird typischerweise in eine Webseite in einem <iframe> eingebettet, das ein Cookie setzen kann, das Informationen ber den Nutzer und seine Interaktion mit der Werbung enthlt.

Spter, wenn der Nutzer beschliet, die Website des Werbetreibenden zu besuchen, vorausgesetzt, sie stammt aus demselben Domain wie die Anzeige, kann diese Website auf das zuvor von der Werbung gesetzte Third-Party-Cookie zugreifen. Der Werbetreibende kann dann die Daten aus der Anzeige mit seinen eigenen First-Party-Daten in Verbindung bringen, um Fragen zu beantworten wie "Hat der Nutzer ein Produkt gekauft, nachdem er mit einer Werbung fr das Produkt von einer anderen Website interagiert hat?"

Dies ist schlecht fr die Privatsphre des Nutzers. An diesem Punkt kann jede Seite aus derselben Domain auf dieses Cookie zugreifen sowie auf Informationen von eingebetteten Seiten. Eine berraschend groe Anzahl Parteien wird in der Lage sein, auf diese Daten zuzugreifen und andere Daten ber den Nutzer basierend auf seinem Surfverhalten abzuleiten.

Die Attribution Reporting API bietet eine Mglichkeit, Werbekonversionen auf eine Weise zu messen, die die Privatsphre der Nutzer schtzt.

Wie funktioniert es?

Lassen Sie uns anhand eines Beispiels erlutern, wie die Attribution Reporting API funktioniert.

Angenommen, wir haben einen Online-Shop, shop.example (auch als Werbetreibender bekannt), der eine Anzeige fr eines seiner Produkte auf einer Content-Website, news.example (auch als Publisher bekannt), einbettet. Der Anzeigeninhalt befindet sich unter ad.shop.example.

Die Inhaber des Online-Shops mchten messen, wie viele Konversionen sie von Nutzern erhalten, die mit der Anzeige interagieren, die Produktseite auf ihrer Website ansehen und das Produkt in ihren Einkaufswagen legen.

[Grafische Darstellung der unten beschriebenen Schritte]

Die beteiligten Schritte sind wie folgt:

1. Wenn ein Nutzer die news.example-Seite besucht, kann eine Attributionsquelle fr bestimmte Nutzerinteraktionen mit der eingebetteten Anzeige registriert werden. Es gibt verschiedene Mglichkeiten, wie ein Nutzer mit Anzeigen auf der Seite interagieren kann. Damit eine Anzeigeninteraktion eine Attributionsquelle registriert, muss die Anzeige eine Anfrage mit einem Attribution-Reporting-Eligible-Header senden, um anzugeben, dass die Antwort berechtigt ist, eine Attributionsquelle zu registrieren. Die Registrierung wird abgeschlossen, wenn die Antwort einen geeigneten Attribution-Reporting-Register-Source-Header enthlt. Die Attributionsquelle kann beispielsweise sein:
   • Ein Link. In diesem Fall ist die Interaktion das Klicken des Nutzers auf den Link (direkt ber ein <a>-Element oder ber einen -Aufruf). Die Quelle wird ber die Antwort auf die Navigationsanfrage registriert.
   • Ein Bild wie ein Werbebanner oder ein 1x1-Transparenz-Pixel. In diesem Fall ist die Interaktion das Besuchen der Seite durch den Nutzer. Die Quelle wird registriert, wenn das Bild geladen wird, d.h. wenn der Server auf die Bildanfrage antwortet.
   • Eine Fetch-Anfrage (d.h. ein fetch() oder XMLHttpRequest). In diesem Fall kann die Interaktion als das spezifiziert werden, was fr Ihre App sinnvoll ist zum Beispiel knnte die Fetch-Anfrage durch ein click- oder submit-Ereignis ausgelst werden. Die Quelle wird registriert, sobald die Antwort zurckkommt.
2. Wenn die Interaktion mit der Attributionsquelle stattfindet, werden die im Attribution-Reporting-Register-Source-Header zurckgegebenen Quelldaten in einem privaten lokalen Cache gespeichert, auf den nur der Browser zugreifen kann. Diese Daten umfassen die kontextuellen und First-Party-Daten, die der Seite und dem Werbetreibenden zur Verfgung stehen, den Ursprung des Ad-Tech-Unternehmens, das die Konversionsdaten sammelt, und ein oder mehrere Ziele (registrierbare Domains), in denen Sie erwarten, dass die Konversion von dieser Anzeige stattfindet (d.h. die Website(s) des Werbetreibenden, zum Beispiel shop.example).
3. Wenn der Nutzer spter shop.example besucht, kann diese Website einen Attribution-Trigger registrieren, wenn eine Interaktion zeigt, dass eine Konversion stattgefunden hat (z. B. der Nutzer klickt auf die Schaltflche "In den Warenkorb" auf shop.example). Der Browser sendet dann eine Anfrage zusammen mit einem Attribution-Reporting-Eligible-Header, um anzugeben, dass die Antwort berechtigt ist, einen Attribution-Trigger zu registrieren, und die Registrierung wird abgeschlossen, wenn die Antwort einen geeigneten Attribution-Reporting-Register-Trigger-Header enthlt. Der Attribution-Trigger kann beispielsweise sein:
   • Ein Bild wie ein Einkaufswagen-Symbol oder ein 1x1-Transparenz-Pixel. In diesem Fall ist die Interaktion das Besuchen der Seite durch den Nutzer. Der Trigger wird registriert, wenn das Bild geladen wird, d.h. wenn der Server auf die Bildanfrage antwortet.
   • Eine Fetch-Anfrage (d.h. ein fetch() oder XMLHttpRequest). In diesem Fall kann die Interaktion als das spezifiziert werden, was fr Ihre App sinnvoll ist zum Beispiel knnte die Fetch-Anfrage durch ein click- oder submit-Ereignis ausgelst werden. Der Trigger wird registriert, sobald die Antwort zurckkommt.
4. Wenn die Trigger-Attribution abgeschlossen ist, versucht der Browser die Daten aus dem Attribution-Reporting-Register-Trigger-Header mit einem in dem privaten lokalen Cache gespeicherten Quelldateneintrag (siehe 2.) abzugleichen. Siehe Registrieren von Attribution-Triggers fr die bereinstimmungsmethodik und Anforderungen.
5. Wenn eine bereinstimmung hergestellt wird, sendet der Browser Berichts-Daten an einen Endpunkt auf einem Reporting-Server, der typischerweise dem Ad-Tech-Anbieter gehrt, wo sie sicher analysiert werden knnen. Anders als bei Cookies sind die Daten nur fr die spezielle Seite verfgbar, zu der Sie sie senden es werden keine Daten anderweitig geteilt. Diese Berichte knnen entweder sein:
   • Ereignisbezogene Berichte: Berichte basierend auf einem Attributionsquellenereignis, bei dem detaillierte Quelldaten mit groben Triggerdaten verknpft sind. Zum Beispiel knnte ein Bericht aussehen wie "Klick-ID 200498 auf ad.shop.example fhrte zu einem Kauf auf shop.example", wobei "Klick-ID 200498" die detaillierten Quelldaten sind und "Kauf" die groben Triggerdaten sind. Die detaillierten Quelldaten knnen First-Party- oder kontextuelle Daten von der Quellseite kodieren, und die Triggerdaten knnen das Ereignis von der Triggerseite kodieren.
   • Zusammenfassungsberichte: Detailliertere Berichte, die Daten aus mehreren Konversionen sowohl auf der Quell- als auch auf der Triggerseite kombinieren. Zum Beispiel "Kampagnen-ID 774653 auf news.example hat zu 654 Verkufen von Widgets auf shop.example von Nutzern in Italien gefhrt, mit einem Gesamtumsatz von $9540." Das Erstellen eines Zusammenfassungsberichtes erfordert die Nutzung eines Aggregationsdienstes (siehe zum Beispiel den Google-Aggregationsdienst).

Fr weitere Informationen zur Implementierung der fr die oben genannten Schritte erforderlichen Funktionalitt, siehe:

1. Registrieren von Attributionsquellen
2. Registrieren von Attribution-Triggers
3. Berichte erstellen

Schnittstellen

Die Attribution Reporting API definiert keine eigenen speziellen Schnittstellen.

Erweiterungen zu anderen Schnittstellen

HTMLAnchorElement.attributionSrc, HTMLImageElement.attributionSrc, HTMLScriptElement.attributionSrc

Die attributionSrc-Eigenschaft ermglicht es Ihnen, das attributionsrc-Attribut auf <a>, <img>, und <script>-Elementen programmatisch zu setzen und abzurufen. Es spiegelt den Wert dieses Attributs wider.

fetch() und der Request()-Konstruktor, die attributionReporting-Option

Bei der Generierung einer Anfrage ber fetch() gibt dies an, dass Sie mchten, dass die Antwort in der Lage ist, eine Attributionsquelle oder einen Trigger zu registrieren.

XMLHttpRequest.setAttributionReporting()

Bei der Generierung einer Anfrage ber XMLHttpRequest gibt dies an, dass Sie mchten, dass die Antwort in der Lage ist, eine Attributionsquelle oder einen Trigger zu registrieren.

, das attributionsrc-Feature-Stichwort

Verursacht den Abschluss der Registrierung einer Attributionsquelle und lst aus, dass der Browser die zugehrigen Quelldaten speichert (wie im Attribution-Reporting-Register-Source-Antwort-Header angegeben), wenn die open()-Methode abgeschlossen ist. Beachten Sie, dass -Aufrufe nicht verwendet werden knnen, um Attributions-Triggers zu registrieren.

HTML-Elemente

<a>, <img>, und <script> das attributionsrc-Attribut

Gibt an, dass Sie mchten, dass der Browser einen Attribution-Reporting-Eligible-Header zusammen mit der zugehrigen Ressourcenanforderung sendet. Auf der Serverseite wird dieser Header verwendet, um das Senden eines Attribution-Reporting-Register-Source- oder Attribution-Reporting-Register-Trigger-Headers in der Antwort auszulsen. Bei der Registrierung einer Attributionsquelle ist dies erforderlich; bei der Registrierung eines Attribution-Triggers ist es nur erforderlich, wenn Sie einen separaten Registrierungsserver zur Ressource angeben mchten, auf die das src-Attribut zeigt. Beachten Sie, dass <a>-Elemente nicht verwendet werden knnen, um Attribution-Triggers zu registrieren.

HTTP-Header

Attribution-Reporting-Eligible

HTTP-Anfrage, die angibt, dass die entsprechende Antwort geeignet ist, eine Attributionsquelle oder einen Trigger zu registrieren.

Attribution-Reporting-Register-Source

HTTP-Antwort, die ein Seitenfeature als Attributionsquelle registriert. Dies ist Bestandteil einer Antwort auf eine Anfrage, die einen Attribution-Reporting-Eligible-Header enthielt.

Attribution-Reporting-Register-Trigger

HTTP-Antwort, die ein Seitenfeature als Attribution-Trigger registriert. Dies ist Bestandteil einer Antwort auf eine Anfrage, die einen Attribution-Reporting-Eligible-Header enthielt.

Permissions-Policy attribution-reporting-Direktive

Steuert, ob das aktuelle Dokument die Attributionsberichterstattung verwenden darf.

Anmeldung und lokale Tests

Um die Attribution Reporting API auf Ihren Websites zu nutzen, mssen Sie sie im Privatsphre-Sandbox-Anmeldeprozess angeben. Wenn Sie dies nicht tun, wird der API-Fluss zur Antwortzeit blockiert, d.h. die Antwort-Header werden ignoriert und Quellen und Trigger nicht registriert.

Sie knnen Ihren Attribution Reporting API-Code dennoch lokal ohne Anmeldung testen. Um lokale Tests zu ermglichen, aktivieren Sie das folgende Chrome-Entwickler-Flag:

chrome://flags/#privacy-sandbox-enrollment-overrides

Beispiele

Sehen Sie sich Demo: Attribution Reporting API fr eine Implementierungsbeispiel an (siehe auch den Quellcode).

Spezifikationen

Diese Funktion scheint in keiner Spezifikation definiert zu sein.

Browser-Kompatibilitt

Siehe auch

• Attribution Reporting Header Validation tool
• Attribution reporting auf privacysandbox.google.com (2023)
• Aktivieren der Konversionsmessung auf privacysandbox.google.com (2023)
• Die Privacy Sandbox auf privacysandbox.google.com (2023)