Conversion-Analyse aktivieren

Bei der Conversion-Attributionsanalyse können mehrere Parteien beteiligt sein, darunter Publisher, Werbetreibende, Ad-Serving-Technologie (die Einheit, die die Anzeige ausliefert) und Analyseanbieter. In diesem Dokument werden gängige Szenarien für die Conversion-Analyse beschrieben. Grundsätzlich muss jedoch jede Partei, die einen Attributionsbericht von der Attribution Reporting API (ARA) erhalten möchte, darauf achten, dass die in diesem Dokument beschriebenen Integrationsschritte ausgeführt werden.

So ist es beispielsweise üblich, dass ein Publisher einen oder mehrere AdTech-Anbieter hat, die für die Auslieferung der Anzeige verantwortlich sind. Dazu können Parteien gehören, die das Markup für das Creative bereitstellen, die Parteien, die das Impression- oder Tracking-Pixel im Creative bereitstellen, und die Parteien, die das SDK oder Tag für die Anzeigenfläche auf der Publisher-Seite bereitstellen. Diese Anzeigentechnologien möchten möglicherweise Attributionsberichte von ARA erhalten, sind aber so positioniert, dass nachgelagerte Anzeigentechnologien Attributionsberichte erhalten können.

Außerdem verwendet der Werbetreibende möglicherweise einen Drittanbieter für die Conversion-Analyse für die netzwerkübergreifende Attribution sowie andere Berichtsfunktionen. Werbetreibende nutzen diese Daten, um den Return on Advertising Investment (ROAS) über mehrere eindeutige Publisher und Channels hinweg zu analysieren. Daher ist es wichtig, dass DSPs oder Ad-Server wissen, wie die Attribution Reporting API aktiviert wird, um diese Anwendungsfälle zu unterstützen. Werbetreibende, die einen Drittanbieter nutzen möchten, können dies weiterhin tun. Sie können entweder einen Drittanbieter für die Analyse verwenden oder einen internen Server einrichten, um Berichte über die API zu registrieren und zu empfangen.

Mit der Attribution Reporting API können mehrere Anbieter von Anzeigentechnologien Attributionsquellen und Trigger für dieselbe Impression oder Conversion registrieren und separate Berichte von der API erhalten. Eine DSP kann beispielsweise eigene Attributionsberichte von der Attribution Reporting API erhalten und separate Berichte für den Drittanbieter für Messungen des Werbetreibenden zulassen. Ein AdTech-Unternehmen muss sowohl Attributionsquellen als auch Trigger registrieren, um Berichte von der API zu erhalten. Die Attribution erfolgt zwischen den Attributionsquellen und Triggern, die das AdTech-Unternehmen 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 betrachtet.

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

Ein Werbetreibender möchte Conversions für Anzeigeninventar mithilfe eines Drittanbieters für die Analyse zuordnen und die Ad-Tech, 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 (3PAS) der Fall, die das Markup für Anzeigen-Creatives bereitstellen, eigene Attributionsberichte erstellen und mit Werbetreibenden zusammenarbeiten, die in Drittanbieter für Messungen oder Analysen eingebunden sind.

In diesem Fall ist die Ad-Serving-Technologie auch für das Auslösen von Klick- und Impressionenereignissen in der aktuellen Konfiguration verantwortlich. Die Ad-Serving-Technologie sollte das neue attributionsrc an den entsprechenden Stellen festlegen und prüfen, ob die Weiterleitungen richtig konfiguriert sind. Sowohl die AdTech-Lösung für die Anzeigenbereitstellung als auch der Drittanbieter für die Analyse sollten prüfen, ob sie registriert sind und ihre Server bereit sind, Anfragen der Attribution Reporting API zu empfangen und darauf zu reagieren.

Eine typische Kampagneneinrichtung könnte so aussehen:

  1. Der Ad-Server des Werbetreibenden (3PAS) stellt dem DSP das Markup für das Anzeigen-Creative zur Verfügung, das die Impressionen- und Klick-Tracking-Pixel des Drittanbieters für die Analyse enthält. Der Ad-Server sollte dafür sorgen, dass attributionsrc im Markup des Anzeigen-Creatives enthalten ist.

  2. Die DSP bietet die Möglichkeit, zusätzliche Impression- und Klick-Tracking-Pixel hinzuzufügen. Außerdem muss dafür gesorgt werden, dass attributionsrc im endgültigen Creative-Markup enthalten ist, mit dem Gebote abgegeben werden.

Szenario 2: Nur der Drittanbieter für Analysen muss Berichte von der Attribution Reporting API erhalten.

Ein Werbetreibender möchte Conversions für Anzeigeninventar mithilfe eines Drittanbieters für Analysen zuordnen. Die Ad-Tech-Plattform, auf der das Creative gehostet wird, hat jedoch keine Anforderungen für die Zuordnungsmessung. Das ist üblich für Publisher, SSPs oder Publisher-Ad-Server, die Creatives hosten und die Attribution Reporting API nicht selbst verwenden möchten, aber die API entweder für ihre DSP-Partner oder für Unternehmen mit Messungs-Tagging wie Drittanbieter-Ad-Server, Mess- oder Analyseanbieter aktivieren möchten.

