Dai la priorità a clic, visualizzazioni o conversioni specifici

Configura l'API per dare la priorità a origini o attivatori specifici.

Dare la priorità a clic o visualizzazioni specifici per i report aggregabili o a livello di evento

Utilizzando le priorità lato sorgente, puoi modificare il comportamento predefinito dell'API Attribution Reporting. Per impostazione predefinita, il modello di attribuzione è last-touch, il che significa che una conversione viene attribuita all'evento sorgente corrispondente più recente. Puoi modificare questo comportamento sia per i report a livello di evento sia per quelli aggregabili.

Per modificare la priorità predefinita, aggiungi la chiave priority all'intestazione di registrazione dell'origine.

Imposta una priorità più alta per le origini a cui vuoi dare la priorità. I valori più elevati indicano una priorità maggiore. Ad esempio, un evento sorgente con un valore priority pari a 2 ha la precedenza su una sorgente con un valore priority pari a 1.

Viene inviato solo il report corrispondente all'evento di origine con la priorità più elevata.

Esempio di codice

Modifica l'attribuzione per selezionare origini meno recenti (primo clic):

const currentTimestamp = Date.now();
const priority = -currentTimestamp;

res.set(
  "Attribution-Reporting-Register-Source",
  JSON.stringify({
    // … all usual fields for that header
    priority: `${priority}`
  })
);

Dare la priorità a conversioni specifiche per i report a livello di evento

A differenza delle priorità lato sorgente, l'impostazione delle priorità lato trigger è disponibile solo per i report a livello di evento.

Supponiamo che un utente faccia clic su un annuncio e generi quattro conversioni: visita la home page del sito dell'inserzionista, poi una pagina di prodotto, si iscrive alla newsletter e infine effettua un acquisto.

Tuttavia, a causa del limite di tre report per i clic, per impostazione predefinita tutti i report successivi alla registrazione (terza conversione) vengono eliminati, incluso il report sugli acquisti.

In alternativa, puoi configurare l'API in modo da ricevere i report per le conversioni che ritieni più importanti, ad esempio il report Acquisti.

A tale scopo, aggiungi la chiave priority all'intestazione di registrazione dell'attivatore e imposta una priorità più elevata per le conversioni a cui vuoi dare la priorità.

Quando viene attivata un'attribuzione per un determinato evento di origine, se per questa origine è stato raggiunto il numero massimo di attribuzioni (tre per i clic e una per le visualizzazioni), il browser:

  • Confronta la priorità del nuovo report con le priorità dei report pianificati esistenti per la stessa origine.

  • Elimina il report con la priorità più bassa per pianificare il nuovo report. Se il nuovo report è quello con la priorità più bassa, viene ignorato e non lo riceverai.

Se non vengono impostate priorità, il browser torna al comportamento predefinito: qualsiasi conversione che si verifica dopo la terza conversione per clic o la prima conversione per visualizzazioni viene ignorata.

Esamina il codice di esempio: dai priorità alle conversioni di tipo pagamento

Passaggi successivi

Per informazioni su come impostare origini e attivatori, consulta: