Conversion-Analyse aktivieren

An der Conversion-Attribution können mehrere Parteien beteiligt sein, z. B. Publisher, Werbetreibende, Anzeigentechnologien (das Rechtssubjekt, das die Anzeige ausliefert) und Analyseanbieter. In diesem Dokument werden häufige Szenarien für die Conversion-Analyse veranschaulicht. Generell muss jeder, der einen Attributionsbericht von der Attribution Reporting API (ARA) erhalten möchte, die in diesem Dokument beschriebenen Integrationsschritte ausführen.

So ist es beispielsweise üblich, dass ein Publisher eine oder mehrere Anzeigentechnologien für die Anzeigenbereitstellung verwendet. Dazu gehören unter anderem die Parteien, die für die Bereitstellung des Markups für das Creative, das Impressions- oder Tracking-Pixel im Creative und das SDK oder Tag für die Anzeigenfläche auf der Publisher-Seite verantwortlich sind. Diese Anbieter von Anzeigentechnologien können Attributionsberichte von ARA erhalten oder nicht, sind aber in der Lage, dafür zu sorgen, dass nachgelagerte Anbieter von Anzeigentechnologien Attributionsberichte erhalten.

Außerdem kann der Werbetreibende einen Conversion-Analyseanbieter für die netzwerkübergreifende Attribution und andere Berichtsfunktionen verwenden. Werbetreibende nutzen diese Daten, um den Return on Advertising Investment (ROAS) für mehrere einzelne Publisher und Kanäle zu ermitteln. Daher ist es wichtig, dass DSPs oder Ad-Server wissen, wie sie die Attribution Reporting API aktivieren, um diese Anwendungsfälle zu unterstützen. Werbetreibende, die einen Drittanbieter verwenden möchten, können dies weiterhin tun. Sie können entweder einen Drittanbieter-Analyseanbieter nutzen oder einen internen Server einrichten, um Berichte über die API zu registrieren und zu empfangen.

Mit der Attribution Reporting API können mehrere Anzeigentechnologien Attributionsquellen und -trigger für dieselbe Impression oder Conversion registrieren und separate Berichte von der API erhalten. So kann eine DSP beispielsweise eigene Attributionsberichte von der Attribution Reporting API erhalten und gleichzeitig separate Berichte für den Drittanbieter für Messungen des Werbetreibenden zulassen. Ein AdTech-Anbieter muss sowohl Attributionsquellen als auch Trigger registrieren, um Berichte von der API zu erhalten. Die Attribution erfolgt dann anhand der Attributionsquellen und Trigger, die der AdTech-Anbieter einzeln bei der API registriert hat.

Häufige Szenarien für die Conversion-Analyse

In diesem Abschnitt werden zwei gängige Szenarien für die Conversion-Analyse untersucht.

Szenario 1: Sowohl die Anzeigentechnologie für die Anzeigenbereitstellung als auch der Analyseanbieter müssen Berichte von der Attribution Reporting API erhalten

Ein Werbetreibender möchte Conversions für Anzeigeninventar mithilfe eines Drittanbieters für Analysen zuordnen. Die Anzeigentechnologie, auf der das Creative gehostet wird, möchte Conversions für das Anzeigeninventar zuordnen. Das ist häufig bei DSPs oder Ad-Servern von Werbetreibenden (3rd-Party Ad Server, 3PAS) der Fall, die das Markup für Creatives bereitstellen, eigene Attributionsberichte erstellen und mit Werbetreibenden zusammenarbeiten, die Analyse- oder Messtools von Drittanbietern verwenden.

In diesem Fall ist die Anzeigentechnologie für die Auslieferung auch für das Auslösen von Klick- und Impressionsereignissen in der aktuellen Konfiguration verantwortlich. Die Anzeigentechnologie für die Auslieferung sollte die neue attributionsrc an geeigneten Stellen festlegen und dafür sorgen, dass die Weiterleitungen richtig konfiguriert sind. Außerdem müssen sowohl die AdTech-Plattform für die Anzeigenbereitstellung als auch der Drittanbieter für die Analyse dafür sorgen, dass sie registriert sind und ihre Server bereit sind, Attribution Reporting API-Anfragen zu empfangen und zu beantworten.

