Diese Seite wurde von der Cloud Translation API übersetzt.

Attributionsberichte: Vollständige Systemübersicht

Allgemeiner Überblick über verbundene Dienste für Attribution Reporting für technische Entscheidungsträger.

Mit der Attribution Reporting API können Anbieter von Anzeigentechnologien und Werbetreibende erfassen, wann ein Anzeigenklick oder -aufruf zu einer Conversion führt, z. B. einem Kauf. Diese API basiert auf einer Kombination aus client- und serverseitigen Integrationen, je nach Ihren Geschäftsanforderungen.

Lesen Sie die Übersicht zum Attribution Reporting, bevor Sie fortfahren. So können Sie den Zweck der API und den Ablauf der verschiedenen Ausgabedaten besser nachvollziehen (Bericht auf Ereignisebene und Zusammenfassungsberichte). Wenn Sie auf unbekannte Begriffe stoßen, können Sie im Privacy Sandbox-Glossar nachschlagen.

An wen richtet sich dieses Dokument?

Lesen Sie dieses Dokument, wenn:

Sie sind der technische Entscheidungsträger eines Anzeigentechnologie-Anbieters oder Werbetreibenden. Sie arbeiten möglicherweise in den Bereichen Betrieb, DevOps, Data Science, IT oder Marketing oder in einer anderen Funktion, in der Sie Entscheidungen zur technischen Implementierung treffen. Sie möchten wissen, wie die APIs für datenschutzfreundliche Analysen funktionieren.
Sie sind ein technischer Experte (z. B. Entwickler, Systembetreiber, Systemarchitekt oder Data Scientist), der mit dieser API und der Aggregationsdienstumgebung Experimente einrichtet.

In diesem Dokument finden Sie eine allgemeine, umfassende Beschreibung der Funktionsweise der Dienste für die Attribution Reporting API. Wenn Sie ein technischer Experte sind, können Sie lokal mit dieser API experimentieren.

Übersicht

Die Attribution Reporting API besteht aus vielen Diensten, für die eine bestimmte Einrichtung, clientseitige Konfigurationen und Serverbereitstellungen erforderlich sind. So ermitteln Sie, was Sie benötigen:

Designentscheidungen treffen: Legen Sie fest, welche Informationen Sie erfassen möchten, welche Conversions Sie von einer bestimmten Kampagne erwarten und welchen Berichtstyp Sie erfassen möchten. Die endgültige Ausgabe ist einer oder beide der beiden Berichtstypen: Berichte auf Ereignisebene und Zusammenfassungsberichte.

Für die Berichterstellung sind immer zwei (und manchmal drei) Komponenten erforderlich:

Website-Browser-Kommunikation: In cookiebasierten Systemen werden Informationen zu Conversions und Anzeigeninteraktionen an eine Kennung angehängt, mit der Sie oder ein Analysedienst diese Ereignisse später zusammenführen können. Mit dieser API ordnet der Browser Conversions anhand Ihrer Anweisungen Anzeigenklicks/-impressionen zu, bevor die Daten zur Analyse bereitgestellt werden. Daher müssen Ihr Code für die Anzeigendarstellung und Ihr Conversion-Tracking Folgendes erfüllen:
- Dem Browser mitteilen, welche Conversions welchen Anzeigenklicks oder ‑impressionen zugeordnet werden sollen.
- Geben Sie an, welche anderen Daten in die endgültigen Berichte aufgenommen werden sollen.
Datenerhebung: Sie benötigen einen Collector-Endpunkt, um die in den Browsern der Nutzer generierten Berichte zu empfangen. Die Ausgabe von Browsern kann einer von zwei möglichen Berichten sein: Berichte auf Ereignisebene und aggregierbare Berichte (die verschlüsselt sind und zum Generieren von Zusammenfassungsberichten verwendet werden).

Wenn Sie aggregierbare Berichte erhoben haben, benötigen Sie eine dritte Komponente:

Zusammenfassungsberichte erstellen: Fassen Sie aggregierbare Berichte zusammen und verwenden Sie den Aggregationsdienst, um die Berichte zu verarbeiten und einen Zusammenfassungsbericht zu erstellen.

Designentscheidungen

