Diese Seite wurde von der Cloud Translation API übersetzt.

Attributionstrigger registrieren

Hier erfahren Sie, wie Sie Attributionstrigger zum Zählen Ihrer Conversions registrieren.

Ein Attributionstrigger ist das Ereignis, mit dem der Browser angewiesen wird, Conversions zu erfassen.

Anhand der Schritte in diesem Dokument können Sie Trigger zur Registrierung von Conversions registrieren, die der Browser dann den relevanten Quellereignissen zuordnet, nämlich Anzeigenimpressionen oder Anzeigenklicks.

Registrierungsmethoden

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

<img>-Tag
<script>-Tag
fetch Anruferweiterung
XMLHttpRequest

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

Registrieren Sie einen Trigger, um eine Conversion zuzuordnen

Die Registrierung eines Triggers ähnelt der ein Ereignis der Attributionsquelle registrieren. Die abschließenden Schritte werden weiter unten beschrieben. Hier ist eine Zusammenfassung:

Initiieren Sie die Triggerregistrierung. Pixel oder fetch()-Aufruf verwenden, um einen Antrag stellen.
Schließen Sie die Triggerregistrierung ab, indem Sie mit dem Trigger antworten. Registrierungsheader.

Nach Empfang der Pixelanfrage wird sie entweder an den Endpunkt, der im üblichen src-Attribut definiert ist, oder bis zu dem festgelegten Endpunkt in attributionsrc, wenn Sie attributionsrc verwenden und einen Wert haben, antworten Sie mit der Kopfzeile Attribution-Reporting-Register-Trigger.

Geben Sie in diesem Header die Triggerdaten an, in denen angezeigt werden soll, besser zu verstehen. Jede Antwort kann diesen Header festlegen. Solange es ein Antwort auf eine Anfrage von einer Website, die mit destination übereinstimmt, werden abgeglichen. Wenn der Header empfangen wird, nach übereinstimmenden Quellen sucht und einen Bericht plant.

Beispiel für Berichte auf Ereignisebene:
```
{
  "event_trigger_data": [{
    "trigger_data": "[unsigned 64-bit integer]",
    "priority": "[signed 64-bit integer]",
    "deduplication_key": "[unsigned 64-bit integer]"
  }]
}
```
Beispiel für zusammenfassende Berichte:
```
{
  ... // existing fields, such as "event_trigger_data"

  "aggregatable_trigger_data": [
   {
     "key_piece": "0x400",
     "source_keys": ["campaignCounts"]
   },
   {
     "key_piece": "0xA80",
     "source_keys": ["geoValue", "nonMatchingKeyIdsAreIgnored"]
   }
  ],
  "aggregatable_values": {
    "campaignCounts": 32768,
    "geoValue": 1664
  }
}
```

Hinweis:Wenn der Browser eine Attributionstrigger-Antwort von einer attributionsrc-URL auf einer bestimmten Seite erhält, wird eine lokale Speichersuche durchgeführt, um eine Quelle zu finden, die sowohl dem attributionsrc-Ursprung als auch der Zielwebsite dieser Seite entspricht. Wenn mehrere Quellen gefunden werden, wählt der Browser die zuletzt gespeicherte Quelle aus – es sei denn, die Quellen haben unterschiedliche Prioritäten, bei denen der Browser diejenige mit der höchsten Priorität auswählt.

Umgang mit Sub-Domains

Wenn destination den Wert https://advertiser.example hat, sind die Conversions auf beiden Plattformen https://advertiser.example und seine Subdomains, z. B. https://shop.advertiser.example, können zugeordnet werden.

Wenn destination den Wert https://shop.advertiser.example hat, werden sowohl auf https://advertiser.example als auch auf https://shop.advertiser.example kann zugeordnet werden.

Erforderliche und optionale Attribute

Wenn Sie zum Registrieren von Triggern HTML-Elemente oder JavaScript-Aufrufe 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	Trigger
`<a>`-Tag	Nicht zutreffend: Anker können keinen Trigger registrieren.
`<img>`-Tag	`attributionsrc` ist optional. Der Header um einen Trigger zu registrieren.
`<script>`-Tag	`attributionsrc` ist optional. Der Header um einen Trigger zu registrieren.
`fetch` Anruferweiterung	Die Option `attributionReporting` ist erforderlich.
`XMLHttpRequest`	Die Option `attributionReporting` ist erforderlich.
`window.open()`	–:`window.open` kann keinen Trigger registrieren.

Schritt 1: Triggerregistrierung initiieren

Sie können einen Trigger mit einem Pixel-Tag (<img>-Tag) oder einem Skript-Tag registrieren.

Neues oder vorhandenes Conversion-Pixel verwenden

Im folgenden Beispiel wird die Attribution für ein vorhandenes Bild ausgelöst, indem das Attribut attributionsrc hinzugefügt wird.

Der Ursprung für attributionsrc muss mit dem Ursprung übereinstimmen, der die Quellenregistrierung durchgeführt hat.

<img src="https://advertiser.example/conversionpixel"
     attributionsrc="https://adtech.example/attribution_trigger?purchase=13">

Im nächsten Beispiel wird die Attribution ausgelöst, indem das neue Attribut attributionsrc für Conversion-Pixel hinzugefügt wird.

Der Ursprung für src muss mit dem Ursprung übereinstimmen, der die Quellenregistrierung durchgeführt hat.

<img src="https://adtech.example/conversionpixel"
     attributionsrc>

Script-Tag verwenden

Sie können eine Triggerregistrierung mit einem Skript-Tag durchführen. verhält es sich genauso wie <img>. Die folgenden Codebeispiele veranschaulichen die Verwendung von fetch() und XMLHttpRequest() (XHR).

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

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

// 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: false,
  triggerEligible: true,
};

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

`attributionsrc` mit oder ohne Wert

Sie können attributionsrc mit oder ohne Wert hinzufügen.

<!-- Without a value -->
<img src="..." width="1" height="1" attributionsrc>

<!-- With a value (URL) -->
<img src="..." width="1" height="1" attributionsrc="https://...">

Wenn Sie einen Wert für attributionsrc festlegen, kann es sich um eine oder mehrere durch Leerzeichen getrennte URLs handeln.

Die Verwendung einer URL 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 Triggerregistrierung vornehmen möchten, indem Sie auf einen -Anforderung getrennt von der Hauptanfrage des Elements.

Wenn Sie z. B. Trigger für ein Bildelement registrieren müssen, Sie haben möglicherweise keine Kontrolle über die Bildantwort. sollten Sie in diesem Fall Eine Konfiguration, bei der Sie den Registrierungs-Header für den Trigger als Antwort auf eine Anfrage senden das vom Bild getrennt ist und die volle Kontrolle hat. Von expliziten Wert für attributionsrc angeben, weisen Sie den um diese zusätzliche Anfrage zu senden und das Ziel zu konfigurieren.

Schritt 2: Mit einer Kopfzeile antworten

Nachdem Sie die Browseranfrage erhalten haben, antworten Sie und fügen Sie in Ihrer Antwort den Attribution-Reporting-Register-Trigger-Header ein:

JSON.stringify({
  event_trigger_data: [{
    trigger_data: "412444888111012",
    // Optional
    priority: "1000000000000",
    deduplication_key: "2345698765"
  }],
  debug_key: "1115698977"
});

Achtung:Der Feldwert event_trigger_data muss in eckigen Klammern verschachtelt sein, da der Browser ein JSON-Array erwartet. Dies ist nützlich für Filter.

Nächste Schritte

Weitere Informationen zum Registrieren von Attributionsquellen