Scopri come registrare gli attivatori di attribuzione per conteggiare le conversioni.
Un attivatore di attribuzione è l'evento che indica al browser di acquisire le conversioni.
Seguendo la procedura descritta in questo documento, puoi registrare gli attivatori per registrare le conversioni che il browser attribuirà poi agli eventi di origine pertinenti, cioè le impressioni degli annunci o i clic sugli annunci.
Metodi di registrazione
Per registrare i trigger, utilizza elementi HTML o chiamate JavaScript:
- Tag
<img>
- Tag
<script>
fetch
chiamataXMLHttpRequest
In questo modo vengono generate richieste di rete a cui rispondi con un'intestazione di risposta HTTP della registrazione trigger.
Registra un attivatore per attribuire una conversione
La registrazione di un trigger è simile alla registrare un evento di origine di attribuzione. I passaggi completi sono descritti più avanti. Ecco il riepilogo:
- Avvia la registrazione dell'attivatore. Usa un pixel o una chiamata
fetch()
per effettuare una richiesta. Completa la registrazione dell'attivatore rispondendo con l'attivatore intestazione registrazione.
Dopo aver ricevuto la richiesta di pixel, inviata al endpoint definito nel consueto attributo
src
o all'endpoint definito inattributionsrc
se hai scelto di usareattributionsrc
e gli hai fornito un valore, rispondi con l'intestazioneAttribution-Reporting-Register-Trigger
.In questa intestazione, specifica i dati del trigger che devono essere visualizzati report in ultima analisi. Questa intestazione può essere impostata da qualsiasi risposta. Purché si tratti di un risposta a una richiesta effettuata da un sito che corrisponde a
destination
, le fonti corrispondenti. Quando l'intestazione viene ricevuta, Il browser cerca le origini corrispondenti e pianifica un report.Esempio di report a livello di evento:
{ "event_trigger_data": [{ "trigger_data": "[unsigned 64-bit integer]", "priority": "[signed 64-bit integer]", "deduplication_key": "[unsigned 64-bit integer]" }] }
Esempio per i report di riepilogo:
{ ... // 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 } }
Gestire i sottodomini
Se destination
è https://advertiser.example
, le conversioni su entrambi
È possibile attribuire https://advertiser.example
e i relativi sottodomini, come https://shop.advertiser.example
.
Se destination
è https://shop.advertiser.example
, le conversioni sia su https://advertiser.example
che su
È possibile attribuire https://shop.advertiser.example
.
Attributi obbligatori e facoltativi
Quando utilizzi elementi HTML o effettui chiamate JavaScript per registrare i trigger,
potrebbe essere necessario usare attributionsrc
o attributionReporting
. Consulta la tabella seguente per maggiori dettagli su quando vengono
obbligatorio.
Quando attributionsrc
è facoltativo, il suo utilizzo indica che la richiesta è idonea per Attribution Reporting. Se utilizzi
attributionsrc
, il browser invia l'errore
Intestazione Attribution-Reporting-Eligible
. È utile anche per il passaggio
misurazione: se è presente attributionsrc
, il browser invia
Intestazione Attribution-Reporting-Support
.
Metodo di registrazione | Trigger |
---|---|
Tag <a> |
N/D: gli ancoraggi non possono registrare un trigger. |
Tag <img> |
attributionsrc è facoltativo. L'intestazione
sia sufficiente per registrare un trigger. |
Tag <script> |
attributionsrc è facoltativo. L'intestazione
sia sufficiente per registrare un trigger. |
fetch chiamata |
L'opzione attributionReporting è
obbligatorio. |
XMLHttpRequest |
L'opzione attributionReporting è
obbligatorio. |
window.open() |
N/D: window.open non può registrare un attivatore. |
Passaggio 1: avvia la registrazione dell'attivatore
Puoi registrare un attivatore utilizzando un pixel (tag <img>
) o un tag script.
Utilizzo di un pixel di conversione nuovo o esistente
Il seguente esempio attiva l'attribuzione su un'immagine esistente aggiungendo l'attributo attributionsrc
.
L'origine di attributionsrc
deve corrispondere all'origine che ha eseguito la registrazione dell'origine.
<img src="https://advertiser.example/conversionpixel"
attributionsrc="https://adtech.example/attribution_trigger?purchase=13">
Il prossimo esempio attiva l'attribuzione aggiungendo un nuovo attributo del pixel di conversione attributionsrc
.
L'origine di src
deve corrispondere all'origine che ha eseguito la registrazione dell'origine.
<img src="https://adtech.example/conversionpixel"
attributionsrc>
Utilizzo di un tag script
Puoi eseguire la registrazione del trigger con un tag script; si comporta in modo identico a <img>
. I seguenti esempi di codice illustrano l'utilizzo di fetch()
e XMLHttpRequest()
(XHR).
Questo codice simula in modo efficace ciò che fa una richiesta HTML con 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
con o senza un valore
Puoi aggiungere attributionsrc
con o senza un valore.
<!-- Without a value -->
<img src="..." width="1" height="1" attributionsrc>
<!-- With a value (URL) -->
<img src="..." width="1" height="1" attributionsrc="https://...">
Se imposti un valore per attributionsrc
, il valore può essere costituito da uno o più URL separati da spazi.
Se utilizzi un URL, il browser avvia una richiesta di recupero keepalive separata:
per ogni URL, che include la richiesta Attribution-Reporting-Eligible
intestazione.
È utile se vuoi effettuare la registrazione del trigger rispondendo a un separata da quella principale dell'elemento.
Ad esempio, se devi registrare i trigger su un elemento immagine,
potresti non avere il controllo della risposta dell'immagine; In questo caso ti consigliamo di
una configurazione in cui invii l'intestazione della registrazione del trigger in risposta a una richiesta
separato dall'immagine e che puoi controllare completamente. Di
specificando un valore esplicito per attributionsrc
, indichi
browser per effettuare questa richiesta aggiuntiva e configurare la sua destinazione.
Passaggio 2: rispondi con un'intestazione
Dopo aver ricevuto la richiesta del browser, rispondi e includi nella risposta l'intestazione Attribution-Reporting-Register-Trigger
:
JSON.stringify({
event_trigger_data: [{
trigger_data: "412444888111012",
// Optional
priority: "1000000000000",
deduplication_key: "2345698765"
}],
debug_key: "1115698977"
});
Passaggi successivi
Scopri come registrare le origini di attribuzione.