Eine typische Kampagneneinrichtung könnte so aussehen:

  1. Der Ad-Server des Werbetreibenden (3PAS) stellt der DSP das Markup für das Creative zur Verfügung. Dazu gehören die Impressions- und Klick-Tracking-Pixel des Drittanbieters für die Analyse. Der Ad-Server muss dafür sorgen, dass attributionsrc im Markup des Creatives enthalten ist.

  2. Die DSP bietet Funktionen zum Hinzufügen zusätzlicher Pixel für die Impressions- und Klick-Analyse. Außerdem muss darauf geachtet werden, dass attributionsrc im endgültigen Creative-Markup der Anzeige enthalten ist, für die Gebote abgegeben werden.

Szenario 2: Nur der Drittanbieter muss Berichte von der Attribution Reporting API erhalten

Ein Werbetreibender möchte Conversions für Anzeigeninventar mithilfe eines Analyseanbieters zuordnen. Die Anzeigentechnologie, auf der das Creative gehostet wird, hat jedoch keine Anforderungen an die Attributionsmessung. Das ist häufig der Fall bei Publishern, SSPs oder Publisher-Anzeigenservern, die Creatives hosten und die Attribution Reporting API entweder für ihre DSP-Partner oder für Anbieter von Analyse-Tagging wie Drittanbieter-Anzeigenserver, Analyse- oder Analyseanbieter aktivieren möchten, aber nicht selbst Attribution Reporting verwenden möchten.

In diesem Fall muss die Partei, die für das Auslösen von Klick- und Impressionsereignissen in der aktuellen Konfiguration verantwortlich ist, Creatives das neue attributionsrc-Attribut hinzufügen und dafür sorgen, dass Weiterleitungen wie vorgesehen funktionieren. Das hängt stark von der Integration des jeweiligen Publishers ab. Bei Klickereignissen kann es sich aber um die SSP, die Anzeigentechnologie oder den Publisher selbst handeln. Bei Impressionsereignissen ist das in der Regel der Drittanbieter für Analysen.

Im Beispiel für die typische Kampagneneinrichtung aus Szenario 1 muss der Ad-Server, die SSP oder der Publisher möglicherweise nur dafür sorgen, dass das von der DSP bereitgestellte attributionsrc-Attribut auf der Publisher-Seite zu sehen ist.

Implementierungsdetails

In der folgenden Tabelle werden die Schritte zur Implementierung der Attribution Reporting API allgemein beschrieben:

Schritte Verantwortung für die Arbeit Beispiele
Schritt 1: Attributionsquelle für vorhandene Creatives und Messcode aktivieren Das Attribut attributionsrc wird von der Entität hinzugefügt, die für das Auslösen von Impressionsereignissen oder das Verarbeiten von Klickereignissen verantwortlich ist. Bei Klickereignissen fügt in der Regel ein Käufer (DSP/Werbetreibender-Ad-Server), der das Creative rendert, das Attribut hinzu.

Bei Impressionsereignissen wird das Attribut von der Demand-Side-Plattform (DSP), der Supply-Side-Plattform (SSP), dem Publisher, dem Ad-Server oder einem Analyseanbieter hinzugefügt. Es hängt von der Konfiguration des Publishers ab.

Bei Videoanzeigen im VAST-Format fügen der Publisher und das Video-SDK das Attribut hinzu.
Schritt 2: Attributionsberichte für Drittanbieterquellen aktivieren Das funktioniert sofort, wenn Sie einen vorhandenen Weiterleitungspfad mit 302-Weiterleitungen verwenden.

Wenn 302-Weiterleitungen nicht verwendet werden können, können Sie mit dem Attribut attributionsrc mehrere Anzeigentechnologie-Server auflisten.

 Solange das Attribut attributionsrc dem Creative hinzugefügt wird, sollten die Weiterleitungen von Drittanbietern die Aufrufe der Attribution Reporting API erhalten.
Schritt 3: Antworten auf Attribution Reporting API-Anfragen einrichten Alle Rechtssubjekte, die Berichte von der Attribution Reporting API erhalten möchten Die DSP und der Analyseanbieter des Werbetreibenden

Die Details der einzelnen Schritte hängen davon ab, wie Creatives auf der Publisher-Seite gerendert und ausgeliefert werden und welche AdTech-Entitäten Berichte erhalten, die von der Attribution Reporting API gesendet werden.

Schritt 1: Attributionsquelle für vorhandene Creatives und Messcode aktivieren

Im ersten Schritt werden die Attributionsquellen aktiviert.

Funktionsweise des Attributs attributionsrc