Ein wichtiger Grundsatz von Attribution Reporting sind frühe Designentscheidungen. Sie entscheiden, welche Daten in welchen Kategorien erhoben werden und wie oft diese Daten verarbeitet werden. Die Ausgabedaten liefern Informationen zu Ihren Kampagnen oder Ihrem Unternehmen.

Der Ausgabebereicht kann Folgendes sein:

In Berichten auf Ereignisebene wird ein bestimmter Anzeigenklick oder ‑aufruf (auf der Anzeigenseite) mit Daten auf der Conversion-Seite verknüpft. Um die Privatsphäre der Nutzer zu schützen, indem die Verknüpfung von Nutzeridentitäten über Websites hinweg eingeschränkt wird, sind die Daten auf Conversion-Seite sehr begrenzt und verrauscht. 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 der Anzeigenseite gebunden. Diese Berichte enthalten detailliertere Conversion-Daten und bieten mehr Flexibilität beim Zusammenführen von Klick- und Ansichtsdaten mit Conversion-Daten.

Die Auswahl des Berichts bestimmt, welche Daten Sie erheben müssen.

Sie können sich die endgültige Ausgabe auch als Eingabe für die Tools vorstellen, mit denen Sie Entscheidungen treffen. Wenn Sie beispielsweise Übersichtsberichte erstellen, um zu ermitteln, wie viele Conversions zu einem bestimmten Gesamtausgabenwert geführt haben, kann Ihr Team leichter entscheiden, worauf sich die nächste Werbekampagne konzentrieren sollte, um höhere Gesamtausgaben zu erzielen.

Nachdem Sie entschieden haben, was Sie messen möchten, können Sie die clientseitige Einrichtung für die Attribution Reporting API vornehmen.

Kommunikation zwischen Website und Browser

Attributionsquellen auf der Website eines Publishers werden mit Triggern auf der Website eines Werbetreibenden verknüpft.

Attributionsereignisfluss

Stellen Sie sich eine Publisher-Website vor, auf der Anzeigen ausgeliefert werden. Jeder Werbetreibende oder Anzeigentechnologie-Anbieter möchte mehr über Interaktionen mit seinen Anzeigen erfahren und Conversions der richtigen Anzeige zuordnen. Berichte (sowohl auf Ereignisebene als auch aggregierbar) würden so generiert:

Auf der Publisher-Website wird ein Anzeigenelement (<a>- oder <img>-Tag) mit dem speziellen Attribut attributionsrc konfiguriert. Sein Wert ist eine URL, z. B. https://adtech.example/register-source/ad_id=....

Hier ist ein Beispiel für einen Link, mit dem eine Quelle registriert wird, wenn darauf geklickt wird:
```
<a href="https://shoes.example/landing"
  attributionsrc="http://adtech.example/register-source?..."
  target="_blank">
Click me</a>
```
Hier ist ein Beispiel für ein Bild, das bei der Anzeige die Registrierung einer Quelle auslöst:
```
<img href="https://advertiser.example/landing"
  attributionsrc="https://adtech.example/register-source?..."/>
```
Alternativ können anstelle von HTML-Elementen auch JavaScript-Aufrufe verwendet werden.