In diesem Fall muss die Partei, die für das Auslösen von Klick- und Impression-Ereignissen in der aktuellen Einrichtung verantwortlich ist, das neue attributionsrc-Attribut zu Creatives hinzufügen und überprüfen, ob Weiterleitungen wie vorgesehen funktionieren. Das hängt stark von der Integration des jeweiligen Publishers ab. Bei Klickereignissen kann das die SSP, die Ad-Serving-Technologie oder der Publisher selbst sein. Bei Impressionen ist das in der Regel der Drittanbieter für Analysen.

Im Beispiel für die typische Kampagneneinrichtung aus Szenario 1 müssen der Ad-Server des Publishers, die SSP oder der Publisher selbst möglicherweise nur das attributionsrc-Attribut überprüfen, das von der DSP bereitgestellt wurde.

Implementierungsdetails

In der folgenden Tabelle werden die Implementierungsschritte für die Attribution Reporting API auf hoher Ebene beschrieben:

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

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. Das hängt von der Einrichtung des Publishers ab.

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

Wenn keine 302-Weiterleitungen verwendet werden können, kann das Attribut attributionsrc verwendet werden, um mehrere Ad-Tech-Server aufzulisten.

 Solange das Attribut attributionsrc dem Creative hinzugefügt wird, sollten die Drittanbieterweiterleitungen die Attribution Reporting API-Aufrufe erhalten.
Schritt 3: Antworten für Attribution Reporting API-Anfragen einrichten Jede Einheit, die Berichte von der Attribution Reporting API erhalten möchte Die vom Werbetreibenden verwendete DSP und der Drittanbieter für Analysen

Die Details der einzelnen Schritte hängen davon ab, wie Creatives auf der Publisher-Seite gerendert und ausgeliefert werden und welche Ad-Tech-Einheiten 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 attributionsrc-Attribut wird angegeben, wohin die Anfragen der Attribution Reporting API gesendet werden. Die Einheit, die für das Auslösen von Impressions- und Klickereignissen verantwortlich ist, muss Creatives mit dem Attribut attributionsrc aktualisieren. Der attributionsrc sollte vorhandenen Klick- und Impressionenereignissen hinzugefügt werden und kann leer oder nicht leer sein.

Bei Klickereignissen mit Weiterleitungen sollte das Attribut attributionsrc der Navigation hinzugefügt werden. Bei 302-Weiterleitungen nach der Navigation muss das Attribut attributionsrc nicht hinzugefügt werden. Sie sind für ARA geeignet, sofern bei der ursprünglichen Navigation attributionsrc hinzugefügt wurde.

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

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

Beispiel für ein leeres attributionsrc-Attribut:

Ihre aktuelle 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 Anker-Tags definiert wird.

Beispiel für ein „attributionsrc“-Attribut, das nicht leer ist:

Ihre aktuelle 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 wird. Die Klick-URL kann auch zum Registrieren von Quellen verwendet werden.

attributionsrc für Klick- und Impressionsereignisse hinzufügen

  • Klickereignisse:
    • Die für das Hinzufügen von attributionsrc verantwortliche Einheit ist in der Regel die Ad-Tech-Plattform für die Anzeigenbereitstellung.
    • Ankertags mit Click-Events sollte ein attributionsrc-Attribut hinzugefügt werden.
    • Bei Klicks mit window.open sollte das Argument windowFeatures des window.open-Aufrufs verwendet werden, um die Attributionsquelle anzugeben.
  • Impressionsereignisse:
    • Die für das Hinzufügen von attributionsrc verantwortliche Einheit ist in der Regel die Ad-Tech-Lösung für die Anzeigenbereitstellung und der/die Anbieter von Analysen.
    • Impressionsereignisse, die über das <img>-Tag oder das <script>-Tag ausgelöst werden, sollten ein attributionsrc-Attribut enthalten.
    • Bei Impression-Ereignissen, die mit der Fetch API gesendet werden, muss im options-Argument, 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 Impressionsereignisse erforderlich sind:

Ereignis Tag Ihre aktuelle 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-Tag <img> <img src="[IMPRESSION_URL]"> <img src="[IMPRESSION_URL]" attributionsrc>
HTML-Tag <script> <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 einer Protected Audience-Auktion erfassen möchten, können Sie anstelle von attributionsrc die APIs registerAdBeacon/registerAdMacro und setReportEventDataForAutomaticBeacons/reportEvent verwenden, um Attributionsquellen zu registrieren.

