Questa pagina è stata tradotta dall'API Cloud Translation.

Inizia a utilizzare i report sull'attribuzione

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 dell'API Attribution Reporting e dell'API Private Aggregation. Un riepilogo include dati utente aggregati e può contenere dati dettagliati sulle conversioni, con l'aggiunta di rumore. I report di riepilogo sono costituiti da report aggregati. I report di riepilogo consentono una maggiore flessibilità e un modello dei dati più completo rispetto ai report a livello di evento, in particolare per alcuni casi d'uso come i valori di conversione.

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 metodo POST 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 metodo POST 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:
1. Segui le istruzioni in Definisci le regole personalizzate utilizzando i filtri.
2. 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.