Mit der Attribution Reporting API und der Private Aggregation API können Sie Daten messen, die nutzerübergreifend aggregiert werden.
Implementierungsstatus
- Zusammenfassungsberichte zur Attribution verwenden und damit experimentieren
Was ist ein Übersichtsbericht?
Für eine Gruppe von Nutzern wird ein Zusammenfassungsbericht erstellt, der nicht mit einzelnen Personen in Verbindung gebracht werden kann. Zusammenfassungsberichte enthalten detaillierte Conversion-Daten mit Flexibilität für Klick- und Ansichtsdaten. Zusammenfassende Berichte basieren nicht auf Drittanbieter-Cookies oder Mechanismen, mit denen einzelne Nutzer websiteübergreifend identifiziert werden können.
Zusammenfassungsberichte werden in zwei Kontexten erstellt:
- Anzeigenmessung: Ad-Tech-Unternehmen können mit Attribution Reporting zusammenfassende Berichte erstellen, um zu messen, wann ein Anzeigenklick oder -aufruf zu einer Conversion auf der Website eines Werbetreibenden führt, z. B. zu einem Verkauf oder einer Registrierung. Anbieter von Anzeigentechnologien können auch Zusammenfassungsberichte für Protected Audience API-Auktionen mit Private Aggregation erstellen.
- Allgemeine websiteübergreifende Berichterstellung: Entwickler erfassen websiteübergreifende Daten in Shared Storage und können diese Daten mit der Private Aggregation API analysieren. Das hat viele Vorteile, z. B. können Sie so demografische Daten zu Nutzern abrufen und die Reichweite von Inhalten erfassen.
Zusammenfassungsberichte werden für Attribution Reporting und Private Aggregation unterschiedlich angefordert. Bevor Sie lernen, wie Sie Berichte erstellen, müssen Sie zuerst verstehen, was Aggregation ist und wie Sie mit Übersichtsberichten Ihre Analyseanforderungen erfüllen können.
Wichtige Konzepte
Datenerhebung planen
Ein wichtiger Grundsatz von Zusammenfassungsberichten sind frühe Designentscheidungen. Sie entscheiden, welche Daten in welchen Kategorien erhoben werden. Die Ausgabedokumente enthalten Informationen zu Ihren Kampagnen oder Ihrem Unternehmen.
Der Ausgabebereicht enthält detaillierte Conversion-Daten für mehrere Websites und bietet die Möglichkeit, Klick- und Ansichtsdaten mit Conversion-Daten zu verknüpfen. Sie können sich die endgültige Ausgabe auch als Eingabe für die Tools vorstellen, mit denen Sie Entscheidungen treffen.
Überlege dir, was du über das Nutzer-Engagement mit deinen Inhalten erfahren möchtest.
Anzeigen-Conversions
Wenn Sie beispielsweise Übersichtsberichte erstellen, um zu ermitteln, wie viele Conversions zu einem bestimmten Gesamtausgabenwert geführt haben, kann Ihr Team so entscheiden, worauf sich die nächste Werbekampagne konzentrieren sollte, um höhere Gesamtausgaben zu erzielen.