Mit dem neuen Attribut attributionsrc wird angegeben, wohin die Attribution Reporting API-Anfragen gesendet werden. Die Entität, die für das Auslösen von Impressions- und Klickereignissen verantwortlich ist, muss Creatives mit dem Attribut attributionsrc aktualisieren. attributionsrc sollte vorhandenen Klick- und Impressionsereignissen hinzugefügt werden. Der Wert kann leer oder nicht leer sein.

Bei Klickereignissen mit Weiterleitungen sollte der Navigation das Attribut attributionsrc hinzugefügt werden. Für alle 302-Weiterleitungen nach der Navigation muss das Attribut attributionsrc nicht hinzugefügt werden. Sie kommen für die automatische Antwortberechtigung infrage, solange attributionsrc für die erste Navigation hinzugefügt wurde.

Wenn das Attribut attributionsrc leer ist, werden die ARA-Anfragen an die im Attribut href des Ankertags definierte URL (Klick-URL) gesendet. Wenn das attributionsrc-Attribut definiert ist, werden die ARA-Anfragen an die im attributionsrc-Attribut definierte URL gesendet. Auch die Klick-URL kann zum Registrieren von Quellen verwendet werden.

Verwenden Sie im Allgemeinen ein leeres attributionsrc-Attribut, wenn der Server, auf dem die Klick-URL gehostet wird, Attribution Reporting API-Anfragen empfangen und beantworten kann. Definieren Sie eine eigene attributionsrc-URL, wenn Attribution Reporting API-Anfragen an einen anderen Server gesendet werden sollen.

Beispiel für ein leeres attributionsrc-Attribut:

Vorhandene Einrichtung Mit ARA-Integration
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>

Wenn das Attribut attributionsrc leer ist, werden die Attribution Reporting API-Anfragen an die URL gesendet, die durch das Attribut href des Ankertags definiert ist.

Beispiel für ein nicht leeres attributionsrc-Attribut:

Vorhandene Einrichtung Mit ARA-Integration
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc="[ATTRIBUTION_SRC_URL]">...</a>

Wenn attributionsrc nicht leer ist, werden die Attribution Reporting API-Anfragen an die URL gesendet, die durch das attributionsrc-Tag definiert ist. Auch die Klick-URL kann zum Registrieren von Quellen verwendet werden.

attributionsrc für Klick- und Impressionsereignisse hinzufügen

  • Klickereignisse:
    • Die Entität, die für das Hinzufügen der attributionsrc verantwortlich ist, ist in der Regel die Anzeigentechnologie, über die die Anzeigen ausgeliefert werden.
    • Anker-Tags mit Klickereignissen müssen das Attribut attributionsrc enthalten.
    • Für Klicks mit window.open sollte das Argument windowFeatures des window.open-Aufrufs verwendet werden, um die Attributionsquelle anzugeben.
  • Impressionsereignisse:
    • Die Entität, die für das Hinzufügen der attributionsrc verantwortlich ist, ist in der Regel die Anzeigentechnologie für die Anzeigenbereitstellung und die Analyseanbieter.
    • Impressionsereignisse, die über das <img>-Tag oder das <script>-Tag ausgelöst werden, müssen das Attribut attributionsrc enthalten.
    • Impressionsereignisse, die mit der Fetch API gesendet werden, müssen im Argument options, das an den Fetch API-Aufruf übergeben wird, ein attributionReporting-Objekt enthalten.

In der folgenden Tabelle finden Sie eine Zusammenfassung der erforderlichen Änderungen für Klick- und Impressionsereignisse:

Ereignis Tag Vorhandene Einrichtung Nach der ARA-Integration
Klick HTML <a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>
JavaScript window.open("[CLICKTHROUGH_URL]", "_blank"); window.open("[CLICKTHROUGH_URL]", "_blank", "attributionsrc");
Impression HTML-<img>-Tag <img src="[IMPRESSION_URL]"> <img src="[IMPRESSION_URL]" attributionsrc>
HTML-<script>-Tag <script src="[IMPRESSION_URL]"></script> <script src="[IMPRESSION_URL]" attributionsrc></script>
JavaScript const options = {...}
window.fetch("[IMPRESSION_URL]", options); 		const options = {
  attributionReporting: {
    eventSourceEligible: true,
    triggerEligible: false,
  },
  ...
};
window.fetch("[IMPRESSION_URL]", options);

Registrierung der Attributionsquelle in einer Protected Audience-Auktion aktivieren

Wenn Sie Conversions in Auktionen mit geschützten Zielgruppen messen möchten, können Sie anstelle von attributionsrc registerAdBeacon/registerAdMacro und setReportEventDataForAutomaticBeacons/reportEvent verwenden, um Attributionsquellen zu registrieren.

