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, 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 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 visualizzare 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 riportate in Definire regole personalizzate utilizzando i filtri.
2. 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.