Conversion-Analyse aktivieren

Die Messung der Conversion-Attribution kann mehrere Parteien einbeziehen, darunter der Publisher, der Werbetreibende, die ausliefernde Anzeigentechnologie (die Entität, die die Anzeige ausliefert), oder der Anbieter der Messung. In diesem Dokument werden gängige Szenarien der Conversion-Analyse veranschaulicht. Grundsätzlich muss jeder, der einen Attributionsbericht von der Attribution Reporting API (ARA) erhalten möchte, dafür sorgen, dass die in diesem Dokument beschriebenen Integrationsschritte eingehalten werden.

Es ist beispielsweise üblich, dass ein oder mehrere Anzeigentechnologie-Anbieter für die Bereitstellung der Anzeige verantwortlich sind. Dazu gehören die Parteien, die für die Bereitstellung des Markups für das Creative verantwortlich sind, die Parteien, die das Impressions- oder Tracking-Pixel des Creatives bereitstellen, und die Parteien, die das SDK oder das Tag für die Anzeigenfläche auf der Publisher-Seite bereitstellen. Diese Anzeigentechnologie-Anbieter möchten möglicherweise Attributionsberichte von ARA erhalten, sind aber in der Lage, sicherzustellen, dass nachgelagerte Anzeigentechnologien Attributionsberichte erhalten können.

Außerdem nutzt der Werbetreibende unter Umständen einen Drittanbieter für die Conversion-Analyse für die netzwerkübergreifende Attribution sowie andere Berichtsfunktionen. Werbetreibende nutzen diese Daten, um den Return on Investment mehrerer Publisher und Kanäle zu ermitteln. Daher ist es wichtig, dass DSPs oder Ad-Server wissen, wie die Attribution Reporting API für diese Anwendungsfälle aktiviert werden kann. Werbetreibende, die einen Drittanbieter nutzen möchten, können weiterhin einen Drittanbieter für Messungen nutzen oder einen internen Server einrichten, um sich zu registrieren und Berichte von der API zu erhalten.

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. Beispielsweise kann eine DSP eigene Attributionsberichte über die Attribution Reporting API erhalten und separate Berichte für den Drittanbieter für Messungen des Werbetreibenden erstellen. Ein Anzeigentechnologie-Anbieter muss sowohl Attributionsquellen als auch Trigger registrieren, um Berichte von der API zu erhalten. Die Attribution erfolgt unter den Attributionsquellen und löst aus, dass sich der Anzeigentechnologie-Anbieter einzeln bei der API registriert hat.

Häufige Szenarien der Conversion-Analyse

In diesem Abschnitt betrachten wir zwei häufige Szenarien für die Conversion-Analyse.

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

Ein Werbetreibender möchte die Conversions des Anzeigeninventars über einen Drittanbieter für Messungen zuordnen, und der Anzeigentechnologie-Anbieter, der das Creative hostet, möchte die Conversions dem Anzeigeninventar zuordnen. Dies ist häufig bei DSPs oder Ad-Servern von Werbetreibenden (Ad-Server eines Drittanbieters, 3PAS) der Fall, die Markups für Anzeigen-Creatives bereitstellen, eigene Attributionsberichte erstellen und mit Werbetreibenden zusammenarbeiten, die Analyse- oder Analysedienste von Drittanbietern nutzen.

In diesem Fall ist der AdTech-Anbieter auch für das Auslösen von Klick- und Impressionsereignissen in der aktuellen Konfiguration verantwortlich. Der AdTech-Anbieter sollte die neue attributionsrc an geeigneten Stellen festlegen und dafür sorgen, dass die Weiterleitungen richtig konfiguriert sind. Sowohl der AdTech-Anbieter als auch der Drittanbieter für Messungen müssen 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 Anzeigen-Creative bereit, einschließlich der Impressions- und Klick-Tracking-Pixel des Drittanbieters für Messungen. Der Ad-Server muss dafür sorgen, dass attributionsrc im Anzeigen-Creative-Markup enthalten ist.

  2. Die DSP bietet Funktionen zum Hinzufügen zusätzlicher Impressions- und Klick-Tracking-Pixel für die Messung. attributionsrc sollte im Markup für Anzeigen-Creatives enthalten sein, auf die sie bieten.

Szenario 2: Nur der Drittanbieter für Messungen muss Berichte über die Attribution Reporting API erhalten

Ein Werbetreibender möchte Conversions für Anzeigeninventar über einen Drittanbieter für Messungen zuordnen. Für die Anzeigentechnologie, die das Creative hostet, gelten jedoch keine Anforderungen an die Attributionsmessung. Dies ist häufig bei Publishern, Sell-Side-Plattformen oder Publisher-Ad-Servern der Fall, die Creatives hosten und nicht selbst die Attributionsberichte verwenden, aber die Attribution Reporting API entweder für ihre DSP-Partner oder für Unternehmen mit Tagging-Lösungen von Drittanbietern (z. B. Ad-Server von Drittanbietern, Analyse- oder Messanbieter) aktivieren möchten.

In diesem Fall muss der Anbieter, der in der aktuellen Einrichtung für das Auslösen von Klick- und Impressionsereignissen zuständig ist, den Creatives das neue attributionsrc-Attribut hinzufügen und dafür sorgen, dass die Weiterleitungen wie vorgesehen funktionieren. Das hängt stark von der Integration des jeweiligen Publishers ab. Bei Klickereignissen kann das jedoch die SSP, die Anzeigentechnologie oder der Publisher selbst sein. Für Impressionsereignisse ist das der Drittanbieter für Messungen in der Regel.

Beim typischen Beispiel für die Kampagneneinrichtung aus Szenario 1 muss der Ad-Server des Publishers, die SSP oder der Publisher selbst möglicherweise nur dafür sorgen, dass das von der DSP bereitgestellte Attribut attributionsrc auf der Publisher-Seite erscheint.

Implementierungsdetails

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

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

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

Bei Videoanzeigen im VAST-Format fügen der Publisher und das Video SDK das Attribut hinzu.

Schritt 2: Attributionsberichte für die Quellen von Drittanbietern aktivieren Dies funktioniert sofort, wenn Sie einen bestehenden Weiterleitungspfad mit 302-Weiterleitungen verwenden.

Wenn keine 302-Weiterleitungen möglich sind, können Sie mit dem Attribut attributionsrc mehrere AdTech-Server auflisten.

Im Allgemeinen sollten die Drittanbieter-Weiterleitungen die Attribution Reporting API-Aufrufe erhalten, solange dem Creative das Attribut attributionsrc hinzugefügt wird.
Schritt 3: Antworten auf Attribution Reporting API-Anfragen einrichten Jede Entität, die Berichte von der Attribution Reporting API erhalten möchte Die DSP und der vom Werbetreibenden verwendete Anbieter für Messungen

Die Details der einzelnen Schritte hängen davon ab, wie die 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

Das neue attributionsrc-Attribut gibt an, 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 und kann leer oder nicht leer sein.

Für Klickereignisse mit Weiterleitungen sollte das Attribut attributionsrc in die Navigation aufgenommen werden. Für 302-Weiterleitungen nach der Navigation muss das Attribut attributionsrc nicht hinzugefügt werden. Sie sind für ARA qualifiziert, solange bei 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. Mit der Klick-URL können auch Quellen registriert werden.

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

Beispiel für ein leeres attributionsrc-Attribut:

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

Wenn das Attribut attributionsrc leer ist, werden Attribution Reporting API-Anfragen an die im Attribut href des Anchor-Tags definierte URL gesendet.

Beispiel für ein nicht leeres Attribut „attributionsrc“:

