Attributionstrigger registrieren

Hier erfahren Sie, wie Sie Attributionstrigger registrieren, um Ihre Conversions zu erfassen.

Ein Attributions-Trigger ist das Ereignis, das dem Browser signalisiert, dass Conversions erfasst werden sollen.

Wenn Sie die Schritte in diesem Dokument ausführen, können Sie Trigger registrieren, um Conversions zu erfassen, die der Browser dann den entsprechenden Quellereignissen zuordnet, nämlich Anzeigenimpressionen oder Anzeigenklicks.

Registrierungsmethoden

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

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

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

Trigger registrieren, um eine Conversion zuzuordnen

Die Registrierung eines Triggers ähnelt der Registrierung eines Attributionsquellenereignisses. Die vollständigen Schritte werden später beschrieben. Hier die Zusammenfassung:

1. Triggerregistrierung starten Verwenden Sie ein Pixel oder einen fetch()-Aufruf, um eine Anfrage zu stellen.

2. Schließen Sie die Triggerregistrierung ab, indem Sie mit dem Header für die Triggerregistrierung antworten.

   Wenn Sie die Pixelanfrage erhalten haben, die entweder an den im Attribut src definierten Endpunkt oder an den in attributionsrc definierten Endpunkt gesendet wurde (falls Sie attributionsrc verwenden und einen Wert dafür angegeben haben), antworten Sie mit dem Header Attribution-Reporting-Register-Trigger.

   Geben Sie in dieser Kopfzeile die Triggerdaten an, die letztendlich in Berichten angezeigt werden sollen. Dieser Header kann in jeder Antwort festgelegt werden. Solange es sich um eine Antwort auf eine Anfrage handelt, die von einer Website gesendet wurde, die mit destination übereinstimmt, werden Quellen zugeordnet. Wenn der Header empfangen wird, sucht der Browser nach übereinstimmenden Quellen und plant einen Bericht.

   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 Zusammenfassungsberichte:

   {
     ... // 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
     }
   }
   

Umgang mit Subdomains

Wenn destination https://advertiser.example ist, können Conversions sowohl für https://advertiser.example als auch für die zugehörigen Subdomains wie https://shop.advertiser.example zugeordnet werden.

Wenn destination https://shop.advertiser.example ist, können Conversions sowohl https://advertiser.example als auch https://shop.advertiser.example zugeordnet werden.

Erforderliche und optionale Attribute

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

Wenn attributionsrc optional ist, wird durch die Verwendung angegeben, dass die Anfrage für Attribution Reporting infrage kommt. Wenn Sie attributionsrc verwenden, sendet der Browser den Attribution-Reporting-Eligible-Header. Er ist auch für die App-zu-Web-Analyse nützlich: Wenn attributionsrc vorhanden ist, sendet der Browser den Attribution-Reporting-Support-Header.

Schritt 1: Triggerregistrierung starten

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

Neues oder vorhandenes Conversion-Pixel verwenden

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

Die Quelle für attributionsrc muss mit der Quelle übereinstimmen, die die Quellregistrierung durchgeführt hat.

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

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

Die Quelle für src muss mit der Quelle übereinstimmen, die die Quellregistrierung durchgeführt hat.

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

Script-Tag verwenden

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

Dieser Code simuliert effektiv, was bei einer HTML-Anfrage mit attributionsrc passieren würde:

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

// Optionally set keepalive to make sure 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.

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

Das ist nützlich, wenn Sie die Triggerregistrierung durchführen möchten, indem Sie auf eine Anfrage antworten, die von der Hauptanfrage des Elements getrennt ist.

Wenn Sie beispielsweise Trigger für ein Bildelement registrieren müssen, haben Sie möglicherweise keine Kontrolle über die Bildantwort. In diesem Fall benötigen Sie eine Konfiguration, bei der Sie den Header für die Triggerregistrierung als Antwort auf eine Anfrage senden, die vom Bild getrennt ist und die Sie vollständig kontrollieren können. Wenn Sie einen expliziten Wert für attributionsrc angeben, weisen Sie den Browser an, diese zusätzliche Anfrage zu senden, und konfigurieren das Ziel.

Schritt 2: Mit einem Header antworten

Antworten Sie auf die Browseranfrage und fügen Sie in Ihre Antwort den Header Attribution-Reporting-Register-Trigger ein:

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

Nächste Schritte

Attributionsquellen registrieren