Websiteübergreifende Interaktionen
Wenn Sie beispielsweise Übersichtsberichte erstellen, um zu ermitteln, wie viele Nutzer Ihre Inhalte auf der Website eines Drittanbieters lesen, kann Ihr Team so entscheiden, wie es mit diesem Drittanbieter zusammenarbeiten kann, um mehr Interaktionen zu erzielen und Leser zu ermutigen, Ihre Website direkt zu besuchen.
Welche Informationen werden im Browser erfasst?
Ein aggregierbarer Bericht enthält die Rohdaten, die im Browser eines Nutzers erfasst werden. Dazu gehört eine vordefinierte Gruppe von Buckets (oder Aggregationsschlüsseln). Wie Sie diese Kriterien festlegen, hängt von Ihren Designentscheidungen ab.
Zusammenfassungsberichte enthalten eine Kombination aus aggregierten Daten und detaillierten Conversion-Daten.
Anzeigen-Conversions
Conversions werden vom Werbetreibenden oder vom Ad-Tech-Unternehmen definiert und können für verschiedene Werbekampagnen unterschiedlich sein. In einer Kampagne könnte die Anzahl der Anzeigenklicks gemessen werden, auf die ein Nutzerkauf des beworbenen Artikels folgte. In einer anderen Kampagne könnte gemessen werden, wie viele Anzeigenaufrufe zu Websitebesuchen des Werbetreibenden geführt haben.
Ein Ad-Tech-Anbieter schaltet beispielsweise eine Werbekampagne auf news.example. Eine Conversion liegt vor, wenn ein Nutzer auf eine Anzeige für Schuhe klickt und auf shoes.example Schuhe kauft.
Die Ad-Tech-Plattform erhält einen zusammenfassenden Bericht für diese Werbekampagne mit der ID 1234567
, in dem angegeben ist, dass am 12. Januar 2022 518 Conversions für schuhe.beispiel erzielt wurden und die Gesamtausgaben 38.174 € betrugen. 60% der Conversions stammten von Nutzern, die blaue Sneaker mit der Produkt-SKU 9872
gekauft haben, und 40% von Nutzern, die gelbe Sandalen mit der Produkt-SKU 2643
gekauft haben. Die Kampagnen-ID ist eine detaillierte Anzeige-Seite, während die Produkt-SKUs detaillierte Conversion-Daten sind. Die Anzahl der Conversions und die Gesamtausgaben sind aggregierte Daten.
Websiteübergreifende Interaktionen
Bevor Sie Daten erfassen können, müssen Sie festlegen, welche Informationen Sie erfassen möchten, welche Conversions Sie von einer bestimmten websiteübergreifenden Integration erwarten und welchen Berichtstyp Sie erfassen möchten.
Es gibt eine Reihe möglicher Anwendungsfälle, die in der Dokumentation zur Private Aggregation API beschrieben werden. Sehen wir uns ein Beispiel an:
Möglicherweise möchten Sie die demografischen Merkmale der Nutzer erfassen, die Ihre Inhalte auf verschiedenen Websites gesehen haben. Mit Private Aggregation kann eine Antwort wie „Ungefähr 317 einzelne Nutzer im Alter von 18 bis 45 Jahren aus Deutschland“ bereitgestellt werden. Legen Sie zuerst fest, welche Informationen Sie genau erfassen möchten, z. B. Alter und Standort. Verwenden Sie dann Shared Storage, um diese spezifischen demografischen Daten von einer Drittanbieterwebsite zu erheben. Zu einem späteren Zeitpunkt können Sie einen Bericht mit der Private Aggregation API einreichen, wobei die Dimensionen „Altersgruppe“ und „Land“ im Aggregationsschlüssel codiert sind.
Wie werden Daten vor der Aggregation erfasst?
Zusammenfassungsberichte bestehen aus aggregierten Daten einer Gruppe von einzelnen Geräten. Die Aktionen einzelner Nutzer können zwar nicht beobachtet und überprüft werden, der Erfassungsprozess ist jedoch für jede Person gleich.
Die Aktionen eines einzelnen Nutzers werden verschlüsselt und in einem zusammenfassbaren Bericht erfasst. Diese Berichte enthalten auch eine geringe Menge an unverschlüsselten Metadaten, die für die Batchverarbeitung relevant sind.
Für Daten aus dem Attribution Reporting werden aggregierbare Berichte so erfasst:
- Ein Nutzer besucht eine Publisher-Website und sieht sich eine Anzeige an oder klickt darauf. Dies wird als Attributionsquellereignis bezeichnet.
- Einige Minuten oder Tage später führt der Nutzer eine Conversion durch. Dies wird auch als Attributionsauslöserereignis bezeichnet. Eine Conversion kann beispielsweise als Produktkauf definiert werden.
- Die Browser-Software gleicht den Anzeigenklick oder -aufruf mit dem Conversion-Ereignis ab. Basierend auf diesem Abgleich erstellt der Browser einen aggregierbaren Bericht mit einer bestimmten Logik, die von einem AdTech-Anbieter erstellt wurde.
- Der Browser verschlüsselt diese Daten und sendet sie nach einer kurzen Verzögerung an einen AdTech-Server, um sie zu erfassen. Der Ad-Tech-Server muss auf einen Aggregationsdienst zurückgreifen, um auf die anonymisierten Statistiken zuzugreifen.
Für die private Aggregation sieht das so aus:
- Eine Drittpartei entscheidet, was gemessen werden soll, und schreibt die Daten in den freigegebenen Speicher, damit sie später gelesen werden können.
- Der Nutzer löst ein Ereignis aus, das dem entspricht, was der Drittanbieter messen möchte. Wenn der Nutzer beispielsweise eine Website mit eingebetteten Inhalten besucht, kann der Drittanbieter die Daten in Shared Storage lesen und mit Private Aggregation verschlüsselte aggregierbare Berichte zum Erfassen an Ihren Server senden.