Für das Melden von Protected Audience-Signalen ist die Funktion registerAdBeacon in Reporting-Worklets und registerAdMacro im Win-Reporting-Worklet des Käufers verfügbar. Die Ereignisdaten im Anzeigenframe können dann 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-Reporting-Worklets und die Nutzlast des Ereignisses für den Anzeigencreative-Frame miteinander verknüpft 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 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 Analysen von Drittanbietern zu ermöglichen.

Weitere Informationen finden Sie im Abschnitt Support for Attribution Reporting (Unterstützung für Attribution Reporting) im Explainer zur Fenced Frame Ad Reporting API.

Attributionsberichte für VAST-Formate aktivieren

VAST ist ein gängiges Format für die Bereitstellung und Analyse 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. Das VAST-Addendum für die Unterstützung von Attributionsberichten enthält dazu detaillierte Informationen. Kurz gesagt: Alle <Tracking>-, <Impression>-, <*ClickThrough>- und <*ClickTracking>-Ereignisse sind potenzielle Attributionsquellenereignisse. Alle VAST-Implementierungen sollten die Registrierungsberechtigung für diese Ereignisse abdecken.

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

Um eine maximale Abdeckung zu erreichen, sollten VAST-Implementierungen standardmäßig alle aufgeführten Ereignisse für die Registrierung infrage kommen lassen, wenn Ereignispings ausgelöst werden. Wenn Sie beispielsweise eine <Impression>-Ereignis-URL auslösen, sollte das (leere) Attribut attributionsrc für das <img>-Element verwendet werden, mit dem die Anfrage gesendet wird (oder das Äquivalent für den Fetch-Aufruf), damit die empfangende Partei dieses Ereignis immer mit der Attribution Reporting API registrieren kann.

Schritt 2: Attribution Reporting für Drittanbieter-Quellen aktivieren

Damit Drittanbieter die Attribution Reporting API verwenden 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 Ad-Tech-Lösung einen eigenen unabhängigen Impressionstracker. Weiterleitungen sind daher eher für Klick-Tracker relevant.

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 kann mit der Attribution Reporting API registriert werden, wenn das ursprüngliche Klickziel mit attributionsrc annotiert oder mit registerAdBeacon/registerAdMacro in der Protected Audience API registriert wurde. Die Ad-Tech-Unternehmen in der Weiterleitungskette müssen ebenfalls registriert sein.

Beachten Sie, dass der Text der ursprünglichen Anfrage bei Weiterleitungen nicht gesendet wird. Wenn eventData für Protected Audience-Auktionen 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 Ad-Tech-Plattform für die Anzeigenbereitstellung (serving-adtech.example) und einen Drittanbieter für Analysen (3p-measurement.example) als zwei separate Einheiten, die Attributionsberichte erstellen und empfangen möchten. Die AdTech-Lösung für die Auslieferung in diesem Beispiel kann eine DSP sein, die das Creative auf der Publisher-Website rendert und ein eigenes Berichtsprodukt hat. Der Drittanbieter für Analysen kann ein Unternehmen sein, das der Werbetreibende für Conversion-Berichte verwendet.

Ein Diagramm, das beschreibt, wie die Quelle vom Erstanbieter registriert wird.
Beispiel für die Funktionsweise der Conversion-Analyse mit einem Drittanbieter

Bei der Quellregistrierung werden die folgenden Schritte ausgeführt:

  1. Mit serving-adtech.example wird das Attribut attributionsrc im Creative festgelegt. Der Nutzer ruft die Verlags- oder Webpublisherseite auf 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 Attribution-Reporting-Register-Source-Header, um mit Metadaten zur zu registrierenden Quelle zu antworten.
    2. serving-adtech.example verwendet den Header Location, um eine Weiterleitung zu 3p-measurement.example einzuschließen. Wahrscheinlich wird der Header Location bereits in Ihren vorhandenen Klick-Tracking-Abläufen verwendet, um 302-Weiterleitungen an einen Drittanbieter zu unterstützen.
  3. Der Browser empfängt die Antwort von serving-adtech.example und parst den Attribution-Reporting-Register-Source-Header. Der Browser speichert das Quellereignis und verwendet serving-adtech.example als Ursprung des Berichts.
  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 die Attribution-Reporting-Register-Source. Der Browser speichert das Quellereignis und verwendet 3p-measurement.example als Ursprung des Berichts.

attributionsrc für Drittanbieterursprünge verwenden, die nicht Teil einer Weiterleitungskette sind

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

Ihre aktuelle 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. Für die Navigationsanfrage, die an die Klick-URL gesendet wird, können auch Attributionsquellen registriert werden.

Schritt 3: Antworten für Attribution Reporting API-Anfragen einrichten

Prüfen Sie für alle Ursprünge, die eine Attribution Reporting API-Anfrage erhalten, ob der Server mit dem entsprechenden Attribution-Reporting-Register-Source-Header antwortet. Informationen dazu, wie die Antwort aufgebaut sein sollte, finden Sie im Leitfaden zum Registrieren von Quellen und in der Erklärung.

Mehrere Trigger registrieren

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

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