Inizia a utilizzare i report sull'attribuzione

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

Per iniziare, imparerai a:

  • Distinguere 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 per la risoluzione dei problemi

Scegliere 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 di un 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 riepilogativi:offrono dati utente aggregati e possono includere informazioni sulle conversioni più dettagliate con rumore aggiunto. Utilizzando sia l'API Attribution Reporting sia l'API Private Aggregation, vengono creati a partire da report aggregati e offrono un modello di dati più ricco rispetto ai report a livello di evento. I report riepilogativi 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'intero processo.

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

Generazione di report a livello di evento

I seguenti passaggi 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 dell'attribuzione e Registrazione delle origini dell'attribuzione. Tieni presente che la procedura di registrazione è leggermente diversa per i clic e le visualizzazioni.

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

  3. Configura un endpoint di reporting:crea un endpoint sul tuo server per ricevere report a livello di evento. L'URL dell'endpoint deve seguire questo 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 maggiori informazioni su .well-known, consulta Wikipedia.

Per un'analisi più approfondita dei report a livello di evento, consulta l'articolo esplicativo sui report a livello di evento.

Generazione del report di riepilogo

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

  2. Registra un trigger:come per i report a livello di evento. Vedi Registrare i trigger di attribuzione.

  3. Configura un endpoint di generazione dei 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. Raggruppa e invia i report:raggruppa i report aggregati e inviali al servizio di aggregazione per l'elaborazione. Il servizio di aggregazione genererà quindi report di riepilogo. Per saperne di più, consulta Strategie per il batching.

Per un'analisi più approfondita dei report di riepilogo, consulta la spiegazione dei report aggregabili.

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

(Facoltativo) Impostare i filtri

Per ottenere un controllo più granulare sui dati di attribuzione che ricevi, puoi configurare i filtri.

Il filtraggio fornisce un'analisi dei dati più precisa 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 il filtro, consulta Definire regole personalizzate utilizzando i filtri e la sezione dei trigger della registrazione dei trigger di attribuzione per i dettagli specifici dei report aggregabili.

Verifica che l'API sia abilitata

Prima di utilizzare l'API, verifica che sia abilitata 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 attuale. 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 in modo definitivo l'usabilità dell'API.

Passaggi successivi

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

Implementazione

Background e concetti

Demo e strumenti

Pianificazione