Hier ein JavaScript-Beispiel mit window.open(): Die URL ist URL-codiert, 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 sich ansieht, sendet der Browser eine GET-Anfrage an attributionsrc, in der Regel an einen Endpunkt des Werbetreibenden oder Anzeigentechnologie-Anbieters.
Nach Erhalt dieser Anfrage weist der Werbetreibende oder AdTech-Anbieter den Browser an, Quellereignisse für Interaktionen mit der Anzeige zu registrieren, damit Conversions später dieser Anzeige zugeordnet werden können. Dazu fügt der Werbetreibende oder Ad-Tech-Anbieter seiner Antwort einen speziellen HTTP-Header hinzu. An diesen Header werden benutzerdefinierte Daten angehängt, die Informationen zum Quellereignis (Anzeigenklick oder ‑aufruf) enthalten. Wenn für diese Anzeige eine Conversion erfolgt, werden diese benutzerdefinierten Daten letztendlich im Attributionsbericht angezeigt.
Später besucht der Nutzer die Website des Werbetreibenden.
Auf jeder relevanten Seite der Website des Werbetreibenden, z. B. einer Kaufbestätigungsseite oder einer Produktseite, wird über ein Conversion-Pixel (<img>-Element) oder einen JavaScript-Aufruf eine Anfrage an https://adtech.example/conversion?param1=...&param2=... gesendet.
Der Dienst unter dieser URL, in der Regel der Werbetreibende oder der Anbieter von Anzeigentechnologie, empfängt die Anfrage. Sie entscheidet, dies als Conversion zu kategorisieren, und muss den Browser daher anweisen, eine Conversion aufzuzeichnen, d. h. eine Zuordnung auszulösen. Dazu fügt der Werbetreibende oder Ad-Tech-Anbieter in seine Antwort auf die Pixelanfrage einen speziellen HTTP-Header mit benutzerdefinierten Daten zur Conversion ein.
Der Browser auf dem Gerät des Nutzers empfängt diese Antwort und gleicht die Conversion-Daten mit dem ursprünglichen Quellereignis (Anzeigenklick oder ‑aufruf) ab.
Der Browser plant, einen Bericht an attributionsrc zu senden. Dieser Bericht enthält:
1. Die benutzerdefinierten Attributionskonfigurationsdaten, die der Ad-Tech-Anbieter oder Werbetreibende dem Quellereignis in Schritt 3 angehängt hat.
2. Der benutzerdefinierte Conversion-Datensatz in Schritt 6.
Das Diagramm zeigt die Elemente des Attribution Reporting-Triggers, der zu Berichten auf Ereignisebene und aggregierten Berichten führt.
Mit einer gewissen Verzögerung sendet der Browser dann die Berichte an den in attributionsrc definierten Endpunkt, wobei manchmal auch zufällige Daten anstelle echter Berichte gesendet werden. Zusammenfassbare Berichte sind verschlüsselt, Berichte auf Ereignisebene nicht.

Attributionstrigger (Website des Werbetreibenden)

Der Attributionstrigger ist das Ereignis, das dem Browser signalisiert, dass Conversions erfasst werden sollen.

Wir empfehlen, die für den Werbetreibenden wichtigsten Conversions zu erfassen, z. B. Käufe. In Übersichtsberichten können mehrere Conversion-Typen und ‑Metadaten erfasst werden.

So wird sichergestellt, dass die zusammengefassten Ergebnisse für diese Ereignisse detailliert und genau sind.

Quellen mit Triggern abgleichen

Wenn ein Browser eine Antwort auf einen Attributions-Trigger empfängt, greift er auf den lokalen Speicher zu, um eine Quelle zu finden, die sowohl mit dem Ursprung des Attributions-Triggers als auch mit dem eTLD+1 dieser Seiten-URL übereinstimmt.

Wenn der Browser beispielsweise einen Attributions-Trigger von adtech.example auf shoes.example/shoes123 empfängt, sucht er im lokalen Speicher nach einer Quelle, die sowohl adtech.example als auch shoes.example entspricht.

Mit Filtern (oder benutzerdefinierten Regeln) kann festgelegt werden, wann ein Trigger mit einer bestimmten Quelle übereinstimmt. Sie können beispielsweise einen Filter festlegen, um nur Conversions für eine bestimmte Produktkategorie zu zählen und alle anderen Kategorien zu ignorieren. Filter und Priorisierungsmodelle ermöglichen eine erweiterte Attributionsberichterstellung.

Wenn im lokalen Speicher mehrere Attributionsquellen gefunden werden, wählt der Browser die zuletzt gespeicherte 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.

Datenerfassung

Ein Attributions-Trigger, der mit einer entsprechenden Quelle übereinstimmt, wird vom Browser als Bericht an einen Berichtsendpunkt auf einem AdTech-Server gesendet (manchmal auch als Erfassungs- oder Sammelendpunkt bezeichnet). Diese Berichte können Berichte auf Ereignisebene oder aggregierbare Berichte sein.

Zusammenfassungsberichte werden verwendet, um Zusammenfassungsberichte zu erstellen. Ein aggregierbarer Bericht ist eine Kombination aus Daten, die über die Anzeige (auf der Website eines Publishers) erfasst werden, und Conversion-Daten (von der Website des Werbetreibenden). Er wird vom Browser auf dem Gerät eines Nutzers generiert und verschlüsselt, bevor er von der AdTech-Lösung erfasst wird.

