Attributionsquellen registrieren

Hier erfahren Sie, wie Sie Quellen registrieren, um Klicks und Aufrufe den entsprechenden Ereignissen zuzuordnen.

Eine Attributionsquelle ist ein anzeigenbezogenes Ereignis (ein Klick oder Aufruf), dem ein Anzeigentechnologie-Mitarbeiter die folgenden Informationen zuordnen kann: – Kontextbezogene Berichtsdaten, z. B. die Creative-ID, Informationen zur Kampagne oder Geografie. - Ein Conversion-Ziel, also die Website, auf der Sie vom Nutzer eine Conversion erwarten.

Anhand der Schritte in diesem Dokument können Sie Quellen wie Anzeigenimpressionen oder Klicks registrieren, denen der Browser dann Conversions zuordnet.

Registrierungsmethoden

Verwenden Sie zum Registrieren von Attributionsquellen HTML-Elemente oder JavaScript-Aufrufe:

  • <a>-Tag
  • <img>-Tag
  • <script>-Tag
  • fetch Anruf-Asset
  • XMLHttpRequest
  • window.open

Dadurch werden Netzwerkanfragen generiert, auf die Sie dann mit einem HTTP-Antwortheader für die Quellregistrierung antworten.

Quellen für Klicks oder Aufrufe registrieren

So registrieren Sie eine Attributionsquelle für Klicks oder Aufrufe: Folgen Sie den vollständigen Schritten. Hier ist die Zusammenfassung:

  1. Initiieren Sie die Quellregistrierung. Verwenden Sie ein HTML-Element oder einen JavaScript-Aufruf, um eine Anfrage zu stellen. Dieser Schritt unterscheidet sich für Klicks und Aufrufe. Wie Sie in den folgenden Abschnitten feststellen werden,

  2. Schließen Sie die Registrierung der Quelle ab, indem Sie mit dem Registrierungsheader der Quelle antworten. Antworten Sie nach dem Empfang dieser Anfrage mit dem Header Attribution-Reporting-Register-Source. Geben Sie in diesem Header die gewünschte Konfiguration für Attribution Reporting an. Dieser Schritt ist für Klicks und Aufrufe identisch.

    Beispiel für zusammenfassende Berichte:

    {
  "aggregation_keys": {
    "campaignCounts": "0x159", 
    "geoValue": "0x5" 
  },
  "aggregatable_report_window": "86400",
  "destination": "https://example.com"
}

    Beispiel für Berichte auf Ereignisebene:

    {
  "source_event_id": "12340873456",
  "destination": "[eTLD+1]",
  "expiry": "[64-bit signed integer]",
  "priority": "[64-bit signed integer]",
  "event_report_window": "[64-bit signed integer]"
}

Erforderliche und optionale Attribute

Wenn Sie HTML-Elemente verwenden oder JavaScript-Aufrufe zum Registrieren von Quellen ausführen, müssen Sie möglicherweise attributionsrc oder attributionReporting verwenden. In der folgenden Tabelle finden Sie Details dazu, wann diese erforderlich sind.

Wenn attributionsrc optional ist, bedeutet dies, dass die Anfrage für Attributionsberichte infrage kommt. Wenn Sie attributionsrc verwenden, sendet der Browser den Header Attribution-Reporting-Eligible. Dies ist auch für die Messung von App zu Web nützlich: Wenn attributionsrc vorhanden ist, sendet der Browser den Header Attribution-Reporting-Support.

Registrierungsmethode Quelle
<a>-Tag (Navigationsquelle)
attributionsrc ist erforderlich.
<img>-Tag (Ereignisquelle)
attributionsrc ist erforderlich.
<script>-Tag (Ereignisquelle)
attributionsrc ist erforderlich.
fetch Anruf-Asset Die Option attributionReporting ist erforderlich.
XMLHttpRequest Die Option attributionReporting ist erforderlich.
window.open() (Navigationsquelle)
attributionsrc ist erforderlich.

Schritt 1: Quellenregistrierung initiieren

Der erste Schritt ist für Klicks und Aufrufe unterschiedlich. Öffnen Sie jeweils die entsprechenden Tabs.

Wenn Sie eine Attributionsquelle für einen Klick registrieren möchten, können Sie ein <a>-Tag oder die JavaScript-Funktion window.open() verwenden.

Anker verwenden

Fügen Sie attributionsrc den vorhandenen <a>-Tags hinzu, für die Sie Impressionen oder Klicks messen möchten:

<a href="https://shoes.example/..." 
  attributionsrc>Click me</a>

Weitere Informationen finden Sie im Beispielcode.

Skript verwenden

window.open() mit attributionsrc anrufen:

window.open(
  "https://shoes.example/...",
  "_blank",
  "attributionsrc");

Diese Methode muss innerhalb von 5 Sekunden nach der Nutzerinteraktion aufgerufen werden, damit sie berücksichtigt werden kann.

Anstatt attributionsrc allein hinzuzufügen, können Sie für ein Bild oder Skript einen einzelnen URL-Wert angeben:

<a href=... attributionsrc="https://a.example/register-source">

Wenn Sie im JavaScript-Fall einen Wert für attributionsrc angeben, müssen Sie die URL codieren, falls sie Sonderzeichen wie „=“ enthält, die ein nicht ordnungsgemäßes Parsen des Parameters verursachen könnten.

