Registra gli attivatori di attribuzione

Scopri come registrare i trigger di attribuzione per conteggiare le conversioni.

Un trigger di attribuzione è l'evento che indica al browser di acquisire le conversioni.

Seguendo i passaggi descritti in questo documento, puoi registrare i trigger per registrare le conversioni che il browser attribuisce poi agli eventi di origine pertinenti, ovvero impressioni o clic sugli annunci.

Metodi di registrazione

Per registrare i trigger, utilizza elementi HTML o chiamate JavaScript:

• Tag <img>
• Tag <script>
• fetch chiamata
• XMLHttpRequest

In questo modo vengono generate richieste di rete a cui devi rispondere con un'intestazione di risposta HTTP di registrazione del trigger.

Registrare un trigger per attribuire una conversione

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

1. Avvia la registrazione del trigger. 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.

   Al ricevimento della richiesta di pixel, inviata all'endpoint definito nell'attributo src abituale o all'endpoint definito in attributionsrc se hai scelto di utilizzare attributionsrc e gli hai assegnato un valore, rispondi con l'intestazione Attribution-Reporting-Register-Trigger.

   In questa intestazione, specifica i dati di attivazione che vuoi visualizzare nei report. Qualsiasi risposta può impostare questa intestazione. Se si tratta di una risposta a una richiesta effettuata da un sito che corrisponde a destination, le origini verranno abbinate. Quando viene ricevuta l'intestazione, il browser cerca le origini corrispondenti e pianifica un report.

   Esempio per i 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
     }
   }
   

Gestione dei sottodomini

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

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

Attributi obbligatori e facoltativi

Quando utilizzi elementi HTML o effettui chiamate JavaScript per registrare i trigger, potresti dover utilizzare attributionsrc o attributionReporting. Per i dettagli sui casi in cui sono richiesti, consulta la tabella seguente.

Quando 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.

Passaggio 1: avvia la registrazione dell'attivatore

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

Utilizzo di un pixel di conversione nuovo o esistente

L'esempio seguente attiva l'attribuzione su un'immagine esistente aggiungendo l'attributo attributionsrc.

L'origine di attributionsrc deve corrispondere all'origine che ha eseguito la registrazione della fonte.

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

L'esempio successivo attiva l'attribuzione aggiungendo un nuovo attributo attributionsrc del pixel di conversione.

L'origine di src deve corrispondere all'origine che ha eseguito la registrazione della fonte.

<img src="https://adtech.example/conversionpixel"
     attributionsrc>

Utilizzo di un tag script

Puoi eseguire la registrazione dell'attivatore con un tag script, che 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 farebbe una richiesta HTML con attributionsrc:

const attributionReporting = {
  eventSourceEligible: false,
  triggerEligible: true,
};

// Optionally set keepalive to make sure 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, può trattarsi di uno o più URL separati da spazi.

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

Questa impostazione è utile se vuoi registrare il trigger rispondendo a una richiesta separata dalla richiesta principale dell'elemento.

Ad esempio, se devi registrare trigger su un elemento immagine, potresti non avere il controllo effettivo della risposta dell'immagine. In questo caso, ti consigliamo una configurazione in cui invii l'intestazione di registrazione del trigger come risposta a una richiesta separata dall'immagine e che puoi controllare completamente. Se specifichi un valore esplicito per attributionsrc, indichi al browser di effettuare questa richiesta aggiuntiva e di configurarne la 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 dell'attribuzione.