Registra gli attivatori di attribuzione

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 attribuisce in seguito agli eventi origine pertinenti, ovvero le impressioni degli annunci o i clic sugli annunci.

Metodi di registrazione

Per registrare gli attivatori, utilizza gli elementi HTML o le chiamate JavaScript:

• Tag <a>
• Tag <img>
• Tag <script>
• fetch chiamata
• XMLHttpRequest
• window.open

In questo modo vengono generate richieste di rete a cui rispondi con un'intestazione della risposta HTTP della registrazione di trigger.

Registra un attivatore per attribuire una conversione

La registrazione di un trigger è simile alla registrazione di un evento di origine dell'attribuzione. I passaggi completi sono descritti di seguito. Ecco il riepilogo:

1. Avvia la registrazione dell'attivatore. Utilizza un pixel o una chiamata fetch() per effettuare una richiesta.

2. Completa la registrazione del trigger rispondendo con l'intestazione di registrazione del trigger.
   
   

   Dopo aver ricevuto la richiesta di pixel, inviata all'endpoint definito nel solito attributo src o all'endpoint definito in attributionsrc se hai scelto di utilizzare attributionsrc e gli è stato assegnato un valore, rispondi con l'intestazione Attribution-Reporting-Register-Trigger.
   
   

   In questa intestazione, specifica i dati dei trigger che vuoi che vengano visualizzati nei report. Qualsiasi risposta può impostare questa intestazione. Finché si tratta di una risposta a una richiesta effettuata da un sito che corrisponde a destination, le origini verranno abbinate. Una volta ricevuta l'intestazione, 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]"
     }]
   }
   ```
   
   **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
     }
   }
   ```
   

Nota: quando il browser riceve una risposta di attivazione dell'attribuzione da un URL Attributionsrc su una determinata pagina, viene eseguita una ricerca nello spazio di archiviazione locale per trovare una sorgente che corrisponda sia all'origine Attributionsrc che all'eTLD+1 dell'URL della pagina. <br> Se vengono trovate più origini, il browser sceglie quella che è stata archiviata più di recente, a meno che le origini non abbiano priorità diverse, dove il browser sceglie quella con la priorità maggiore.

Gestione dei sottodomini

Se destination è https://advertiser.example, è possibile attribuire le conversioni sia in https://advertiser.example che nei relativi sottodomini, ad esempio https://shop.advertiser.example.

Se destination è https://shop.advertiser.example, è possibile attribuire le conversioni sia su https://advertiser.example sia su https://shop.advertiser.example.

Attributi obbligatori e facoltativi

Quando utilizzi gli elementi HTML o effettui chiamate JavaScript per registrare i trigger, potresti dover utilizzare attributionsrc o attributionReporting. Fai riferimento alla tabella seguente per dettagli su quando questi campi sono necessari.

Se attributionsrc è facoltativo, il suo utilizzo indica che la richiesta è idonea per i report sull'attribuzione. Se utilizzi attributionsrc, il browser invia l'intestazione Attribution-Reporting-Eligible. È utile anche per la misurazione da app a web: se è presente attributionsrc, il browser invia l'intestazione Attribution-Reporting-Support.

Metodo di registrazione	Trigger
Tag <a>	N/D Gli anchor non possono registrare un trigger.
Tag <img>	attributionsrc è facoltativo. L'intestazione è sufficiente per registrare un trigger.
Tag <script>	attributionsrc è facoltativo. L'intestazione è sufficiente per registrare un trigger.
fetch chiamata	L'opzione attributionReporting è obbligatoria.
XMLHttpRequest	L'opzione attributionReporting è obbligatoria.
window.open()	N/D window.open non può registrare un trigger.

Passaggio 1: avvia la registrazione dell'attivatore

Puoi registrare un attivatore utilizzando un pixel (tag <img>) o un tag script.

Usare un pixel di conversione nuovo o esistente

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

Punto chiave: * l'origine di src deve corrispondere all'origine che ha eseguito la registrazione dell'origine. * Un'attribuzione può essere attivata solo su una pagina il cui eTLD+1 corrisponde al sito fornito nella destinazione al momento della registrazione dell'origine.

Utilizzare un tag script

Puoi eseguire la registrazione dell'attivatore con un tag script, che ha un comportamento identico a <img>. I seguenti esempi di codice illustrano l'utilizzo di fetch() e XMLHttpRequest() (XHR).

Questo codice simula in modo efficace l'effetto di una richiesta HTML con 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();

Punto chiave:l'origine di <code>src</code> deve corrispondere all'origine che ha eseguito la registrazione dell'origine. - Un'attribuzione può essere attivata solo su una pagina il cui <a href="https://web.dev/same-site-same-origin/#%22schemeful-same-site%22">eTLD+1</a> corrisponde al sito fornito nella <code>destination</code> al momento della registrazione alla fonte.

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, questo deve essere un singolo URL.

L'utilizzo di un URL fa sì che il browser avvii una richiesta di recupero keepalive separata, una per ogni URL, che include l'intestazione della richiesta Attribution-Reporting-Eligible.

Ciò è utile se vuoi effettuare la registrazione di origine rispondendo a una richiesta separata da quella principale dell'elemento.

Ad esempio, se devi registrare le origini dei clic su un elemento anchor, potresti non avere effettivamente il controllo della destinazione. In questo caso, ti consigliamo di utilizzare una configurazione in cui invii l'intestazione della registrazione dell'origine come risposta a una richiesta separata dalla navigazione e che puoi controllare completamente. Se specifica un valore esplicito per attributionsrc, indichi al browser di effettuare la richiesta aggiuntiva e di configurare la sua destinazione.

Passaggio 2: rispondi con un'intestazione

Dopo aver ricevuto la richiesta del browser, rispondi e includi nella tua risposta l'intestazione Attribution-Reporting-Register-Trigger:

JSON.stringify({event_trigger_data: [{
      trigger_data: '412444888111012',
      // Optional
      priority: '1000000000000',
      deduplication_key: '2345698765'
    }], debug_key: '1115698977'})

Attenzione:il valore del campo event_trigger_data deve essere nidificato tra parentesi quadre, perché il browser prevede un array JSON. È utile per i filtri.

Passaggi successivi

Scopri come registrare le origini dell'attribuzione.