So codieren Sie die Codierung: 

const encodedUrl = encodeURIComponent(
  'https://adtech.example/attribution_source?ad_id=...');
window.open(
  "https://shoes.example/landing",
   "_blank",
   attributionsrc=${encodedUrl});

attributionsrc kann auch eine durch Leerzeichen getrennte Liste von URLs enthalten, wie hier mit einem Anchor-Tag veranschaulicht:

<!-- With an anchor tag -->
<a href=... attributionsrc="https://a.example/register-source 
  https://b.example/register-source">

oder wie hier mit window.open() angezeigt wird.

// With window.open()
window.open('...', '_blank', attributionsrc=${encodedUrl1}
  attributionsrc=${encodedUrl2})

In solchen Fällen erhalten beide URLs navigation-source-eligible-attributionsrc-Anfragen (Anfragen, die den Header Attribution-Reporting-Eligible enthalten).

attributionsrc mit oder ohne Wert

Wie Sie bereits gesehen haben, können Sie attributionsrc ohne URL angeben. Sie können auch eine einzelne URL angeben. Außerdem können Sie nur für Quellen (gilt nicht für Trigger) eine durch Leerzeichen getrennte Liste von URLs verwenden.

Wenn Sie URLs verwenden, initiiert der Browser eine separate Keepalive-Abrufanfrage für jede URL, die den Attribution-Reporting-Eligible-Anfrageheader enthält.

Dies ist nützlich, wenn Sie die Quellregistrierung durch Antworten auf eine Anfrage vornehmen möchten, die von der Hauptanfrage des Elements getrennt ist.

Wenn Sie beispielsweise Quellen für Klicks auf ein Anchor-Element registrieren müssen, haben Sie möglicherweise keine Kontrolle über das Ziel. In diesem Fall benötigen Sie eine Konfiguration, bei der Sie den Quellregistrierungsheader als Antwort auf eine Anfrage senden, die von der Navigation getrennt ist und die Sie vollständig steuern können. Wenn Sie einen expliziten Wert für attributionsrc angeben, weisen Sie den Browser an, diese zusätzliche Anfrage zu senden und sein Ziel zu konfigurieren.

Um den ersten Schritt zum Registrieren von Ansichten zu erhalten, wechseln Sie zu den Tabs und wählen Sie "Ansichten" aus Schritt 1.

Um eine Attributionsquelle für eine Ansicht zu registrieren, können Sie ein Bild- oder Skript-Tag verwenden, dem Sie das Attribut attributionsrc hinzufügen.

Alternativ können Sie das JavaScript fetch() oder XMLHttpRequest() verwenden.

Mit einem Bild

<img attributionsrc
src="https://adtech.example/attribution_source?ad_id=..."/>

Mit einem Skript

<script attributionsrc
  src="https://adtech.example/attribution_source?ad_id=..."/>

Optional können Sie einen URL-Wert für attributionsrc genauso wie für Klicks angeben. Das heißt, für ein Bild oder Skript können Sie die attributionsrc-URL oder URLs so festlegen:

Mit einer einzelnen URL:

 attributionsrc="https://adtech.example/attribution_source?ad_id=123"

Mit einer Liste von URLs:

  attributionsrc="https://a.example/register-source
    https://b.example/register-source"

fetch() oder XMLHttpRequest() verwenden

Dieser Code simuliert effektiv, was eine HTML-Anfrage mit attributionsrc tun würde:

// With fetch
const attributionReporting = {
  eventSourceEligible: true,
  triggerEligible: false,
};

// Optionally set keepalive to ensure the request outlives the page.
window.fetch("https://adtech.example/attribution_source?my_ad_id=123", { 
  keepalive: true, attributionReporting });

// With XHR
const attributionReporting = {
  eventSourceEligible: true,
  triggerEligible: false,
};

const req = new XMLHttpRequest();
  req.open('GET', url);
  req.setAttributionReporting(
    attributionReporting);
  req.send();

Rufen Sie für Schritt 1 zum Registrieren von Klicks die Tabs auf und wählen Sie „Klicks“ > Schritt 1 aus.

Schritt 2: Mit Kopfzeile antworten (Klicks und Aufrufe)

Der nächste Schritt für Klicks und Aufrufe besteht darin, mit dem Header Attribution-Reporting-Register-Source zu antworten.

Weitere Informationen finden Sie im Beispielcode.

Antworten Sie nach dem Empfang der Browseranfrage auf dem Server und fügen Sie den Header Attribution-Reporting-Register-Source in Ihre Antwort ein.

 res.set(
  'Attribution-Reporting-Register-Source',    
  JSON.stringify({
    // Use source_event_id to map it to any granular information
      // you need at ad-serving time
      source_event_id: '412444888111012',
      destination: 'https://advertiser.example',
      // Optional fields
      expiry: '604800',
      priority: '100',
      debug_key: '122939999'
    })
 );

Nach der Zeichenfolge sieht Ihr Header so aus:

{"source_event_id":"412444888111012","destination":"https://advertiser.example","expiry":"604800","priority":"100","debug_key":"122939999"}

Nächste Schritte

Weitere Informationen zum Registrieren von Attributionstriggern