Batch-aggregierbare Berichte
Bevor die erfassten aggregierbaren Berichte verarbeitet und in einem Zusammenfassungsbericht zusammengefasst werden können, müssen sie in Batches aufgeteilt werden. Ein Batch ist eine strategische Gruppe von aggregierbaren Berichten.
Aggregierbare Berichte enthalten eine geringe Menge an unverschlüsselten Daten, die als shared_info
angegeben sind und zum Erstellen von Batches verwendet werden können. Dazu gehören der Zeitstempel und der Ursprung des Berichts. Sie können keine Batch-Analyse auf Grundlage verschlüsselter Informationen im Bericht durchführen.
Idealerweise enthalten Batches viele Berichte. Sie können die Daten stündlich, täglich, wöchentlich oder in einem anderen Rhythmus Ihrer Wahl zusammenfassen. Diese Strategie kann sich bei bestimmten Ereignissen ändern, bei denen ein höheres Trafficvolumen erwartet wird.
Wenn Sie beispielsweise aggregierbare Berichte für die Attribution Reporting API in Batches zusammenfassen, können Sie die Batching-Strategie für den Tag eines großen Sonderverkaufs, an dem Sie mit einer größeren Anzahl von Anzeigen-Conversions rechnen, auf stündlich umstellen.
Mit der Private Aggregation API können Sie Ihre Strategie möglicherweise am Tag einer großen Pressemitteilung zu bestimmten Inhalten ändern, die auf Drittanbieterwebsites eingebettet sind.
Daten mit dem Aggregationsdienst verarbeiten
Der Aggregationsdienst entschlüsselt und kombiniert die Batchdaten aus den aggregierbaren Berichten, fügt Rauschen hinzu und gibt den endgültigen Zusammenfassungsbericht zurück. Dieser Dienst wird in einer vertrauenswürdigen Ausführungsumgebung (Trusted Execution Environment, TEE) ausgeführt, die in einem Cloud-Dienst bereitgestellt wird, der die erforderlichen Sicherheitsmaßnahmen zum Schutz dieser Daten unterstützt.
Zusammenfassende Berichte mit Attribution Reporting
Damit Anbieter von Anzeigentechnologien einen Zusammenfassungsbericht abrufen können, müssen die folgenden Schritte ausgeführt werden:
- Der AdTech-Anbieter erfasst aggregierbare Berichte aus den Browsern einzelner Nutzer.
- Der AdTech-Anbieter bündelt die aggregierbaren Berichte in Batches und sendet diese an den Aggregationsdienst.
- Der Aggregationsdienst plant einen Worker, um die Daten zu aggregieren.
- Der Aggregations-Worker entschlüsselt und aggregiert Daten aus den aggregierbaren Berichten sowie verrauschte Daten.
- Der Aggregationsdienst gibt den Zusammenfassungsbericht an den AdTech-Anbieter zurück.

Die Ad-Tech-Plattform kann den zusammengefassten Bericht verwenden, um Gebote zu optimieren und ihren eigenen Kunden Berichte zur Verfügung zu stellen. Ein JSON-codiertes Schema ist das vorgeschlagene Format für Zusammenfassungsberichte.
Zusammenfassungsberichte mit privater Aggregation
- Lesen Sie die websiteübergreifenden Daten, die von Shared Storage erfasst wurden, und generieren Sie einen Aggregationsschlüssel, um die Daten zu gruppieren.
- Rufen Sie die Private Aggregation API über ein Shared Storage-Worklet mit dem Aggregationsschlüssel und dem Wert auf, den Sie zusammenfassen möchten. Der Browser generiert aus Ihren Eingaben einen verschlüsselten aggregierbaren Bericht und sendet ihn zur Erfassung an Ihren Server.
- Fassen Sie die aggregierbaren Berichte in Batches zusammen und senden Sie sie zur Verarbeitung an den Aggregationsdienst.
- Der Aggregationsdienst verarbeitet die Batchberichte und fügt dann Rauschen hinzu.
- Der Aggregationsdienst gibt den Zusammenfassungsbericht an den Anfragenden zurück.
Feedback geben
Zusammenfassende Berichte sind ein wichtiger Bestandteil der Privacy Sandbox-Messvorschläge. Wie andere Privacy Sandbox-Vorschläge wird auch dieser öffentlich auf GitHub dokumentiert und diskutiert.
- Über die Attribution Reporting API diskutieren
- Über die Private Aggregation API diskutieren
- Entwicklersupport: Stellen Sie Fragen und beteiligen Sie sich an Diskussionen im Privacy Sandbox Developer Support-Repository.