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 Anzeigentechnologie-Anbieter und Werbetreibende messen, ein Anzeigenklick oder der Aufruf führt zu einer Conversion, z. B. einem Kauf. Diese API basiert auf eine Kombination aus clientseitigen und serverseitigen Integrationen, abhängig von Geschäftsanforderungen.

Bevor du fortfährst, solltest du die Übersicht über Attributionsberichte So können Sie den Zweck der API und den Fluss der verschiedenen Ausgabeberichte besser verstehen. (Bericht auf Ereignisebene und Zusammenfassungsberichte). Wenn Sie auf unbekannte Begriffe stoßen, sehen Sie in der Glossar zur Privacy Sandbox

An wen richtet sich dieser Artikel?

Dieser Artikel sollte in folgenden Fällen gelesen werden:

Sie sind der technische Entscheidungsträger eines AdTech-Werbetreibenden oder eines Werbetreibenden. Sie dürfen arbeiten in Operations, DevOps, Data Science, IT, Marketing oder einer anderen Rolle, Entscheidungen zur technischen Implementierung treffen. Sie fragen sich, wie die APIs für datenschutzfreundliche Messungen funktionieren.
Sie sind technische Fachkraft (z. B. Entwickler, Systembetreiber, Systemarchitekt oder Data Scientist), der Experimente mit API- und Aggregationsdienst-Umgebung.

In diesem Artikel erhalten Sie eine allgemeine für die Attribution Reporting API. Wenn Sie technisch versiert sind, können Sie mit dieser API experimentieren lokal.

Übersicht

Die Attribution Reporting API besteht aus vielen Diensten, für die spezifische sowie clientseitige Konfigurationen und Serverbereitstellungen. Um zu ermitteln, die Sie brauchen:

Designentscheidungen treffen: Legen Sie fest, welche Informationen erfasst werden sollen, bestimmen Sie, welche Conversions Sie von einer bestimmten Kampagne erwarten, und legen Sie fest, welche Berichtstypen erfasst werden sollen. Das endgültige Ergebnis ist einer oder beide der beiden Berichtstypen: Berichte auf Ereignisebene und Zusammenfassungsberichte.

Es gibt immer zwei (und manchmal auch drei) Komponenten, die bei der Berichterstellung ineinandergreifen:

Kommunikation von Website zu Browser In Cookie-basierten Systemen werden Informationen zu Conversions und Anzeigeninteraktionen die an eine Kennung angehängt ist, mit der Sie oder ein Analysedienst später noch einmal ansehen. Bei dieser API ordnet der Browser Conversions den Anzeigenklicks bzw. -aufrufe, basierend auf Ihren Anweisungen, bevor sie für Analyse. Der Code für das Anzeigen-Rendering und das Conversion-Tracking müssen daher folgende Anforderungen erfüllen: <ph type="x-smartling-placeholder">
- Dem Browser mitteilen, welche Conversions welcher Anzeige zugeordnet werden sollen Klicks oder Impressionen.
- Signalisieren Sie alle anderen Daten, die in die endgültigen Berichte aufgenommen werden sollen.
Datenerhebung: Sie benötigen einen Collector-Endpunkt, um die Berichte erhalten, generiert in der Browser. Die Ausgabe der Browser Dieser Bericht kann einer von zwei möglichen Berichten sein: Berichte auf Ereignisebene und Berichte auf Ebene der Aggregation. Berichte (die verschlüsselt sind und zum Generieren von Zusammenfassungsberichten verwendet werden).

Wenn Sie aggregierte Berichte erstellt haben, benötigen Sie eine dritte Komponente:

Zusammenfassungsbericht erstellen: Stapel aggregierte Berichte und verarbeiten sie mit dem Zusammenfassungsdienst. um einen Zusammenfassungsbericht zu erstellen.

Designentscheidungen

Ein Grundprinzip der Attributionsberichte sind frühe Designentscheidungen. Sie entscheiden welche Daten in welchen Kategorien gesammelt und wie häufig diese verarbeitet werden sollten Daten. Die Ausgabeberichte liefern Informationen zu Ihren Kampagnen oder Ihrem Unternehmen.

Der Ausgabebericht kann so aussehen:

In Berichten auf Ereignisebene werden ein bestimmter Anzeigenklick oder eine bestimmte Anzeigenansicht (auf der Anzeigenseite) mit Daten auf der Conversion-Seite verknüpft. Um die Privatsphäre der Nutzer zu wahren, indem die Zusammenführung der Nutzeridentität über Websites hinweg eingeschränkt wird, sind die Daten auf der Conversion-Seite sehr begrenzt und die Daten sind ungenau. Das bedeutet, dass in einigen wenigen Fällen zufällige Daten anstelle von echten Berichten gesendet werden.
Zusammenfassungsberichte sind nicht an ein bestimmtes Ereignis auf der 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 Berichtsauswahl ab.

