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, ma non i report a livello di evento.
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 un report a livello di evento sia un report aggregabile. 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 visualizzare 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 visualizzare 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 riportate in Definire regole personalizzate utilizzando i filtri.
- Esamina i dettagli specifici dei filtri per i report aggregabili nella sezione degli attivatori del documento esplicativo.
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 su quella pagina; l'utente potrebbe aver disattivato l'API tramite le impostazioni del browser oppure potrebbe 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:
Imposta
- 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
Contesto
- 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: