Conversion-Analyse aktivieren

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:

  1. 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.

  2. Ü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 attributionsrc mehrere AdTech-Server auflisten.

 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 Argument windowFeatures des Aufrufs window.open 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 und der Anbieter für Messungen.
    • Vom <img>-Tag oder <script>-Tag ausgelöste Impressionsereignisse müssen ein attributionsrc-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.

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

Ein Diagramm, das beschreibt, wie der Erstanbieter die Quelle und anschließend der Drittanbieter die Quelle registriert.

Bei der Registrierung der Quelle werden folgende Schritte ausgeführt:

  1. serving-adtech.example legt das Attribut attributionsrc 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 dem Header Attribution-Reporting-Register-Source und dem Header Location.
    1. serving-adtech.example verwendet den Header Attribution-Reporting-Register-Source, um mit 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 bereits in Ihren bestehenden Klick-Tracking-Abläufen verwendet, um 302-Weiterleitungen zu einem Drittanbieter zu unterstützen.
  3. Der Browser empfängt die Antwort von serving-adtech.example und parst den Attribution-Reporting-Register-Source-Header. Im Browser wird das Quellereignis gespeichert und serving-adtech.example als Ausgangspunkt für die Berichterstellung verwendet.
  4. Da es sich bei dieser Anfrage um eine Weiterleitung handelt, sendet der Browser ebenfalls 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. Im Browser wird das Quellereignis gespeichert und 3p-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.