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>
-Tagfetch
Anruf-AssetXMLHttpRequest
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:
- Initiieren Sie die Trigger-Registrierung. Verwenden Sie ein Pixel oder einen
fetch()
-Aufruf, um eine Anfrage zu senden. 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 inattributionsrc
definierten Endpunkt, wenn Sieattributionsrc
verwendet und einen Wert angegeben haben, antworten Sie mit dem HeaderAttribution-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 } } ```
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">
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();
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'})
Nächste Schritte
Weitere Informationen zum Registrieren von Attributionsquellen