Berichte auf Ereignisebene sind 2 bis 30 Tage verzögert. Zusammenfassbare Berichte werden mit einer zufälligen Verzögerung innerhalb einer Stunde gesendet und die Ereignisse müssen in das Beitragsbudget passen. Diese Optionen schützen die Privatsphäre und verhindern die Ausnutzung der Aktionen einzelner Nutzer.

Wenn Sie nur an Berichten auf Ereignisebene interessiert sind, ist dies das letzte Infrastrukturteil, das Sie benötigen. Wenn Sie jedoch Zusammenfassungsberichte erstellen möchten, müssen Sie die aggregierbaren Berichte mit einem zusätzlichen Dienst verarbeiten.

Erstellung von Zusammenfassungsberichten

Zum Generieren von Zusammenfassungsberichten verwenden Sie den Aggregationsdienst (betrieben von der Ad-Tech-Firma), um die aggregierbaren Berichte zu verarbeiten. Der Aggregationsdienst fügt Rauschen hinzu, um die Privatsphäre der Nutzer zu schützen, und gibt den endgültigen Zusammenfassungsbericht zurück.

Aggregierbare Berichte werden erfasst, in Batches zusammengefasst und an die AdTech-Umgebung gesendet. — In diesem Diagramm wird der asynchrone Datenfluss vom Erfassungs-Endpunkt über das Batching von Berichten bis hin zur Verarbeitung im Aggregationsdienst des Ad-Tech-Unternehmens dargestellt.

Nachdem die erfassten aggregierbaren Berichte in Batches zusammengefasst wurden, wird der Batch vom Aggregationsdienst verarbeitet. Ein Coordinator stellt die Entschlüsselungsschlüssel nur für bestätigte Versionen des Aggregation Service bereit. Der Aggregationsdienst entschlüsselt die Daten, aggregiert sie und fügt Rauschen hinzu, bevor er die Ergebnisse als Zusammenfassungsbericht zurückgibt.

Zusammengefasste aggregierbare Berichte

Bevor aggregierbare Berichte verarbeitet werden können, müssen sie in Batches zusammengefasst werden. Ein Batch besteht aus strategisch gruppierten aggregierbaren Berichten. Ihre Strategie bezieht sich höchstwahrscheinlich auf einen bestimmten Zeitraum, z. B. täglich oder wöchentlich. Dieser Prozess kann auf demselben Server stattfinden, der als Berichtsendpunkt dient.

Batches sollten viele Berichte enthalten, damit das Signal-Rausch-Verhältnis hoch ist.

Längere Zeiträume führen zu weniger verrauschten Ergebnissen. — Warten von einem Tag und einer Woche vergleichen. Nach einer Stunde haben Sie einen kleineren zusammenfassenden Wert mit wahrscheinlich mehr Rauschen. An einem Tag haben Sie einen größeren zusammengefassten Wert, der wahrscheinlich weniger verrauscht ist.

Batch-Zeiträume können jederzeit geändert werden, um bestimmte Ereignisse mit höherem Volumen zu erfassen, z. B. einen jährlichen Sale. Der Batching-Zeitraum kann geändert werden, ohne dass Attributionsquellen oder Trigger geändert werden müssen.

Zusammenfassungsdienst

Der Aggregationsdienst ist für die Verarbeitung aggregierbarer Berichte zuständig, um einen Zusammenfassungsbericht zu erstellen. Aggregierbare Berichte werden 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 Aggregationsdienst fordert Entschlüsselungsschlüssel vom Coordinator an, um die Daten zu entschlüsseln und zu aggregieren. Nachdem die Ergebnisse entschlüsselt und aggregiert wurden, wird Rauschen hinzugefügt, um die Privatsphäre zu schützen. Anschließend werden sie als Zusammenfassungsbericht zurückgegeben.

Praktiker können aggregierbare Klartextberichte generieren, um den Aggregationsdienst lokal zu testen. Alternativ können Sie verschlüsselte Berichte auf AWS mit Nitro Enclaves testen.

Nächste Schritte

Wir möchten uns mit Ihnen austauschen, um sicherzustellen, dass wir eine API entwickeln, die für alle funktioniert.

Über die API diskutieren

Wie andere Privacy Sandbox-APIs ist auch diese API dokumentiert und wird öffentlich diskutiert.

Mit der API experimentieren

Sie können Experimente durchführen und sich an Diskussionen zur Attribution Reporting API beteiligen.