Diese Seite wurde von der Cloud Translation API übersetzt.

Attributionsquellen registrieren

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

Eine Attributionsquelle ist ein anzeigenbezogenes Ereignis (Klick oder Aufruf), an das ein Anzeigentechnologie-Anbieter die folgenden Arten von Informationen anhängen kann:

Kontextbezogene Berichtsdaten wie die Anzeigen-Creative-ID, Informationen zur Kampagne oder Geografie.
Ein Conversion-Ziel, z. B. auf der Website, auf der Sie eine Conversion erwarten.

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

Registrierungsmethoden

Verwenden Sie HTML-Elemente oder JavaScript-Aufrufe, um Attributionsquellen zu registrieren:

<a>-Tag
<img>-Tag
<script>-Tag
fetch Anruferweiterung
XMLHttpRequest
window.open Anruferweiterung

Dadurch werden Netzwerkanfragen generiert, auf die Sie dann mit einer Quelle antworten. HTTP-Antwortheader für die Registrierung.

Quellen für Klicks oder Aufrufe registrieren

So registrieren Sie eine Attributionsquelle für Klicks oder Aufrufe: Führen Sie die vollständigen Schritte aus. Hier ist eine Zusammenfassung:

Starten Sie die Quellregistrierung. Verwenden Sie ein HTML-Element oder ein JavaScript-Aufruf, um eine Anfrage zu senden. Dieser Schritt unterscheidet sich bei Klicks und Aufrufen, wie in den folgenden Abschnitten beschrieben wird.

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

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 oder JavaScript-Aufrufe zum Registrieren von Quellen verwenden, muss möglicherweise attributionsrc verwenden oder attributionReporting. In der folgenden Tabelle finden Sie Details dazu, erforderlich.

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

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

Schritt 1: Quellenregistrierung initiieren

Schritt 1 unterscheidet sich in Bezug auf Klicks und Aufrufe.

Um eine Attributionsquelle für einen Klick zu registrieren, können Sie ein <a>-Tag oder JavaScript verwenden. window.open().

Anker verwenden

Fügen Sie attributionsrc zu 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");

Damit diese Methode berücksichtigt wird, muss sie innerhalb von 5 Sekunden nach der Nutzerinteraktion aufgerufen werden.

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">Click me</a>

Wenn du im JavaScript-Beispiel attributionsrc einen Wert vorgibst, um diese URL zu codieren, falls sie Sonderzeichen wie = enthält, die der Parameter falsch geparst wird.

So codieren:

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 annehmen, wie hier mit einem <a>-Tag veranschaulicht:

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

oder hier mit window.open().

window.open("...", "_blank", `attributionsrc=${encodedUrl1}
  attributionsrc=${encodedUrl2}`)

In solchen Fällen erhalten beide URLs ein für die Navigationsquelle geeignetes attributionsrc. -Anfragen (Anfragen, die den Attribution-Reporting-Eligible-Header enthalten).

`attributionsrc` mit oder ohne Wert

Wie Sie bereits gesehen haben, können Sie attributionsrc ohne URL angeben. Sie können auch eine . Außerdem können Sie eine durch Leerzeichen getrennte Liste von URLs verwenden.

Die Verwendung von URLs führt dazu, dass der Browser eine separate Keepalive-Abrufanfrage initiiert. für jede URL, einschließlich der Attribution-Reporting-Eligible-Anfrage Header.

Dies ist nützlich, wenn Sie die Quellenregistrierung durch Antworten auf eine -Anforderung getrennt von der Hauptanfrage des Elements.

Wenn Sie beispielsweise Quellen für Klicks auf ein Ankerelement registrieren müssen, Sie haben möglicherweise keine Kontrolle über das Ziel. sollten Sie in diesem Fall Eine Konfiguration, bei der Sie den Quellregistrierungsheader als Antwort auf eine Anfrage senden die unabhängig von der Navigation ist und die vollständig von Ihnen gesteuert werden kann. Von expliziten Wert für attributionsrc angeben, weisen Sie den um diese zusätzliche Anfrage zu senden und das Ziel zu konfigurieren.

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 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=..."></script>

Optional können Sie einen URL-Wert für attributionsrc auf dieselbe Weise wie für Klicks, Das heißt, Sie können für ein Bild oder Skript die attributionsrc-URL(s) so festlegen:

Mit einer einzelnen URL:

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

Mit einer Liste von URLs:

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

`fetch()` oder `XMLHttpRequest()` verwenden

Dieser Code simuliert effektiv die Vorgehensweise einer HTML-Anfrage mit attributionsrc:

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 });

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

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

Schritt 2: Mit Header antworten (Klicks und Aufrufe)

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