Mit der Attribution Reporting API und der Private Aggregation API können Sie nutzerübergreifende Daten erfassen.
Implementierungsstatus
- Zusammenfassende Berichte zu Attributionsberichten erstellen und ausprobieren
Was ist ein zusammenfassender Bericht?
Ein zusammenfassender Bericht wird für eine Gruppe von Nutzern zusammengestellt und kann keiner Einzelperson zugeordnet werden. Zusammenfassende Berichte bieten detaillierte Conversion-Daten mit Flexibilität bei Klick- und Aufrufdaten. Zusammenfassende Berichte beruhen nicht auf Drittanbieter-Cookies oder Mechanismen, mit denen einzelne Nutzer websiteübergreifend identifiziert werden können.
Zusammenfassende Berichte werden in zwei Kontexten erstellt:
- Analyse von Anzeigen: Anzeigentechnologie-Anbieter können mit Attribution Reporting zusammenfassende Berichte erstellen, um zu messen, wann ein Anzeigenklick oder ein Aufruf zu einer Conversion auf der Website des Werbetreibenden führt, z. B. zu einem Verkauf oder einer Registrierung. AdTech-Unternehmen können auch zusammenfassende Berichte für Protected Audience API-Auktionen mit privater Aggregation generieren.
- Allgemeine websiteübergreifende Berichterstellung: Entwickler erfassen websiteübergreifende Daten in freigegebenem Speicher und können diese Daten mit der privaten Aggregation in Berichten abrufen. Dafür gibt es viele Anwendungsmöglichkeiten, z. B. das Gewinnen von Einblicken in die demografischen Merkmale der Nutzer und das Erfassen von Unique Reach für Inhalte.
Zusammenfassende Berichte werden für Attributionsberichte und die private Aggregation unterschiedlich angefordert. Bevor Sie lernen, wie Berichte erstellt werden, müssen Sie wissen, was Aggregation ist und wie Zusammenfassungsberichte für Ihre Analyseanforderungen verwendet werden können.
Wichtige Konzepte
Datenerhebung gestalten
Ein Grundprinzip von Zusammenfassungsberichten ist es, frühzeitige Designentscheidungen zu treffen. Sie entscheiden, welche Daten in welchen Kategorien gesammelt werden. Die Ausgabeberichte liefern Einblicke in Ihre Kampagnen oder Ihr Unternehmen.
Der Ausgabebericht bietet detaillierte websiteübergreifende Conversion-Daten und Flexibilität, Klick- und Aufrufdaten mit Conversion-Daten zusammenzuführen. Sie können sich das Endergebnis auch als Input für die Tools vorstellen, mit denen Sie Entscheidungen treffen.
Fragen Sie sich: Was möchte ich über die Interaktion von Nutzern mit meinen Inhalten erfahren?
Anzeigen-Conversions
Wenn Sie z. B. Zusammenfassungsberichte generieren, um zu ermitteln, wie viele Conversions zu einem bestimmten Gesamtwert der Ausgaben geführt haben, kann das Ihrem Team bei der Entscheidung helfen, auf welche Ziele Ihre nächste Werbekampagne ausgerichtet ist, um höhere Gesamtausgaben zu erzielen.
![Diagramm, das zeigt, wie mehrere aggregierte Berichte verarbeitet und verrauscht werden, um spezifische Zusammenfassungsberichte zu generieren.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/diagram-shows-multiple-f504e84e824cc.png?authuser=19&hl=de)
Websiteübergreifende Interaktion
Wenn Sie beispielsweise Zusammenfassungsberichte erstellen, um zu ermitteln, wie viele Personen Ihre Inhalte auf der Website eines Drittanbieters lesen, kann das Ihrem Team bei der Entscheidung helfen, wie eine Partnerschaft mit diesem Drittanbieter eingehen soll, um mehr Interaktionen zu erzielen und Leser zu ermutigen, Ihre Website direkt zu besuchen.
Welche Informationen werden im Browser erfasst?
Ein aggregierbarer Bericht besteht aus den Rohdaten, die vom Browser eines Nutzers erfasst werden und eine vordefinierte Gruppe von Buckets (oder Aggregationsschlüsseln) enthalten. Wie Sie diese Kriterien bestimmen, hängt von Ihren Designentscheidungen ab.
Zusammenfassungsberichte bieten eine Kombination aus aggregierten Daten und detaillierten Conversion-Daten.
Anzeigen-Conversions
Conversions werden vom Werbetreibenden oder vom AdTech-Unternehmen definiert und können je nach Werbekampagne unterschiedlich sein. Bei einer Kampagne kann die Anzahl der Anzeigenklicks erfasst werden, auf die ein Nutzer den beworbenen Artikel kaufte. Mit einer anderen Kampagne könnte gemessen werden, wie viele Anzeigenaufrufe zu Besuchen der Website des Werbetreibenden geführt haben.
Ein Anbieter von Anzeigentechnologien führt beispielsweise eine Werbekampagne für news.example durch, bei der eine Conversion für einen Nutzer steht, der auf eine Anzeige für Schuhe klickt und den Kauf von Schuhen über Schuhe abschließt.
Der AdTech-Mitarbeiter erhält einen zusammenfassenden Bericht für diese Werbekampagne mit der ID 1234567
, aus dem hervorgeht, dass am 12. Januar 2022 518 Conversions für „schuhe.beispiel“ mit Gesamtausgaben von 38.174 € erzielt wurden. 60% der Conversions stammten von Nutzern, die blaue Sneaker mit der Produkt-Artikelnummer 9872
gekauft haben, und 40% waren Nutzer, die gelbe Sandalen mit der Artikelnummer 2643
gekauft haben. Bei der Kampagnen-ID handelt es sich um detaillierte Daten auf Anzeigenseite, während die Artikelnummern bei den Produkten detaillierte Conversion-Daten darstellen. Die Anzahl der Conversions und die Gesamtausgaben sind aggregierte Daten.
Websiteübergreifende Interaktion
Bevor Sie Daten erheben können, müssen Sie festlegen, welche Daten erfasst werden sollen, welche Conversions Sie von einer bestimmten websiteübergreifenden Integration erwarten und bestimmen, welcher Berichtstyp erfasst werden soll.
Es gibt eine Reihe möglicher Anwendungsfälle, die in der Dokumentation zur privaten Aggregation näher ausgeführt werden. Sehen wir uns ein Beispiel an:
Sie können die demografischen Merkmale der Nutzer erfassen, die Ihren Content auf verschiedenen Websites gesehen haben. Private Aggregation kann eine Antwort liefern, z. B.: „Ungefähr 317 einzelne Nutzer sind im Alter von 18 bis 45 Jahren und stammen aus Deutschland.“ Entscheiden Sie zuerst, welche Informationen Sie erheben möchten (z. B. Alter und Standort). Verwenden Sie dann freigegebenen Speicher, um diese demografischen Daten von der Website eines Drittanbieters zu erfassen. Später können Sie einen Bericht über die private Aggregation senden, wobei die Dimensionen „Altersgruppe“ und „Land“ im Aggregationsschlüssel codiert sind.
Wie werden Daten vor der Aggregation erfasst?
Zusammenfassungsberichte enthalten aggregierte Daten von einer Gruppe einzelner Geräte. Die Aktionen eines einzelnen Nutzers 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 Bericht zusammengefasst. Diese Berichte enthalten auch einige wenige unverschlüsselte Metadaten, die für die Batchverarbeitung relevant sind.
Für Attribution Reporting-Daten werden aggregierte Berichte folgendermaßen erfasst:
- Ein Nutzer besucht eine Publisher-Website und sieht oder klickt auf eine Anzeige. Dies wird auch als Ereignis der Attributionsquelle bezeichnet.
- Wenige Minuten oder Tage später führt der Nutzer eine Conversion durch (auch als Trigger-Ereignis für die Attribution bezeichnet). Eine Conversion kann beispielsweise als Produktkauf definiert werden.
- Die Browsersoftware ordnet den Anzeigenklick oder den Anzeigenaufruf dem Conversion-Ereignis zu. Auf Grundlage dieser Übereinstimmung erstellt der Browser einen aggregierten Bericht mit einer spezifischen Logik, die von einem Anzeigentechnologie-Anbieter erstellt wurde.
- Der Browser verschlüsselt diese Daten und sendet sie nach einer kurzen Verzögerung zur Erfassung an einen AdTech-Server. Der AdTech-Server muss einen Aggregationsdienst nutzen, um auf die verrauschten Statistiken zugreifen zu können.
Für die private Aggregation sieht das so aus:
- Ein Drittanbieter entscheidet, was er messen möchte, und schreibt die Daten in den freigegebenen Speicher, um sie später zu lesen.
- Der Nutzer löst ein Ereignis aus, das mit dem übereinstimmt, was der Drittanbieter messen möchte. Wenn ein Nutzer beispielsweise eine Website mit eingebetteten Inhalten besucht, kann der Drittanbieter die Daten im freigegebenen Speicher lesen und mit der privaten Aggregation verschlüsselte zusammengefasste Berichte zur Erhebung an Ihren Server senden.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/2Si3rdSh7jr3S6UZTSrg.png?authuser=19&hl=de)
Aggregierbare Berichte im Batch zusammenfassen
Bevor die gesammelten aggregierten Berichte verarbeitet und in einem Zusammenfassungsbericht zusammengefasst werden können, müssen sie im Batch zusammengefasst werden. Ein Batch ist eine strategische Gruppe zusammenfassender Berichte.
Aggregierbare Berichte enthalten eine kleine Menge an unverschlüsselten Daten, die zum Erstellen von Batches verwendet werden können (einschließlich shared_info
). Dazu gehören auch der Zeitstempel und der Ursprung der Berichte. Es ist nicht möglich, einen Batch basierend auf verschlüsselten Informationen im Bericht zu erstellen.
Idealerweise sollten Batches viele Berichte enthalten. Sie können stündlich, täglich, wöchentlich oder einen anderen Zeitrahmen Ihrer Wahl in Batches zusammenfassen. Diese Strategie kann sich bei bestimmten Ereignissen ändern, bei denen ein höherer Traffic erwartet wird.
Wenn Sie beispielsweise aggregierte Berichte für die Attribution Reporting API im Batch zusammenfassen möchten, können Sie Ihre Batchstrategie auf stündlich für den Tag eines Großverkaufs aktualisieren, wenn Sie ein größeres Volumen an Anzeigen-Conversions erwarten.
Mit der Private Aggregation API können Sie davon ausgehen, am Tag einer großen Pressemitteilung zu einem bestimmten Inhalt, der auf Websites von Drittanbietern eingebettet ist, Ihre Strategie zu ändern.
Daten mit dem Aggregationsdienst verarbeiten
Der Aggregationsdienst entschlüsselt und kombiniert die Batch-Daten aus den aggregierten Berichten, fügt Rauschen hinzu und gibt den endgültigen zusammenfassenden Bericht 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 zusammenfassenden Bericht abrufen können, müssen Sie die folgenden Schritte ausführen:
- Der Anbieter von Anzeigentechnologien erfasst zusammengefasste Berichte aus den Browsern einzelner Nutzer.
- Der AdTech-Anbieter fasst die aggregierten Berichte in Batches zusammen und sendet die Batches an den Aggregationsdienst.
- Der Aggregationsdienst plant einen Worker, der die Daten aggregiert.
- Der Aggregations-Worker entschlüsselt und aggregiert Daten aus den aggregierten Berichten sowie verrauschte Daten.
- Der Aggregationsdienst gibt den zusammenfassenden Bericht an den Anzeigentechnologie-Anbieter zurück.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/U1ZeswSEnAMSSoCcE5Za.png?authuser=19&hl=de)
AdTech kann den zusammenfassenden Bericht verwenden, um Gebote festzulegen und seinen eigenen Kunden Berichte anzubieten. Ein JSON-codiertes Schema ist das vorgeschlagene Format für Zusammenfassungsberichte.
Zusammenfassungsberichte mit privater Aggregation
- Lesen Sie die vom freigegebenen Speicher erfassten websiteübergreifenden Daten und generieren Sie einen Aggregationsschlüssel, um die Daten zu gruppieren.
- Rufen Sie die Private Aggregation API aus einem freigegebenen Speicher-Worklet mit dem Aggregationsschlüssel und dem Wert auf, den Sie akkumulieren möchten. Der Browser generiert einen verschlüsselten aggregierten Bericht aus Ihrer Eingabe und sendet ihn zur Erfassung an Ihren Server.
- Die aggregierbaren Berichte in Batches zusammenfassen und zur Verarbeitung an den Aggregationsdienst senden
- Der Aggregationsdienst verarbeitet die Batch-Berichte und fügt dann „Rauschen“ hinzu.
- Der Aggregationsdienst gibt den zusammenfassenden Bericht an den Anforderer zurück.
Reagieren und Feedback geben
Zusammenfassende Berichte sind ein wichtiger Bestandteil der Privacy Sandbox-Analysevorschläge. Wie bei anderen Privacy Sandbox-Vorschlägen wird dies auf GitHub dokumentiert und öffentlich diskutiert.
- Über die Attribution Reporting API sprechen
- Über die Private Aggregation API sprechen
- Support für Entwickler: Im Repository für den Privacy Sandbox-Entwicklersupport können Sie Fragen stellen und sich an Diskussionen beteiligen.