Allgemeiner Überblick über verbundene Dienste für Attribution Reporting für technische Entscheidungsträger
Mit der Attribution Reporting API können Anzeigentechnologie-Anbieter und Werbetreibende messen, wann ein Klick auf eine Anzeige oder ein Aufruf zu einer Conversion, z. B. zu einem Kauf, führt. Diese API basiert auf einer Kombination aus clientseitigen und serverseitigen Integrationen, je nach Ihren Geschäftsanforderungen.
Bevor Sie fortfahren, sollten Sie die Übersicht über Attributionsberichte lesen. So können Sie den Zweck der API und den Ablauf der verschiedenen Ausgabeberichte (Bericht auf Ereignisebene und Zusammenfassungsberichte) besser verstehen. Wenn Sie auf unbekannte Begriffe stoßen, finden Sie Informationen im Privacy Sandbox-Glossar.
An wen richtet sich dieser Artikel?
In folgenden Fällen sollten Sie diesen Artikel lesen:
- Sie sind der technische Entscheidungsträger eines Anzeigentechnologie-Anbieters oder eines Werbetreibenden. Sie können in den Bereichen Operations, DevOps, Data Science, IT, Marketing oder eine andere Position tätig sein, in der Sie Entscheidungen zur technischen Implementierung treffen. Sie fragen sich, wie die APIs für datenschutzfreundliche Messungen funktionieren.
- Sie sind ein technischer Experte (z. B. Entwickler, Systemoperator, Systemarchitekt oder Data Scientist) und richten Experimente mit dieser API- und Aggregationsdienst-Umgebung ein.
In diesem Artikel finden Sie eine umfassende End-to-End-Erläuterung der Funktionsweise der Dienste für die Attribution Reporting API. Wenn Sie ein technischer Nutzer sind, können Sie diese API lokal testen.
Überblick
Die Attribution Reporting API besteht aus vielen Diensten, für die eine bestimmte Einrichtung, clientseitige Konfigurationen und Serverbereitstellungen erforderlich sind. Um zu ermitteln, was Sie benötigen, gehen Sie zuerst so vor:
- Designentscheidungen treffen: Legen Sie fest, welche Daten Sie erfassen möchten, welche Conversions Sie von einer bestimmten Kampagne erwarten und welche Berichtart Sie erfassen möchten. Das Endergebnis ist einer oder beide der beiden Berichtstypen: Berichte auf Ereignisebene und Zusammenfassungsberichte.
Es gibt immer zwei (und manchmal drei) Komponenten, die bei der Berichterstellung zusammenwirken:
- Website-zu-Browser-Kommunikation: In auf Cookies basierenden Systemen werden Informationen zu Conversions und Anzeigeninteraktionen an eine Kennung angehängt, damit Sie oder ein Analysedienst diese Ereignisse später verknüpfen können. Mit dieser API ordnet der Browser auf Grundlage Ihrer Anweisungen Conversions den Anzeigenklicks/-aufrufen zu, bevor sie zur Analyse gesendet wird. Daher müssen Ihr Anzeigen-Rendering-Code und das Conversion-Tracking diese Anforderungen erfüllen:
- Teilen Sie dem Browser mit, welche Conversions welchen Anzeigenklicks oder Impressionen zugeordnet werden sollen.
- Geben Sie alle weiteren Daten an, die in den Abschlussberichten enthalten sein sollen.
- Datenerhebung: Sie benötigen einen Collector-Endpunkt, um die in den Browsern der Nutzer generierten Berichte zu empfangen. Browser geben zwei Arten von Berichten aus: Berichte auf Ereignisebene und aggregierte Berichte. Diese sind verschlüsselt und werden zum Erstellen von Zusammenfassungsberichten verwendet.
Für aggregierte Berichte benötigen Sie eine dritte Komponente:
- Erstellung von Zusammenfassungsberichten: Batch-Aggregatberichte erstellen und den Aggregationsdienst verwenden, um die Berichte zu verarbeiten, um einen zusammenfassenden Bericht zu generieren.
Designentscheidungen
Ein Grundprinzip des Attribution Reportings ist eine frühzeitige Designentscheidung. Sie entscheiden, welche Daten in welchen Kategorien erfasst werden und wie oft diese Daten verarbeitet werden. Die Ausgabeberichte liefern Informationen zu Ihren Kampagnen oder Ihrem Unternehmen.
Der Ausgabebericht kann so aussehen:
- In Berichten auf Ereignisebene werden bestimmte Anzeigenklicks oder ‐aufrufe (auf Anzeigenseite) mit Daten auf der Conversion-Seite verknüpft. Um den Datenschutz für Nutzer zu wahren, indem die Zusammenführung der Nutzeridentität auf Websites eingeschränkt wird, sind die Daten auf Conversion-Seite sehr begrenzt und die Daten sind ungenau. Das bedeutet, dass in einem kleinen Prozentsatz der Fälle zufällige Daten anstelle von echten Berichten gesendet werden.
- Zusammenfassungsberichte sind nicht an ein bestimmtes Ereignis auf Anzeigenseite gebunden. Diese Berichte bieten detailliertere Conversion-Daten und können Klick- und Aufrufdaten flexibel mit Conversion-Daten zusammenführen.
Welche Daten erfasst werden, hängt von der Auswahl des Berichts ab.
Sie können sich das Endergebnis auch als Input für die Tools vorstellen, mit denen Sie Entscheidungen treffen. 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.
Sobald Sie entschieden haben, was Sie messen möchten, können Sie die Attribution Reporting API clientseitig einrichten.
Website-zu-Browser-Kommunikation
![Attributionsquellen auf der Website eines Publishers sind mit Triggern auf der Website eines Werbetreibenden verbunden.](https://developers.google.cn/static/privacy-sandbox/assets/images/attribution-sources-a-pu-b04d5ed143672.png?authuser=6&hl=de)
Ablauf von Attributionsereignissen
Stellen Sie sich eine Publisher-Website vor, auf der Anzeigen erscheinen. Jeder Werbetreibende oder Anbieter von Anzeigentechnologien möchte mehr über die Interaktionen mit seinen Anzeigen erfahren und Conversions der richtigen Anzeige zuordnen. Berichte (sowohl auf Ereignisebene als auch auf aggregierbar) werden wie folgt generiert:
Auf der Publisher-Website wird ein Anzeigenelement (
<a>
- oder<img>
-Tag) mit einem speziellen Attributattributionsrc
konfiguriert. Der Wert ist eine URL, z. B.https://adtech.example/register-source/ad_id=...
.Hier ein Beispiel für einen Link, mit dem nach dem Anklicken eine Quelle registriert wird:
<a href="https://shoes.example/landing" attributionsrc="http://adtech.example/register-source?..." target="_blank"> Click me</a>
Hier ein Beispiel für ein Bild, das beim Betrachten eine Registrierung einer Quelle verursacht:
<img href="https://advertiser.example/landing" attributionsrc="https://adtech.example/register-source?..."/>
Anstelle von HTML-Elementen können auch JavaScript-Aufrufe verwendet werden.
Hier ein JavaScript-Beispiel mit
window.open()
. Beachten Sie, dass die URL URL-codiert ist, um Probleme mit Sonderzeichen zu vermeiden.const encodedUrl = encodeURIComponent( 'https://adtech.example/attribution_source?ad_id=...'); window.open( "https://shoes.example/landing", "_blank", attributionsrc=${encodedUrl});
- Wenn der Nutzer auf die Anzeige klickt oder sie ansieht, sendet der Browser eine
GET
-Anfrage anattributionsrc
. Das ist normalerweise der Endpunkt eines Werbetreibenden oder eines Anzeigentechnologie-Anbieters. Nach Erhalt dieser Anfrage beschließt der Werbetreibende oder Anzeigentechnologie-Anbieter, den Browser anzuweisen, für Interaktionen mit der Anzeige Quellereignisse zu registrieren, damit Conversions später dieser Anzeige zugeordnet werden können. Dazu fügt der Werbetreibende oder der Anbieter von Anzeigentechnologien in die Antwort einen speziellen HTTP-Header ein. An diese Header werden benutzerdefinierte Daten angehängt, die Informationen zum Quellereignis enthalten (Anzeigenklick oder -aufruf). Wenn für diese Anzeige eine Conversion erfolgt, werden diese benutzerdefinierten Daten schließlich im Attributionsbericht berücksichtigt.
Später besucht der Nutzer die Website des Werbetreibenden.
Auf jeder relevanten Seite der Website des Werbetreibenden – z. B. auf einer Kaufbestätigungsseite oder einer Produktseite – sendet ein Conversion-Pixel (
<img>
-Element) oder ein JavaScript-Aufruf eine Anfrage anhttps://adtech.example/conversion?param1=...¶m2=...
.Die Anfrage wird an den Dienst unter dieser URL gesendet, in der Regel der Werbetreibende oder der Anbieter von Anzeigentechnologien. Diese Aktion wird als Conversion kategorisiert. Daher muss der Browser angewiesen werden, eine Conversion zu erfassen, also eine Attribution auszulösen. Dazu fügt der Werbetreibende oder der Anbieter von Anzeigentechnologien in die Antwort auf die Pixelanfrage einen speziellen HTTP-Header ein, der benutzerdefinierte Daten zur Conversion enthält.
Der Browser auf dem lokalen Gerät des Nutzers erhält diese Antwort und gleicht die Conversion-Daten mit dem ursprünglichen Quellereignis ab (Anzeigenklick oder Anzeigenaufruf). Weitere Informationen finden Sie unter Quellen mit Triggern abgleichen.
Der Browser plant, dass ein Bericht an
attributionsrc
gesendet wird. Dieser Bericht umfasst:- Die Konfigurationsdaten für die benutzerdefinierte Attribution, die der Anzeigentechnologie-Anbieter oder der Werbetreibende in Schritt 3 an das Quellereignis angehängt hat.
- Der benutzerdefinierte Conversion-Datensatz in Schritt 6.
Später sendet der Browser die Berichte mit einer gewissen Verzögerung an den in
attributionsrc
definierten Endpunkt. Aggregierbare Berichte sind verschlüsselt, Berichte auf Ereignisebene hingegen nicht.
Trigger für die Attribution (Website des Werbetreibenden)
Der Attributionstrigger ist das Ereignis, das den Browser auffordert, Conversions zu erfassen.
Wir empfehlen, die Conversions zu erfassen, die für den Werbetreibenden am wichtigsten sind, z. B. Käufe. In Zusammenfassungsberichten können mehrere Conversion-Typen und Metadaten erfasst werden.
Dadurch wird sichergestellt, dass die zusammengefassten Ergebnisse für diese Ereignisse detailliert und genau sind.
Quellen mit Triggern abgleichen
Wenn ein Browser eine Antwort zum Attributionstrigger erhält, greift er auf den lokalen Speicher zu, um eine Quelle zu finden, die sowohl mit dem Ursprung des Attributionstrigger als auch mit der URL eTLD+1 dieser Seiten-URL übereinstimmt.
Wenn der Browser beispielsweise am shoes.example/shoes123
einen Attributionstrigger von adtech.example
empfängt, sucht er im lokalen Speicher nach einer Quelle, die sowohl mit adtech.example
als auch mit shoes.example
übereinstimmt.
Sie können Filter (oder benutzerdefinierte Regeln) festlegen, um zu bestimmen, wann ein Trigger einer bestimmten Quelle zugeordnet wird. Sie können beispielsweise einen Filter so einrichten, dass nur Conversions für eine bestimmte Produktkategorie gezählt und alle anderen Kategorien ignoriert werden. Filter und Priorisierungsmodelle ermöglichen erweiterte Attributionsberichte.
Wenn im lokalen Speicher mehrere Attributionsquellen gefunden werden, wählt der Browser die zuletzt gespeicherte Quelle aus. In einigen Fällen, in denen Attributionsquellen eine Priorität zugewiesen wird, wählt der Browser die Quelle mit der höchsten Priorität aus.
Datenerhebung
Zusammen wird ein Attributionstrigger, der einer entsprechenden Quelle zugeordnet ist, vom Browser als Bericht an einen Berichtsendpunkt auf einem AdTech-Server gesendet, der manchmal auch als Sammlungsendpunkt oder Sammlungsdienst bezeichnet wird. Diese Berichte können Berichte auf Ereignisebene oder aggregierte Berichte sein.
Zusammengefasste Berichte werden verwendet, um Zusammenfassungsberichte zu erstellen. Ein aggregierbarer Bericht ist eine Kombination aus Daten, die aus der Anzeige (auf der Website eines Publishers) und Conversion-Daten (von der Website des Werbetreibenden) erfasst werden. Sie werden vom Browser auf dem Gerät eines Nutzers generiert und verschlüsselt, bevor sie von der Anzeigentechnologie erfasst werden.
Berichte auf Ereignisebene sind mit einer Verzögerung von 2 bis 30 Tagen verfügbar. Aggregierbare Berichte werden mit einer zufälligen Verzögerung innerhalb einer Stunde gesendet. Die Ereignisse müssen innerhalb des Beitragsbudgets liegen. Diese Optionen schützen die Privatsphäre und verhindern, dass die Aktivitäten einzelner Nutzer ausgenutzt werden.
Wenn Sie nur an Berichten auf Ereignisebene interessiert sind, ist dies der letzte Teil der Infrastruktur, den Sie benötigen. Wenn Sie jedoch Zusammenfassungsberichte generieren möchten, müssen Sie die aggregierbaren Berichte mit einem zusätzlichen Dienst verarbeiten.
Zusammenfassungsbericht erstellen
Für die Verarbeitung der zusammenfassenden Berichte verwenden Sie den von der AdTech betriebenen Aggregationsdienst. Um die Privatsphäre der Nutzer zu schützen, fügt der Aggregation Service Rauschen hinzu und gibt den endgültigen zusammenfassenden Bericht zurück.
![Aggregierbare Berichte werden erfasst, in Batches zusammengefasst und an die AdTech-Umgebung gesendet.](https://developers.google.cn/static/privacy-sandbox/assets/images/aggregatable-reports-are-a0830fd543e6f.png?authuser=6&hl=de)
Nach der Batchverarbeitung der erfassten aggregierten Berichte wird der Batch vom Aggregationsdienst verarbeitet. Ein Koordinator gibt die Entschlüsselungsschlüssel nur an attestierte Versionen des Aggregationsdienstes zu. Der Aggregationsdienst entschlüsselt die Daten, aggregiert sie und fügt Rauschen hinzu, bevor die Ergebnisse als zusammenfassender Bericht zurückgegeben werden.
Batchbasierte aggregierte Berichte
Bevor die aggregierbaren Berichte verarbeitet werden können, müssen sie im Batch zusammengefasst werden. Ein Batch besteht aus strategisch gruppierten, aggregierbaren Berichten. Ihre Strategie wird höchstwahrscheinlich einen bestimmten Zeitraum (z. B. täglich oder wöchentlich) widerspiegeln. Dies kann auf demselben Server stattfinden, der Sie als Endpunkt für die Berichterstellung verwenden.
Batches sollten viele Berichte enthalten, um sicherzustellen, dass das Signal-Rausch-Verhältnis hoch ist.
![Längere Zeiträume führen zu weniger verrauschten Ergebnissen.](https://developers.google.cn/static/privacy-sandbox/assets/images/larger-periods-lead-les-4d4edffb3d2d6.png?authuser=6&hl=de)
Batchzeiträume können sich jederzeit ändern, um bestimmte Ereignisse zu erfassen, bei denen Sie ein höheres Volumen erwarten, z. B. einen jährlichen Schlussverkauf. Der Batchverarbeitungszeitraum kann geändert werden, ohne dass die Attributionsquellen oder Trigger geändert werden müssen.
Aggregationsdienst
Der Aggregation Service ist für die Verarbeitung aggregierter Berichte zuständig, um einen zusammenfassenden Bericht zu generieren. Aggregierbare Berichte sind verschlüsselt und können nur vom Aggregationsdienst gelesen werden, der in einer vertrauenswürdigen Ausführungsumgebung (Trusted Execution Environment, TEE) ausgeführt wird.
Der Aggregation Service fordert vom Koordinator Entschlüsselungsschlüssel an, um die Daten zu entschlüsseln und zu aggregieren. Nach der Entschlüsselung und Zusammenfassung werden die Ergebnisse aus Datenschutzgründen verrauscht und in einem zusammenfassenden Bericht zurückgegeben.
Anwender können aggregierte Klartextberichte generieren, um den Aggregationsdienst lokal zu testen. Alternativ können Sie mit Nitro Enclaves mit verschlüsselten Berichten in AWS testen.
Nächste Schritte
Daher möchten wir in Gesprächen mit Ihnen sicherstellen, dass unsere API für alle funktioniert.
Über die API diskutieren
Wie andere Privacy Sandbox APIs wird auch diese API dokumentiert und öffentlich diskutiert.
Mit der API experimentieren
Sie können die Attribution Reporting API experimentieren und sich an Diskussionen beteiligen.