Bestehende 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 im attributionsrc-Tag definierte URL gesendet. Mit der 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 normalerweise die ausliefernde Anzeigentechnologie
    • Anker-Tags mit Klickereignissen sollte das Attribut attributionsrc hinzugefügt werden
    • Bei Klicks mit window.open muss das Argument windowFeatures des window.open-Aufrufs verwendet werden, um die Attributionsquelle anzugeben.
  • Impressionsereignisse:
    • Die Rechtspersönlichkeit, die für das Hinzufügen der attributionsrc verantwortlich ist, ist in der Regel der ausliefernde Anzeigentechnologie-Anbieter und der bzw. die Anbieter für Messungen.
    • Impressionsereignisse, die über das <img>-Tag oder <script>-Tag ausgelöst werden, müssen ein attributionsrc-Attribut enthalten.
    • Bei Impressionsereignissen, die über die Fetch API verwendet werden, muss im Argument options, das an den Abruf API-Aufruf übergeben wird, ein attributionReporting-Objekt enthalten sein.

In der folgenden Tabelle finden Sie eine Zusammenfassung der Änderungen, die für Klick- und Impressionsereignisse erforderlich sind:

Veranstaltung Tag 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 = {...}
window.fetch("[IMPRESSION_URL]", options); 		const options = {
  attributionReporting: {
    eventSourceEligible: true,
    triggerEligible: false,
  },
  // ...
}

window.fetch("[IMPRESSION_URL]", options);

Registrierung einer Attributionsquelle in einer Protected Audience-Auktion aktivieren

Zum Erfassen von Conversions in Protected Audience-Auktionen können Sie anstelle von attributionsrc registerAdBeacon/registerAdMacro und setReportEventDataForAutomaticBeacons/reportEvent verwenden, um die Registrierung von Attributionsquellen zu aktivieren.

Für die Berichterstellung über Protected Audience-Signale steht die registerAdBeacon-Funktion in den Berichterstellungs-Worklets zur Verfügung und die registerAdMacro ist im Worklet zum Gewinnen von Berichten des Käufers verfügbar. Anschließend können die Ereignisdaten im Anzeigen-Frame den registrierten Beacons und Makros mit den Funktionen reportEvent und setReportEventDataForAutomaticBeacons der Fenced Frame Ads Reporting API hinzugefügt werden. Dadurch können die Signale der Protected Audience-Berichterstellungs-Worklets und die Ereignisnutzlast des Creative-Frames einander zugeordnet werden.

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

Ausführlichere Informationen finden Sie in der Erläuterung zur Fenced Frame Ad Reporting API im Abschnitt Unterstützung für Attribution Reporting.

Attributionsberichte für VAST-Formate aktivieren

VAST ist ein gängiges Format für die Auslieferung und Messung von Videoanzeigeninventar. Viele der in diesem Standard definierten Ereignisse sollten als potenzielle Quellereignisse betrachtet werden, die für die Registrierung mit der Attribution Reporting API infrage kommen. Im VAST-Zusatz zur Unterstützung der Attributionsberichte wird dies ausführlich beschrieben. Kurz gesagt: Alle Ereignisse vom Typ <Tracking>, <Impression>, <*ClickThrough> und <*ClickTracking> sind potenzielle Ereignisse der Attributionsquelle. Bei allen VAST-Implementierungen muss die Berechtigung zur Registrierung für diese Ereignisse abgedeckt sein.

Im VAST-Zusatz sind neue Attribute für diese Elemente definiert, über die eine sekundäre URL speziell für die Registrierung der Attribution festgelegt werden kann. Wenn ein Ereignis attributiontype="DOUBLE_PING" und attributionsrc="[URL]" enthält, sollte im Code, der dieses Ereignis auslöst, beim Aktivieren der Attribution Reporting API [URL] als Wert für das Attribut attributionsrc verwendet werden. Der VAST-Anhang enthält Beispiele für jedes Szenario.

Für eine maximale Abdeckung 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, das zum Senden der Anfrage verwendet wird (oder das entsprechende Element beim Abrufaufruf), damit die empfangende Partei das Ereignis unter Umständen bei der Attribution Reporting API registrieren kann.

Schritt 2: Attributionsberichte für die Quellen von Drittanbietern aktivieren

