Inizia a utilizzare i report sull'attribuzione

Questa guida fornisce una panoramica e istruzioni di configurazione per i report di attribuzione a livello di evento e di riepilogo che utilizzano l'API Attribution Reporting.

Per iniziare, imparerai a:

  • Differenziare i tipi di report dell'API Attribution Reporting

  • Completa i passaggi di implementazione dell'API e di generazione dei report

  • Trovare informazioni di riferimento e sulla risoluzione dei problemi

Scegli un tipo di report

Per misurare in modo efficace il rendimento delle campagne pubblicitarie con diversi livelli di dettaglio e privacy, l'API Attribution Reporting fornisce due tipi di report distinti:

  • Report a livello di evento:forniscono dati granulari che collegano un clic o una visualizzazione dell'annuncio specifico (l'origine) ai dati sulle conversioni corrispondenti (l'attivatore). I report a livello di evento limitano la quantità di dati sulle conversioni e aggiungono rumore ai report. Sono ideali per i casi d'uso in cui l'attribuzione dei singoli eventi è fondamentale, ad esempio per misurare la copertura della campagna.

  • Report di riepilogo:offrono dati utente aggregati e possono includere informazioni sulle conversioni più dettagliate con un aumento del rumore. Utilizzando sia l'API Attribution Reporting che l'API Private Aggregation, vengono creati da report aggregati e offrono un modello di dati più completo rispetto ai report a livello di evento. I report di riepilogo sono particolarmente utili per gli scenari che richiedono approfondimenti aggregati, ad esempio il calcolo dei valori di conversione o l'analisi del rendimento delle campagne nei segmenti di utenti.

Panoramica dell'implementazione

Le seguenti sezioni descrivono i passaggi di alto livello per generare ogni tipo di report. Puoi anche seguire la demo dell'API Attribution Reporting per una procedura dettagliata passo passo dell'intera procedura.

Prerequisito:prima di poter registrare origini, attivatori e ricevere report, i tuoi siti devono disporre di certificati SSL/TLS (HTTPS).

Generazione di report a livello di evento

I passaggi riportati di seguito descrivono come generare report a livello di evento:

  1. Registra un'origine:associa un clic o una visualizzazione dell'annuncio alle informazioni sull'attribuzione. Per istruzioni dettagliate, consulta Registrare le origini di attribuzione e Registrazione delle origini di attribuzione. Tieni presente che la procedura di registrazione è leggermente diversa per i clic e le visualizzazioni.

  2. Registra un attivatore:registra un evento di conversione e lo collega a un'origine registrata in precedenza. Per istruzioni, consulta Registrare gli attivatori di attribuzione.

  3. Configura un endpoint per i report:crea un endpoint sul server per ricevere report a livello di evento. L'URL dell'endpoint deve avere il seguente formato: {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution. Per un esempio del metodo POST, consulta il codice di esempio in adtech.js. Per ulteriori informazioni su .well-known, visita la pagina Wikipedia.

Per approfondire i report a livello di evento, consulta la spiegazione dei report a livello di evento.

Generazione di report di riepilogo

  1. Registra un'origine:come per i report a livello di evento. Per maggiori dettagli, consulta Registrare le sorgenti di attribuzione e Registrazione delle sorgenti di attribuzione.

  2. Registra un attivatore:come per i report a livello di evento. Vedi Registrare gli attivatori dell'attribuzione.

  3. Configura un endpoint per i report:crea un endpoint per ricevere report aggregati. L'URL deve essere: {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution. Consulta adtech.js per un esempio di metodo POST e Wikipedia per informazioni su .well-known.

  4. Elabora e invia report in batch:raggruppa i report aggregati e inviali al servizio di aggregazione per l'elaborazione. Il servizio di aggregazione genererà quindi i report di riepilogo. Per saperne di più, consulta la sezione Strategie per l'aggregazione.

Per approfondire i report di riepilogo, consulta l'articolo esplicativo sui report aggregabili.

Oltre ai passaggi di implementazione, i seguenti argomenti ti aiuteranno a pianificare la tua strategia di generazione di report di riepilogo:

(Facoltativo) Impostare i filtri

Per un maggiore controllo sui dati di attribuzione che ricevi, puoi configurare i filtri.

L'applicazione di filtri consente un'analisi dei dati più raffinata che isola sottoinsiemi specifici di dati per l'analisi, riducendo il rumore. Inoltre, consente di monitorare il rendimento di campagne pubblicitarie ed eventi di conversione specifici per una misurazione più precisa.

Per configurare i filtri, consulta Definire regole personalizzate utilizzando i filtri e la sezione degli attivatori della registrazione dell'attivatore di attribuzione per informazioni specifiche sui report aggregabili.

Verifica che l'API sia abilitata

Prima di utilizzare l'API, controlla se è attiva utilizzando il seguente codice:

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // the Attribution Reporting API is enabled
}

Questo controllo indica se l'API è consentita nel contesto corrente. Tuttavia, le impostazioni del browser dell'utente o altri fattori potrebbero comunque impedire l'utilizzo dell'API. Per motivi di privacy, non esiste un modo programmatico per confermare definitivamente l'usabilità dell'API.

Passaggi successivi

Le sezioni seguenti forniscono ulteriori informazioni su come iniziare a utilizzare i report sull'attribuzione.

Implementazione

Informazioni generali e concetti

Demo e strumenti

Pianificazione