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:

• <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 Triggerregistrierung antworten.

Registrieren Sie einen Trigger, um eine Conversion zuzuordnen

Trigger werden ähnlich wie ein Attributionsquellenereignis registriert. Die abschließenden Schritte werden weiter unten beschrieben. Hier ist eine Zusammenfassung:

1. Initiieren Sie die Triggerregistrierung. Verwenden Sie für eine Anfrage ein Pixel oder einen fetch()-Aufruf.

2. Schließe die Triggerregistrierung ab, indem du mit dem Triggerregistrierungsheader antwortest.
   
   

   Antworte nach dem Empfang der Pixelanfrage, die entweder an den im üblichen src-Attribut definierten Endpunkt oder an den in attributionsrc definierten Endpunkt gesendet wird, falls du attributionsrc verwendet und ihm einen Wert gegeben hast, mit dem Header Attribution-Reporting-Register-Trigger.
   
   

   Geben Sie in diesem Header die Triggerdaten an, die letztendlich in Berichten angezeigt werden sollen. Jede Antwort kann diesen Header festlegen. Wenn es sich um eine Antwort auf eine Anfrage von einer Website handelt, die mit destination übereinstimmt, werden Quellen abgeglichen. 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]"
     }]
   }
   ```
   
   **Example for summary reports:**
   
   ```json
   {
     ... // 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 mit dem attributionsrc-Ursprung als auch mit der Zielwebsite der entsprechenden Seite übereinstimmt. 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

Ist destination auf https://advertiser.example gesetzt, können Conversions sowohl auf https://advertiser.example als auch auf zugehörigen Subdomains (z. B. https://shop.advertiser.example) zugeordnet werden.

Wenn destination den Wert https://shop.advertiser.example hat, können Conversions sowohl auf https://advertiser.example als auch auf https://shop.advertiser.example zugeordnet werden.

Erforderliche und optionale Attribute

Wenn Sie HTML-Elemente oder JavaScript-Aufrufe zum Registrieren von Triggern verwenden, 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. Sie ist auch für Messungen von App zu Web nützlich: Wenn attributionsrc vorhanden ist, sendet der Browser den Header Attribution-Reporting-Support.

Registrierungsmethode	Trigger
<a>-Tag	– Anker können keinen Trigger registrieren.
<img>-Tag	attributionsrc ist optional. Der Header reicht aus, um einen Trigger zu registrieren.
<script>-Tag	attributionsrc ist optional. Der Header reicht aus, um einen Trigger zu registrieren.
fetch Anruf-Asset	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>

Wichtiger Hinweis:In beiden Fällen kann eine Attribution nur auf einer Seite ausgelöst werden, deren Website mit der Website übereinstimmt, die bei der Quellregistrierung im Ziel angegeben wurde.

Script-Tag verwenden

Sie können eine Triggerregistrierung mit einem Skript-Tag vornehmen. Es verhält 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:

// With fetch
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 });

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

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

Wichtiger Hinweis:

• Der in fetch() oder open() festgelegte Ursprung oder die url muss mit dem Ursprung übereinstimmen, der die Quellregistrierung durchgeführt hat.
• Eine Attribution kann nur auf einer Seite ausgelöst werden, deren Website mit der Website übereinstimmt, die bei der Quellregistrierung im Ziel angegeben wurde.

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, sollte es sich um eine einzelne URL handeln.

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

Dies ist nützlich, wenn Sie die Quellenregistrierung vornehmen möchten, indem Sie auf eine Anfrage antworten, 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.

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 eckige 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