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>
-Tagfetch
Anruf-AssetXMLHttpRequest
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:
- Initiieren Sie die Triggerregistrierung. Verwenden Sie für eine Anfrage ein Pixel oder einen
fetch()
-Aufruf. 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 inattributionsrc
definierten Endpunkt gesendet wird, falls duattributionsrc
verwendet und ihm einen Wert gegeben hast, mit dem HeaderAttribution-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]" }] }
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 } }
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 |
Nicht zutreffend: 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>
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
:
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.
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 Triggerregistrierung vornehmen 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 Registrierungsheader für den Trigger als Antwort auf eine vom Bild getrennte Anfrage senden, 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"
});
Nächste Schritte
Weitere Informationen zum Registrieren von Attributionsquellen