Damit Drittanbieter die Attribution Reporting API nutzen können, können Sie vorhandene Weiterleitungen verwenden oder dem Attribut attributionsrc eine Liste mit 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 im Rahmen der Navigation zur endgültigen Landingpage erfolgen. Jede Anfrage in der Weiterleitungskette kommt für die Registrierung bei der Attribution Reporting API infrage, wenn das ursprüngliche Klickziel mit attributionsrc annotiert oder mit registerAdBeacon/registerAdMacro in der Protected Audience API registriert wurde. Die Anzeigentechnologie in der Weiterleitungskette muss ebenfalls registriert werden.

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

Im folgenden Beispiel verwenden wir eine Anzeigentechnologie zur Anzeigenbereitstellung (serving-adtech.example) und einen Drittanbieter für Messungen (3p-measurement.example) als zwei unterschiedliche Elemente, die Attributionsberichte generieren und erhalten möchten. Die Anzeigentechnologie in diesem Beispiel kann eine DSP sein, die das Creative auf der Publisher-Website rendert und ein eigenes Berichterstellungsprodukt hat. Der Drittanbieter für Messungen kann eine Entität sein, die der Werbetreibende für Conversion-Berichte verwendet.

Ein Diagramm, das zeigt, wie der Erstanbieter die Quelle und der Drittanbieter die Quelle dann registriert.

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

  1. Mit serving-adtech.example wird das Attribut attributionsrc im Creative festgelegt. Der Nutzer besucht die Publisher-Seite und der Browser sendet eine Anfrage an serving-adtech.example..
  2. serving-adtech.example antwortet mit dem Attribution-Reporting-Register-Source-Header und dem Location-Header.
    1. serving-adtech.example verwendet den Header Attribution-Reporting-Register-Source, um Metadaten zur zu registrierenden Quelle zu antworten.
    2. serving-adtech.example verwendet den Location-Header, um eine Weiterleitung zu 3p-measurement.example einzuschließen. Wahrscheinlich wird der Location-Header in Ihren vorhandenen Klick-Tracking-Abläufen bereits verwendet, um 302-Weiterleitungen an Drittanbieter zu unterstützen.
  3. Der Browser empfängt die Antwort von serving-adtech.example und parst den Attribution-Reporting-Register-Source-Header. Das Quellereignis wird im Browser gespeichert. Als Quelle der Berichterstellung verwendet serving-adtech.example.
  4. Da es sich bei dieser Anfrage um eine Weiterleitung handelt, sendet 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 Attribution-Reporting-Register-Source. Das Quellereignis wird im Browser gespeichert. Als Quelle der Berichterstellung verwendet 3p-measurement.example.

attributionsrc für Drittanbieterursprünge verwenden, die sich nicht in einer Weiterleitungskette befinden

Wenn mehrere Melder eine Quelle bei einem Navigationsereignis registrieren möchten, aber aus irgendeinem Grund nicht in einer Weiterleitungskette aufgeführt werden können, können Sie in attributionsrc als alternative Lösung mehrere Websites als Attributionsquellen auflisten.

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 infrage kommen, sowohl an REPORTING_URL_1 als auch an REPORTING_URL_2 gesendet. Die an die Klick-URL gesendete Navigationsanfrage kann ebenfalls Attributionsquellen registrieren.

Schritt 3: Antworten auf Attribution Reporting API-Anfragen einrichten

Für alle Ursprünge, die eine Attribution Reporting API-Anfrage erhalten, muss der Server mit dem entsprechenden Attribution-Reporting-Register-Source-Header antworten. Im Leitfaden zum Registrieren von Quellen und in der Erklärung erfahren Sie, wie die Antwort aufgebaut sein sollte.

Mehrere Trigger registrieren

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

Sie können auch mehrere Trigger von einem einzelnen Pixelelement aus registrieren, indem Sie Weiterleitungsanfragen verwenden oder mehrere URLs im attributionsrc-Element auf dieselbe Weise wie für die Quellenregistrierung auflisten. Quell- und Triggerereignisse, die von denselben Ursprüngen generiert wurden, werden abgeglichen.