Sie können sich das Endergebnis auch als eine Eingabe für die Tools vorstellen, die Sie zur Entscheidungen zu treffen. Wenn Sie z. B. Zusammenfassungsberichte erstellen, um zu bestimmen, viele Conversions zu einem bestimmten Ausgabenwert geführt haben. Das kann Ihrem Team bei der Entscheidung helfen, worauf die nächste Werbekampagne ausgerichtet sein sollte, um höhere Gesamtausgaben zu erzielen.

Sobald Sie entschieden haben, was gemessen werden soll, können Sie die clientseitige für die Attribution Reporting API.

Kommunikation zwischen Website und Browser

Attributionsquellen auf der Website eines Publishers stellen eine Verbindung zu Triggern auf der Website eines Werbetreibenden her.

Ablauf von Attributionsereignissen

Angenommen, eine Publisher-Website enthält Anzeigen. 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 aggregierte Berichte) werden wie folgt generiert:

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

Hier ein Beispiel für einen Link, über den eine Quelle registriert wird, nachdem darauf geklickt wurde:
```
<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 Ansehen zur Registrierung einer Quelle führt:
```
<img href="https://advertiser.example/landing" 
  attributionsrc="https://adtech.example/register-source?..."/>
```
Anstelle von HTML-Elementen können alternativ 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 ansieht, sendet der Browser eine GET-Anfrage an attributionsrc. Das ist in der Regel der Endpunkt eines Werbetreibenden oder Anzeigentechnologie-Anbieters.
Nach Erhalt dieser Anfrage beschließt der Werbetreibende oder Anzeigentechnologie-Anbieter, den Browser anzuweisen, Quellereignisse für Interaktionen mit der Anzeige zu registrieren, damit Conversions dieser Anzeige später zugeordnet werden können. Dazu fügt der Werbetreibende oder Anzeigentechnologie-Anbieter in seiner Antwort einen speziellen HTTP-Header ein. Sie wird an diese benutzerdefinierten Header-Daten angehängt, die Informationen zum Quellereignis (dem Anzeigenklick oder dem Anzeigenaufruf) enthalten. Wenn für diese Anzeige eine Conversion stattfindet, sind diese benutzerdefinierten Daten letztendlich im Attributionsbericht zu sehen.
Später besucht der Nutzer die Website des Werbetreibenden.
Auf jeder relevanten Seite der Website des Werbetreibenden, z. B. auf einer Kaufbestätigungsseite oder auf einer Produktseite, wird durch ein Conversion-Pixel (<img>-Element) oder ein JavaScript-Aufruf eine Anfrage an https://adtech.example/conversion?param1=...&param2=... gesendet.
Die Anfrage geht an den Dienst unter dieser URL – in der Regel der Werbetreibende oder Anbieter von Anzeigentechnologien. Dies wird dann als Conversion kategorisiert. Daher muss der Browser angewiesen werden, eine Conversion zu erfassen, also eine Attribution auszulösen. Dazu fügt der Werbetreibende oder Anzeigentechnologie-Anbieter in seine 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 Aufruf). Weitere Informationen
Der Browser plant, dass ein Bericht an attributionsrc gesendet wird. Dieser Bericht enthält:
1. Die Konfigurationsdaten für die benutzerdefinierte Attribution, die der Anzeigentechnologie-Anbieter oder der Werbetreibende an das Quellereignis in Schritt 3 angehängt hat.
2. Der benutzerdefinierte Conversion-Datensatz in Schritt 6
Später sendet der Browser die Berichte an den in attributionsrc definierten Endpunkt, allerdings mit einer gewissen Verzögerung und Störfaktoren. Aggregierte Berichte sind verschlüsselt, Berichte auf Ereignisebene hingegen nicht.

Attributionsauslöser (Website des Werbetreibenden)

Attributionstrigger ist das Ereignis, das den Browser anweist, Conversions zu erfassen.

Wir empfehlen, die Conversions zu erfassen, die für die Kampagne wie z. B. Käufe. Es können mehrere Conversion-Typen und Metadaten die in zusammenfassenden Berichten erfasst werden.

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

Quellen mit Triggern abgleichen

Wenn ein Browser eine Trigger-Antwort für die Attribution empfängt, greift er auf des lokalen Speichers, um eine Quelle zu finden, die mit den Werten und der URL dieser Seite eTLD+1:

Wenn der Browser beispielsweise einen Attributionstrigger von adtech.example unter shoes.example/shoes123 sucht der Browser nach einer Quelle in lokalen Speicher, der sowohl mit adtech.example als auch mit shoes.example übereinstimmt.

Filter (oder benutzerdefinierte Regeln) können festgelegt werden, um zu bestimmen, wann ein Trigger übereinstimmt. an eine bestimmte Quelle senden. Stellen Sie beispielsweise einen Filter so ein, dass nur Conversions für eine eine bestimmte Produktkategorie aus. Alle anderen Kategorien werden ignoriert. Filter und Priorisierungsmodelle ermöglichen erweiterte Attributionsberichte.

Wenn im lokalen Speicher mehrere Attributionsquellen gefunden werden, wählt der Browser die zuletzt gespeicherte. In einigen Fällen, in denen Attributionsquellen Priorität zugewiesen wird, wählt der Browser die Quelle mit der höchsten Priorität Priorität haben.

Datenerfassung

Ein Attributionstrigger, der einer entsprechenden Quelle zugeordnet ist, wird zusammen als Bericht vom Browser an einen Berichtsendpunkt auf einem werbetechnologieeigenen Server (manchmal auch als Sammlungsendpunkt oder Sammlungsdienst bezeichnet). Diese Berichte können Berichte auf Ereignisebene oder aggregierte Berichte sein.

Zusammengefasste Berichte zur Erstellung von Zusammenfassungsberichten verwendet. Ein aggregierter Bericht ist eine Kombination der über die Anzeige (auf der Website eines Publishers) gesammelten Daten und Conversion-Daten (von Website des Werbetreibenden), die vom Browser auf einem bevor sie von der Anzeigentechnologie erfasst werden.

Berichte auf Ereignisebene verzögern sich um zwei bis 30 Tage. Aggregierte Berichte sind mit einer zufälligen Verzögerung innerhalb einer Stunde gesendet werden, und die Ereignisse müssen Beitragsbudget. Diese Einstellungen schützen die Privatsphäre und verhindern, dass die Handlungen einzelner Nutzer ausgenutzt werden.

Wenn Sie sich nur für Berichte auf Ereignisebene interessieren, ist dies die Sie brauchen. Wenn Sie jedoch zusammenfassende Berichte müssen Sie die aggregierbaren Berichte mit einem zusätzlichen Dienst verarbeiten.

Zusammenfassungsbericht erstellen

Zur Erstellung von zusammenfassenden Berichten verwenden Sie die Methode Aggregationsdienst (bereitgestellt vom AdTech-Team), um die aggregierbaren Berichte zu verarbeiten. Die Aggregation Der Dienst fügt Rauschen hinzu, um die Privatsphäre der Nutzer zu schützen, und gibt den endgültigen zusammenfassenden Bericht zurück.

Aggregierte Berichte werden gesammelt, in Batches zusammengefasst und an die Anzeigentechnologie-Umgebung gesendet. — Dieses Diagramm stellt den asynchronen Ablauf dar, Daten vom Endpunkt der Datenerfassung, Batch-Erstellung von Berichten, Datenverarbeitung im Aggregationsdienst von Anzeigentechnologie.

Nach der Zusammenstellung der gesammelten, aggregierten Berichte wird der Batch verarbeitet. vom Zusammenfassungsdienst aus. A Koordinator gibt die Entschlüsselungsschlüssel nur für attestierte Versionen der Aggregation Dienst. Der Aggregationsdienst entschlüsselt die Daten, und fügen Rauschen hinzu, bevor die Ergebnisse als zusammenfassender Bericht zurückgegeben werden.

Aggregierbare Batch-Berichte

Bevor die aggregierbaren Berichte verarbeitet werden, müssen sie in Batches zusammengefasst werden. Ein Batch besteht aus strategisch gruppierten, aggregierten Berichten. Mit Ihrer Strategie wahrscheinlich einen bestimmten Zeitraum widerspiegeln (z. B. täglich oder wöchentlich). Dieses kann auf demselben Server stattfinden, der als Endpunkt für die Berichterstellung fungiert.

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

Längere Zeiträume führen zu weniger ungenauen Ergebnissen. — Vergleiche die Wartezeit von 1 Tag und 1 Woche. In 1 Stunde erhalten Sie einen kleineren Zusammenfassungswert mit wahrscheinlich ungenaueren Ergebnissen. An einem Tag haben Sie dann einen größeren Zusammenfassungswert, sodass er wahrscheinlich weniger laut ist.

Batchzeiträume können sich jederzeit ändern, um bestimmte Ereignisse zu erfassen wo Sie ein höheres Volumen erwarten, z. B. bei einem jährlichen Schlussverkauf. Batchverarbeitungszeitraum können ohne Änderung der Attributionsquellen oder Trigger geändert werden.

Zusammenfassungsdienst

Der Aggregationsdienst ist für die Verarbeitung aggregierter Berichte zuständig, einen zusammenfassenden Bericht zu erstellen. Aggregierte Berichte sind verschlüsselt und können vom Aggregationsdienst gelesen, der in einer vertrauenswürdigen Ausführungsumgebung ausgeführt wird (TEE)

Der Aggregation Service fordert Entschlüsselungsschlüssel vom Koordinator an. um die Daten zu entschlüsseln und zu aggregieren. Nach der Entschlüsselung und Aggregierung werden verrauscht, um die Privatsphäre zu schützen, und werden als zusammenfassender Bericht zurückgegeben.

Sie können aggregierte Klartextberichte erstellen, Aggregationsdienst lokal testen Alternativ können Sie mit verschlüsselten Berichten in AWS und Nitro Enclaves Tests durchführen.

Nächste Schritte

Wir möchten mit Ihnen ins Gespräch kommen, 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 öffentlich diskutiert werden.

Mit der API experimentieren

Experimentieren und teilnehmen im Gespräch über die Attribution Reporting API.