Für Berichte zu Protected Audience-Signalen ist die Funktion registerAdBeacon in Berichts-Worklets verfügbar und registerAdMacro im Berichts-Worklet für Gebote des Käufers. Anschließend können die Ereignisdaten im Anzeigenframe mit den Funktionen reportEvent und setReportEventDataForAutomaticBeacons der Fenced Frame Ads Reporting API den registrierten Beacons und Makros hinzugefügt werden. So können die Signale der Protected Audience-Berichts-Worklets und die Payload des Creative-Frames-Ereignisses miteinander verknüpft werden.

Der Attribution-Reporting-Eligible-HTTP-Header wird der Anfrage hinzugefügt, wenn die Beacons und Makros durch den reportEvent-Aufruf aus einem Frame oder die automatischen Beacons durch den Browser ausgelöst werden. Sie können die Antwort des Beacons verwenden, um eine Attributionsquelle zu registrieren. Die Beacon-Anfragen können weitergeleitet werden, um die Analyse durch Drittanbieter zu ermöglichen.

Weitere Informationen finden Sie im Abschnitt Unterstützung für Attributionsberichte der Erläuterung zur Fenced Frame Ad Reporting API.

Attributionsberichte für VAST-Formate aktivieren

VAST ist ein gängiges Format für die Auslieferung und Analyse von Videoanzeigeninventar. Viele der in diesem Standard definierten Ereignisse sollten als potenzielle Quell-Ereignisse betrachtet werden, die für die Registrierung in der Attribution Reporting API infrage kommen. Im VAST-Anhang zur Unterstützung von Attributionsberichten wird dies ausführlich erläutert. Kurz gesagt: Alle <Tracking>-, <Impression>-, <*ClickThrough>- und <*ClickTracking>-Ereignisse sind potenzielle Attributionsquellenereignisse. Alle VAST-Implementierungen sollten die Teilnahmevoraussetzungen für diese Ereignisse abdecken.

Im VAST-Anhang werden neue Attribute für diese Elemente definiert, um eine sekundäre URL speziell für die Attributionsregistrierung festzulegen. Wenn ein Ereignis attributiontype="DOUBLE_PING" und attributionsrc="[URL]" enthält, sollte im Code, der dieses Ereignis auslöst, [URL] als Wert für das Attribut attributionsrc verwendet werden, wenn die Attribution Reporting API aktiviert ist. Das VAST-Addendum enthält Beispiele für jedes Szenario.

Um eine maximale Abdeckung zu gewährleisten, sollten bei VAST-Implementierungen alle aufgeführten Ereignisse standardmäßig für die Registrierung infrage kommen, wenn Ereignis-Pings gesendet werden. Wenn Sie beispielsweise eine <Impression>-Ereignis-URL auslösen, sollte das (leere) attributionsrc-Attribut für das <img>-Element verwendet werden, mit dem die Anfrage gesendet wird (oder das entsprechende Attribut für den Abrufaufruf), damit die Empfängerseite dieses Ereignis jederzeit bei der Attribution Reporting API registrieren kann.

Schritt 2: Attributionsberichte für Drittanbieterquellen aktivieren

Wenn Sie Dritten die Nutzung der Attribution Reporting API erlauben möchten, können Sie vorhandene Weiterleitungen verwenden oder dem attributionsrc-Attribut eine Liste von Drittanbietern hinzufügen. In den meisten Fällen hat jede Anzeigentechnologie einen eigenen unabhängigen Impressions-Tracker. Deshalb sind Weiterleitungen für Klick-Tracker relevanter.

Drittanbieter-Ursprunge in einer vorhandenen Weiterleitungskette verarbeiten

Bei einem typischen Anzeigenklick kann es viele Klick-Tracker geben, die als Kette von 302-Weiterleitungen auf der Navigation zur endgültigen Landingpage vorhanden sind. Jede Anfrage in der Weiterleitungskette kann bei der Attribution Reporting API registriert werden, wenn das ursprüngliche Klickziel mit attributionsrc annotiert oder in der Protected Audience API mit registerAdBeacon/registerAdMacro registriert wurde. Die Anzeigentechnologie in der Weiterleitungskette muss ebenfalls registriert sein.

