Ecco da dove iniziare: configurazione e una rapida panoramica.
Scegli un tipo di report
Con l'API Attribution Reporting, puoi generare due tipi di report: a livello di evento e di riepilogo. I report a livello di evento richiedono una configurazione minore rispetto ai report aggregabili o di riepilogo, quindi possono essere un buon punto di partenza. I report di riepilogo richiedono l'integrazione con il servizio di aggregazione. i report a livello di evento non lo fanno.
Puoi impostare i report sia a livello di evento che di riepilogo. Sono complementari.
Report a livello di evento
I report a livello di evento associano una determinata visualizzazione o clic sull'annuncio (sul lato annuncio) ai dati sul lato conversione. Per tutelare la privacy dell'utente limitando l'unione dell'identità dell'utente tra i siti, i dati sul lato delle conversioni sono molto limitati e non funzionano.
Report di riepilogo
Un report di riepilogo è un tipo di report API Attribution Reporting e Private Aggregation API. Un report di riepilogo include dati utente aggregati e può contenere dati sulle conversioni dettagliati, senza aggiunta di rumore. I report di riepilogo sono costituiti da report aggregati.
Implementazione
Per iniziare, prova i passaggi che seguono.
Tieni presente che per una determinata origine evento è possibile generare sia una e un report aggregabile a livello di evento. La demo ti guida nella procedura.
Generazione di report a livello di evento
Di seguito sono riportati i passaggi minimi da seguire per generare report a livello di evento:
Registra un'origine. Per istruzioni, consulta Registrare le origini dell'attribuzione. Tieni presente che la procedura è diversa per i clic e le visualizzazioni.
Registra un attivatore. Per istruzioni, consulta Registrare gli attivatori di attribuzione.
Configura un endpoint con il seguente URL:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution
.
Fai riferimento all'esempio di codice in adtech.js per vedere il metodoPOST
e su Wikipedia per ulteriori informazioni su.well-known
.
Ulteriori dettagli sono disponibili nell'articolo esplicativo del report a livello di evento.
Generazione di report di riepilogo
Per generare report di riepilogo, segui questi passaggi generali:
Registra un'origine. Per istruzioni, consulta Registrare le origini dell'attribuzione. Tieni presente che la procedura è diversa per i clic e le visualizzazioni. Ulteriori dettagli sono disponibili nella pagina Registrazione dell'origine dell'attribuzione.
Registra un attivatore. Per istruzioni, consulta Registrare gli attivatori di attribuzione.
Configura un endpoint per i report aggregabili con il seguente URL:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution
.
Fai riferimento all'esempio di codice in adtech.js per vedere il metodoPOST
e su Wikipedia per ulteriori informazioni su.well-known
.Raggruppa e invia i report per un'ulteriore elaborazione da parte del servizio di aggregazione, che produrrà report di riepilogo. Consulta i report aggregati in batch.
Ulteriori dettagli sono disponibili nell'articolo esplicativo del report aggregabile.
Scopri come impostare i report di debug nella serie di debug dei report sull'attribuzione.
Concetti aggiuntivi relativi ai report di riepilogo
Oltre a comprendere la procedura di implementazione, i seguenti concetti ti aiuteranno a pianificare la strategia per i report di riepilogo:
Passaggi facoltativi
- (Facoltativo) Configurare i filtri:
- .
- Segui le istruzioni in Definisci le regole personalizzate utilizzando i filtri.
- Esamina i dettagli specifici dei filtri per i report aggregabili in nella sezione degli attivatori spiegazione.
Non dimenticare il rilevamento delle funzionalità
Prima di utilizzare l'API, verifica se non è stata bloccata nella pagina utilizzando un criterio di autorizzazioni. Per farlo, esegui questo codice:
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// the Attribution Reporting API is enabled
}
Se questo controllo di rilevamento di caratteristiche restituisce true, l'API è consentita nel contesto (pagina) in cui viene eseguito il controllo.
Tieni presente che questo controllo da solo non garantisce che l'API sia utilizzabile in quella pagina. l'utente potrebbe aver disattivato l'API utilizzando le impostazioni del browser oppure avere altre impostazioni che ne impediscono l'utilizzo. Per proteggere la privacy degli utenti, non è possibile effettuare controlli a livello programmatico.
Passaggi successivi
Se vuoi iniziare l'implementazione, consulta questi documenti:
Configurazione
- Registrare un'origine attribuzione
- Registrare un attivatore di attribuzione
- Dai la priorità a clic, visualizzazioni o conversioni specifici
- Debug dei report sull'attribuzione
- Chiavi di aggregazione
Sfondo
- Report sull'attribuzione con report a livello di evento
- Report sull'attribuzione con report aggregati
- Vincoli sui dati di Aggregation Reporting
- Comprendere il rumore
- Lavorare con il rumore
Demo e strumenti
- Demo dell'API Attribution Reporting
- Laboratorio sul rumore
- Strumento di convalida delle intestazioni dei report sull'attribuzione
Pianificazione
Se sei ancora nella fase di pianificazione, consulta questi documenti: