Zur Messung der Conversion-Attribution können mehrere Parteien beteiligt sein, z. B. der Publisher, der Werbetreibende, die Anzeigentechnologie (die Entität, die die Anzeige schaltet), der Anbieter für Messungen und mehr. In diesem Dokument werden allgemeine Szenarien der Conversion-Analyse veranschaulicht. Im Allgemeinen müssen jedoch alle Anbieter, die einen Attributionsbericht von der Attribution Reporting API (ARA) erhalten möchten, die in diesem Dokument beschriebenen Integrationsschritte befolgen.
Beispielsweise ist es üblich, dass ein Publisher einen oder mehrere Anzeigentechnologie-Anbieter hat, die für die Auslieferung der Anzeige verantwortlich sind. Dies können Parteien sein, die für die Bereitstellung des Markups für das Creative verantwortlich sind, die Parteien, die das Impressions- oder Tracking-Pixel im Creative bereitstellen, und die Parteien, die das SDK oder das Tag für die Anzeigenfläche auf der Publisher-Seite bereitstellen. Diese AdTechs können Attributionsberichte von ARA erhalten oder auch nicht, sind aber in der Lage, sicherzustellen, dass nachgelagerte Anzeigentechnologie Attributionsberichte erhalten kann.
Außerdem kann der Werbetreibende einen Drittanbieter für die Conversion-Analyse für die netzwerkübergreifende Attribution und andere Berichtsfunktionen nutzen. Werbetreibende verwenden diese Daten, um den Return on Investment der Werbeinvestitionen über mehrere Publisher und Kanäle hinweg zu ermitteln. Daher ist es wichtig, dass DSPs oder Ad-Server wissen, wie die Attribution Reporting API zur Unterstützung dieser Anwendungsfälle aktiviert werden kann. Werbetreibende, die einen Drittanbieter in Anspruch nehmen möchten, können dazu entweder einen Drittanbieter für Messungen verwenden oder einen internen Server einrichten, um Berichte über die API zu registrieren und zu erhalten.
Mit der Attribution Reporting API können mehrere Anzeigentechnologie-Anbieter Attributionsquellen und Trigger für dieselbe Impression oder Conversion registrieren und separate Berichte von der API erhalten. So kann eine DSP beispielsweise ihre eigenen Attributionsberichte von der Attribution Reporting API erhalten und auch separate Berichte für den Drittanbieter von Analysen des Werbetreibenden bereitstellen. Ein Anzeigentechnologie-Anbieter muss sowohl Attributionsquellen als auch Trigger registrieren, um Berichte von der API zu erhalten. Die Attribution erfolgt zwischen den Attributionsquellen und den Triggern, die der Anzeigentechnologie-Anbieter einzeln in der API registriert hat.
Häufige Szenarien bei der Conversion-Analyse
In diesem Abschnitt sehen wir uns zwei häufige Szenarien für die Conversion-Analyse an.
Szenario 1: Sowohl Anzeigentechnologie-Anbieter als auch Drittanbieter für Messungen müssen Berichte von der Attribution Reporting API erhalten
Ein Werbetreibender möchte Conversions im Anzeigeninventar über einen Drittanbieter für Messungen zuordnen, während die Anzeigentechnologie, die das Creative hostet, Conversions dem Anzeigeninventar zuordnen. Dies ist üblich für DSPs oder Ad-Server von Werbetreibenden (Ad-Server eines Drittanbieters – 3PAS), die das Markup für Creatives bereitstellen, eigene Attributionsberichte erstellen und mit Werbetreibenden zusammenarbeiten, die mit Drittanbietern für Messungen oder Analysen zusammenarbeiten.
In diesem Fall ist die ausliefernde AdTech auch die Partei, die im aktuellen Setup für das Auslösen von Klick- und Impressionsereignissen verantwortlich ist. Die Technologie für die Anzeigenbereitstellung sollte die neue attributionsrc
an den entsprechenden Stellen platzieren und dafür sorgen, dass die Weiterleitungen richtig konfiguriert sind. Außerdem müssen sowohl die Anzeigentechnologie als auch der Drittanbieter für Messungen registriert sein und ihre Server für den Empfang und die Beantwortung von Anfragen über die Attribution Reporting API bereit sein.
Eine typische Kampagneneinrichtung sieht so aus:
Der Ad-Server des Werbetreibenden (3PAS) stellt der DSP das Markup für das Creative bereit, einschließlich der Impressions- und Klick-Tracking-Pixel des Drittanbieters für Messungen. Der Ad-Server muss sicherstellen, dass
attributionsrc
im Creative-Markup enthalten ist.Über die DSP können zusätzliche Tracking-Pixel für Impressionen und Klicks hinzugefügt werden. Achten Sie dabei darauf, dass
attributionsrc
im endgültigen Creative-Markup enthalten ist, mit dem das Gebot abgegeben wird.
Szenario 2: Nur der Drittanbieter für Messungen benötigt Berichte von der Attribution Reporting API
Ein Werbetreibender möchte Conversions für Anzeigeninventar über einen Drittanbieter für Messungen zuordnen. Für die AdTech-, die das Creative hostet, gelten jedoch keine Anforderungen zur Attributionsanalyse. Dies ist üblich für Publisher, SSPs oder Publisher-Ad-Server, die Creatives hosten und nicht selbst Attributionsberichte verwenden möchten, aber die Attribution Reporting API entweder für ihre DSP-Partner oder für Unternehmen mit Tagging für Messungen wie Ad-Server eines Drittanbieters, Analyse- oder Analyseanbieter aktivieren möchten.
In diesem Fall muss derjenige, der bei der aktuellen Konfiguration für das Auslösen von Klick- und Impressionsereignissen verantwortlich ist, den Creatives das neue attributionsrc
-Attribut hinzufügen und dafür sorgen, dass die Weiterleitungen wie vorgesehen funktionieren. Dies hängt stark von der Integration des jeweiligen Publishers ab. Bei Klickereignissen kann dies jedoch die SSP, die Anzeigentechnologie oder der Publisher selbst sein. Bei Impressionsereignissen ist dies häufiger der Drittanbieter für Messungen.
Im typischen Beispiel für die Kampagneneinrichtung aus Szenario 1 muss der Ad-Server des Publishers, der SSP oder der Publisher selbst möglicherweise nur dafür sorgen, dass das von der DSP bereitgestellte Attribut attributionsrc
auf die Seite des Publishers gelangt.
Implementierungsdetails
In der folgenden Tabelle werden die Implementierungsschritte für die Attribution Reporting API grob beschrieben:
Schritte | Arbeitsverantwortung | Beispiele |
---|---|---|
Schritt 1: Attributionsquelle für vorhandene Creatives und Messcode aktivieren | Die Entität, die für das Auslösen von Impressionsereignissen oder die Verarbeitung von Klickereignissen verantwortlich ist, fügt das Attribut attributionsrc hinzu. |
Bei Klickereignissen fügt normalerweise ein Käufer (DSP oder Ad-Server des Werbetreibenden), 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 Anbieter für Messungen hinzugefügt. Es hängt von der Konfiguration des Publishers ab. Bei Videoanzeigen im VAST-Format wird das Attribut vom Publisher und vom Video SDK hinzugefügt. |
Schritt 2: Attributionsberichte für Drittanbieterquellen aktivieren | Dies funktioniert sofort, wenn Sie einen bestehenden Weiterleitungspfad mit 302-Weiterleitungen verwenden. Wenn 302-Weiterleitungen nicht verwendet werden können, lassen sich mit dem Attribut |
Solange dem Creative das Attribut attributionsrc hinzugefügt wird, sollten die Drittanbieter-Weiterleitungen die Attribution Reporting API-Aufrufe erhalten. |
Schritt 3: Antworten auf Attribution Reporting API-Anfragen einrichten | Eine Entität, die Berichte von der Attribution Reporting API erhalten möchte | Vom Werbetreibenden verwendete DSP und der Drittanbieter für Messungen |
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 über die 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 festgelegt, 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. Das Feld „attributionsrc
“ sollte vorhandenen Klick- und Impressionsereignissen hinzugefügt werden. Es kann leer oder leer sein.
Bei Klickereignissen mit Weiterleitungen sollte das Attribut attributionsrc
in die Navigation aufgenommen werden. Bei allen 302-Weiterleitungen nach der Navigation muss das Attribut attributionsrc
nicht hinzugefügt werden. Sie sind für ARA zulässig, solange in der ersten Navigation attributionsrc
hinzugefügt wurde.
Wenn attributionsrc
leer ist, werden die ARA-Anfragen an die URL gesendet, die im Attribut href
des Anchor-Tags (Klick-URL) definiert ist. Wenn das Attribut attributionsrc
definiert ist, werden die ARA-Anfragen an die im Attribut attributionsrc
definierte URL gesendet. Über die Klick-URL können auch Quellen registriert 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. Legen Sie eine eigene attributionsrc
-URL fest, wenn Anfragen über die Attribution Reporting API an einen anderen Server gesendet werden sollen.
Beispiel für ein leeres attributionsrc
-Attribut:
Ihre bestehende Einrichtung | Mit ARA-Integration |
---|---|
<a href="[CLICKTHROUGH_URL]">...</a>
|
<a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>
|
Wenn das Attribut attributionsrc
leer ist, werden Anfragen an die Attribution Reporting API an die URL gesendet, die im Attribut href
des Anchor-Tags definiert ist.
Beispiel für ein nicht leeres Attribut „attributionsrc“:
Ihre bestehende Einrichtung | Mit ARA-Integration |
---|---|
<a href="[CLICKTHROUGH_URL]">...</a>
|
<a href="[CLICKTHROUGH_URL]" attributionsrc="[ATTRIBUTION_SRC_URL]">...</a>
|
Wenn das Feld attributionsrc
nicht leer ist, werden Anfragen an die Attribution Reporting API an die im attributionsrc
-Tag definierte URL gesendet. Über die Klick-URL können auch Quellen registriert 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, die ausgeliefert wird. - Anker-Tags mit Klickereignissen sollten das Attribut
attributionsrc
hinzugefügt werden. - Bei Klicks mit
window.open
muss das ArgumentwindowFeatures
des Aufrufswindow.open
verwendet werden, um die Attributionsquelle anzugeben.
- Die Entität, die für das Hinzufügen der
- Impressionsereignisse:
- Die Entität, die für das Hinzufügen der
attributionsrc
verantwortlich ist, ist in der Regel die Anzeigentechnologie und der Anbieter für Messungen. - Vom
<img>
-Tag oder<script>
-Tag ausgelöste Impressionsereignisse müssen einattributionsrc
-Attribut enthalten. - Für Impressionsereignisse, die die Fetch API verwenden, sollte im Argument options, das an den Fetch API-Aufruf übergeben wird, ein
attributionReporting
-Objekt enthalten sein.
- Die Entität, die für das Hinzufügen der
In der folgenden Tabelle finden Sie eine Zusammenfassung der Änderungen, die für Klick- und Impression-Ereignisse erforderlich sind:
Veranstaltung | Tag | Ihre bestehende 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 = {...} |
const options = { |
Registrierung von Attributionsquellen in einer Protected Audience-Auktion aktivieren
Wenn Sie Conversions in Protected Audience-Auktionen erfassen möchten, können Sie anstelle von attributionsrc
auch registerAdBeacon
/registerAdMacro
und setReportEventDataForAutomaticBeacons
/reportEvent
verwenden, um die Registrierung von Attributionsquellen zu aktivieren.
Für Protected Audience-Signale ist die Funktion „registerAdBeacon
“ in Worklets für die Berichterstellung und „registerAdMacro
“ im Worklet für die Berichterstellung zu den Gewinnen des Käufers verfügbar. 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 Reporting-Worklets für Protected Audience und der Ereignisnutzlast des Anzeigen-Creative-Frames einander zugeordnet werden.
Der Attribution-Reporting-Eligible
-HTTP-Header wird der Anfrage hinzugefügt, wenn die Beacons und Makros durch den reportEvent
-Aufruf aus einem Frame ausgelöst werden oder wenn die automatischen Beacons vom Browser ausgelöst werden. Sie können die Antwort des Beacons verwenden, um eine Attributionsquelle zu registrieren. Beacon-Anfragen werden unter Umständen weitergeleitet, damit Analysen durch Drittanbieter möglich sind.
Ausführlichere Informationen finden Sie im Abschnitt Support for Attribution Reporting in 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 Quellereignisse betrachtet werden, die für die Registrierung bei der Attribution Reporting API infrage kommen. Im VAST-Zusatz zur Unterstützung von Attribution Reporting wird dies ausführlich beschrieben. Kurz gesagt: Alle Ereignisse vom Typ <Tracking>
, <Impression>
, <*ClickThrough>
und <*ClickTracking>
sind potenzielle Attributionsquellenereignisse. Bei allen VAST-Implementierungen sollte die Registrierungsberechtigung dieser Ereignisse abgedeckt sein.
Im VAST-Zusatz werden neue Attribute für diese Elemente definiert, um eine sekundäre URL speziell für die Attributionsregistrierung festzulegen. Enthält ein Ereignis attributiontype="DOUBLE_PING"
und attributionsrc="[URL]"
, sollte für den Code, der dieses Ereignis auslöst, [URL]
als Wert für das Attribut attributionsrc
verwendet werden, wenn die Attribution Reporting API aktiviert wird. Der VAST-Zusatz enthält für jedes Szenario Beispiele.
Um eine maximale Abdeckung zu gewährleisten, sollten bei VAST-Implementierungen alle aufgeführten Ereignisse standardmäßig registriert werden können, wenn Ereignis-Pings ausgelöst werden. Wenn beispielsweise eine <Impression>
-Ereignis-URL ausgelöst wird, sollte das (leere) attributionsrc
-Attribut für das <img>
-Element verwendet werden, das zum Senden der Anfrage verwendet wird (oder das entsprechende Element beim Abrufaufruf), damit die empfangende Partei das Ereignis immer bei der Attribution Reporting API registrieren kann.
Schritt 2: Attributionsberichte für Drittanbieterquellen aktivieren
Damit Drittanbieter die Attribution Reporting API nutzen können, können Sie vorhandene Weiterleitungen nutzen oder dem Attribut attributionsrc
eine Liste von Drittanbietern hinzufügen. In den meisten Fällen hat jede Anzeigentechnologie einen eigenen unabhängigen Impressions-Tracker, sodass Weiterleitungen für Klick-Tracker relevanter sind.
Drittanbieterursprünge in einer vorhandenen Weiterleitungskette verarbeiten
Bei einem typischen Anzeigenklick können viele Klick-Tracker als Kette von 302
-Weiterleitungen vorhanden sein, die als Teil der Navigation zur endgültigen Landingpage erfolgt sind. Jede Anfrage in der Weiterleitungskette kommt für die Registrierung bei der Attribution Reporting API infrage, wenn das ursprüngliche Klickziel mit attributionsrc
gekennzeichnet oder in der Protected Audience API mit registerAdBeacon/registerAdMacro
registriert wurde. Die Anzeigentechnologie in der Weiterleitungskette muss ebenfalls registriert werden.
Beachten Sie, dass der Text der ursprünglichen Anfrage bei Weiterleitungen nicht gesendet wird. Wenn bei Protected Audience-Auktionen die an reportEvent
übergebenen eventData
und die setReportEventDataForAutomaticBeacons
als Teil der Weiterleitung verwendet werden müssen, muss dies explizit als Teil der Weiterleitungs-URL weitergegeben werden.
Im folgenden Beispiel werden eine Anzeigentechnologie (serving-adtech.example
) für die Anzeigenbereitstellung und ein Drittanbieter für Messungen (3p-measurement.example
) als zwei verschiedene Entitäten verwendet, die Attributionsberichte generieren und empfangen möchten. Die Anzeigentechnologie in diesem Beispiel kann eine DSP sein, die das Creative auf der Publisher-Website rendert und ein eigenes Berichtsprodukt hat. Der Drittanbieter für Messungen kann ein Rechtssubjekt sein, das der Werbetreibende für Conversion-Berichte verwendet.
Bei der Registrierung der Quelle werden folgende Schritte ausgeführt:
serving-adtech.example
legt das Attributattributionsrc
im Creative fest. Der Nutzer besucht die Publisher-Seite und der Browser sendet eine Anfrage anserving-adtech.example.
.serving-adtech.example
antwortet mit dem HeaderAttribution-Reporting-Register-Source
und dem HeaderLocation
.serving-adtech.example
verwendet den HeaderAttribution-Reporting-Register-Source
, um mit Metadaten zur zu registrierenden Quelle zu antworten.serving-adtech.example
verwendet denLocation
-Header, um eine Weiterleitung zu3p-measurement.example
einzuschließen. Wahrscheinlich wird derLocation
-Header bereits in Ihren bestehenden Klick-Tracking-Abläufen verwendet, um302
-Weiterleitungen zu einem Drittanbieter zu unterstützen.
- Der Browser empfängt die Antwort von
serving-adtech.example
und parst denAttribution-Reporting-Register-Source
-Header. Im Browser wird das Quellereignis gespeichert undserving-adtech.example
als Ausgangspunkt für die Berichterstellung verwendet. - Da es sich bei dieser Anfrage um eine Weiterleitung handelt, sendet der Browser ebenfalls eine neue Anfrage an
3p-measurement.example
. 3p-measurement.example
antwortet mit einer Antwort, die denAttribution-Reporting-Register-Source
-Header enthält.- Der Browser empfängt diese Antwort von
3p-measurement.example
und liest denAttribution-Reporting-Register-Source
. Im Browser wird das Quellereignis gespeichert und3p-measurement.example
als Ausgangspunkt für die Berichterstellung verwendet.
attributionsrc
für Drittanbieterursprünge verwenden, die sich nicht in einer Weiterleitungskette befinden
Wenn mehrere Ursprünge eines Reporters eine Quelle für ein Navigationsereignis registrieren möchten, aber aus irgendeinem Grund nicht in einer Weiterleitungskette vorkommen können, können Sie als alternative Lösung mehrere Websites als Attributionsquellen in attributionsrc
auflisten.
Ihre bestehende 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 zulässig sind, sowohl an REPORTING_URL_1
als auch an REPORTING_URL_2
gesendet. Mit der Navigationsanfrage, die an die Klick-URL gesendet wird, können auch Attributionsquellen registriert werden.
Schritt 3: Antworten auf Attribution Reporting API-Anfragen einrichten
Achten Sie bei allen Ursprüngen, die eine Attribution Reporting API-Anfrage erhalten, darauf, dass der Server mit dem richtigen Attribution-Reporting-Register-Source
-Header antwortet. Informationen zum Aufbau der Antwort finden Sie im Leitfaden Quellen registrieren und in der Erläuterung.
Mehrere Trigger registrieren
Sie können mehrere Attributionstrigger registrieren, indem Sie mehrere Pixelelemente auf der Conversion-Seite hinzufügen (eines pro Trigger). Das Element attributionsrc
ist für die Triggerregistrierung optional.
Sie können auch mehrere Trigger von einem einzelnen Pixelelement registrieren, indem Sie Weiterleitungsanfragen verwenden oder mehrere URLs im attributionsrc
-Element auf dieselbe Weise wie bei der Quellenregistrierung auflisten. Quell- und Triggerereignisse, die von denselben Ursprüngen generiert wurden, werden abgeglichen.