Der Text der ursprünglichen Anfrage wird bei Weiterleitungen nicht gesendet. Wenn bei Protected Audience-Auktionen eventData an reportEvent übergeben wird und setReportEventDataForAutomaticBeacons als Teil der Weiterleitung verwendet werden muss, muss es explizit als Teil der Weiterleitungs-URL übergeben werden.

Im folgenden Beispiel verwenden wir eine Anzeigentechnologie für die Anzeigenbereitstellung (serving-adtech.example) und einen Drittanbieter für Analysen (3p-measurement.example) als zwei verschiedene Entitäten, die Attributionsberichte generieren und empfangen möchten. Die Anzeigentechnologie für die Auslieferung kann in diesem Beispiel eine DSP sein, die das Creative auf der Publisher-Website rendert und ein eigenes Berichtsprodukt hat. Der Anbieter der Drittanbieteranalyse kann ein Rechtssubjekt sein, das der Werbetreibende für Conversion-Berichte verwendet.

Ein Diagramm, das beschreibt, wie der Publisher die Quelle registriert und dann der Drittanbieter

Bei der Registrierung der Quelle werden die folgenden Schritte ausgeführt:

  1. serving-adtech.example legt das attributionsrc-Attribut im Creative fest. Der Nutzer besucht die Publisher-Seite und der Browser sendet eine Anfrage an serving-adtech.example..
  2. serving-adtech.example antwortet mit den Headern Attribution-Reporting-Register-Source und Location.
    1. serving-adtech.example verwendet den Attribution-Reporting-Register-Source-Header, um mit Metadaten zur zu registrierenden Quelle zu antworten.
    2. serving-adtech.example verwendet den Location-Header, um eine Weiterleitung zu 3p-measurement.example einzufügen. Der Location-Header wird wahrscheinlich bereits in Ihren vorhandenen Klick-Tracking-Abläufen verwendet, um 302-Weiterleitungen an Drittanbieter zu unterstützen.
  3. Der Browser empfängt die Antwort von serving-adtech.example und analysiert den Attribution-Reporting-Register-Source-Header. Der Browser speichert das Quellereignis und verwendet serving-adtech.example als Berichtsquelle.
  4. Da es sich bei dieser Anfrage um eine Weiterleitung handelt, stellt der Browser auch eine neue Anfrage an 3p-measurement.example.
  5. 3p-measurement.example antwortet mit einer Antwort, die den Attribution-Reporting-Register-Source-Header enthält.
  6. Der Browser empfängt diese Antwort von 3p-measurement.example und liest den Attribution-Reporting-Register-Source. Der Browser speichert das Quellereignis und verwendet 3p-measurement.example als Berichtsquelle.

attributionsrc für Drittanbieter-Ursprünge verwenden, die nicht in einer Weiterleitungskette enthalten sind

Wenn mehrere Berichtsquellen eine Quelle für ein Navigationsereignis registrieren möchten, diese aber aus irgendeinem Grund nicht in einer Weiterleitungskette erscheinen können, können Sie als alternative Lösung mehrere Websites in attributionsrc als Attributionsquellen angeben.

Vorhandene Einrichtung Mit ARA-Änderung
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc="[REPORTING_URL_1] [REPORTING_URL_2]">...</a>

In diesem Beispiel werden Anfragen, die für die Attribution Reporting API infrage kommen, sowohl an REPORTING_URL_1 als auch an REPORTING_URL_2 gesendet. Die Navigationsanfrage, die an die Klick-URL gesendet wird, kann auch zur Registrierung von Attributionsquellen verwendet werden.

Schritt 3: Antworten auf Attribution Reporting API-Anfragen einrichten

Achten Sie darauf, dass der Server für alle Ursprünge, die eine Attribution Reporting API-Anfrage erhalten, mit dem entsprechenden Attribution-Reporting-Register-Source-Header antwortet. Weitere Informationen dazu, wie die Antwort aufgebaut sein sollte, findest du in der Anleitung zum Registrieren von Quellen und in der Erläuterung.

Mehrere Trigger registrieren

Sie können mehrere Attributionstrigger registrieren, indem Sie mehrere Pixelelemente auf Conversion-Seite hinzufügen (jeweils eins pro Trigger). Das attributionsrc-Element ist für die Triggerregistrierung optional.

Sie können auch mehrere Trigger über ein einzelnes Pixelelement registrieren, indem Sie Weiterleitungsanfragen verwenden oder wie bei der Quellenregistrierung mehrere URLs im attributionsrc-Element angeben. Quell- und Triggerereignisse, die von denselben Ursprüngen generiert wurden, werden abgeglichen.