Attributionstrigger registrieren

Hier erfahren Sie, wie Sie Attributionstrigger zum Erfassen von Conversions registrieren.

Ein Attributionstrigger ist das Ereignis, das den Browser auffordert, Conversions zu erfassen.

Anhand der Schritte in diesem Dokument können Sie Trigger registrieren, um Conversions zu erfassen, die der Browser dann den relevanten Quellereignissen (Anzeigenimpressionen oder Anzeigenklicks) zuordnet.

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.

Trigger zum Zuordnen einer Conversion registrieren

Das Registrieren eines Triggers ähnelt dem Registrieren eines Ereignisses in der Attributionsquelle. Die vollständigen Schritte werden später beschrieben. Hier ist die Zusammenfassung:

1. Initiieren Sie die Trigger-Registrierung. Verwenden Sie ein Pixel oder einen fetch()-Aufruf, um eine Anfrage zu senden.

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

   Wenn Sie die Pixelanfrage erhalten, die entweder an den Endpunkt gesendet wird, der im üblichen src-Attribut definiert ist, oder an den in attributionsrc definierten Endpunkt, wenn Sie attributionsrc verwendet und einen Wert angegeben haben, antworten Sie mit dem Header Attribution-Reporting-Register-Trigger.
   
   

   Geben Sie in diesem Header die Triggerdaten an, die letztendlich in Berichten erscheinen sollen. Dieser Header kann von jeder Antwort festgelegt werden. Wenn es sich um eine Antwort auf eine Anfrage einer Website handelt, die mit dem destination übereinstimmt, werden die 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 empfängt, wird eine lokale Speichersuche durchgeführt, um eine Quelle zu finden, die sowohl mit dem „attributionsrc“-Ursprung als auch mit der eTLD+1 dieser Seiten-URL übereinstimmt. <br> Wenn mehrere Quellen gefunden werden, wählt der Browser die zuletzt gespeicherte Quelle aus, es sei denn, Quellen haben andere Prioritäten, bei denen der Browser die Quelle mit der höchsten Priorität auswählt.

Umgang mit Subdomains

Wenn destination den Wert https://advertiser.example hat, können Conversions sowohl für https://advertiser.example als auch in den zugehörigen Subdomains (z. B. https://shop.advertiser.example) zugeordnet werden.

Wenn destination den Wert https://shop.advertiser.example hat, können Conversions für https://advertiser.example und 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 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 nützlich für die Messung von App zu Web: 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: Trigger-Registrierung initiieren

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

Verwendung eines neuen oder vorhandenen Conversion-Pixels

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

Wichtiger Hinweis: * Der Ursprung für src muss mit dem Ursprung übereinstimmen, der die Quellenregistrierung durchgeführt hat. * Eine Attribution kann nur für eine Seite ausgelöst werden, deren eTLD+1 mit der Website übereinstimmt, die bei der Registrierung der Quelle im Ziel angegeben wurde.

Skript-Tag verwenden

Sie können die Trigger-Registrierung mit einem Script-Tag durchführen. Das Verhalten entspricht dem von <img>. Die folgenden Codebeispiele veranschaulichen die Verwendung von fetch() und XMLHttpRequest() (XHR).

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

// 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 Ursprung für <code>src</code> muss mit dem Ursprung übereinstimmen, der die Quellregistrierung durchgeführt hat. – Eine Attribution kann nur für eine Seite ausgelöst werden, deren <a href="https://web.dev/same-site-same-origin/#%22schemeful-same-site%22">eTLD+1</a> mit der Website übereinstimmt, die bei der Quellenregistrierung in <code>destination</code> 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 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.

Schritt 2: Mit einem Header antworten

Wenn Sie die Browseranfrage erhalten, antworten Sie 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'})

Achtung:Der Wert des Felds „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