Questa pagina è stata tradotta dall'API Cloud Translation.

Inizia a utilizzare i report sull'attribuzione

Ecco da dove iniziare, inclusa la procedura di configurazione e una rapida panoramica.

Scegli un tipo di report

Utilizzando 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 inferiore rispetto ai report aggregabili o di riepilogo, pertanto potrebbero essere un buon punto di partenza. I report di riepilogo richiedono l'integrazione con il servizio di aggregazione, al contrario dei report a livello di evento.

Puoi configurare i report sia per i report a livello di evento sia per quelli 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

Puoi iniziare provando i passaggi seguenti.

Tieni presente che, per una determinata origine di evento, è possibile generare sia un report aggregabile 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 i passaggi per clic e visualizzazioni sono diversi.
Registra un trigger. Per istruzioni, consulta la sezione Registrare gli attivatori di attribuzione.
Configura un endpoint con il seguente URL:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution
Fai riferimento al codice di esempio in adtech.js per vedere il metodo post. Ulteriori informazioni su .well-known sono qui.

Ulteriori dettagli sui report a livello di evento sono disponibili qui.

Generazione del 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 i passaggi per clic e visualizzazioni sono diversi. Per ulteriori dettagli, consulta la pagina Registrazione dell'origine dell'attribuzione.
Registra un trigger. Per istruzioni, consulta la sezione 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 al codice di esempio in adtech.js per vedere il metodo post. Ulteriori informazioni su .well-known sono qui.
Raggruppare e inviare i report per ulteriori elaborazioni da parte del Servizio di aggregazione, che genererà report di riepilogo. Consulta i report aggregabili in gruppo.

Ulteriori dettagli sui report di riepilogo sono disponibili qui.

Per informazioni su come configurare i report di debug, consulta la serie di debug dei report sull'attribuzione.

Concetti aggiuntivi sui report di riepilogo

Oltre a comprendere la procedura di implementazione qui, i seguenti concetti ti aiuteranno a pianificare la tua 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. Consulta i dettagli specifici dei filtri per i report aggregabili nella sezione degli attivatori dell'spiegatore.

Non dimenticare il rilevamento delle funzionalità

Prima di utilizzare l'API, puoi stabilire se non è stata bloccata sulla pagina utilizzando un criterio di autorizzazione. Per farlo, esegui questo codice:

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // the Attribution Reporting API is enabled
}

Se questo controllo per il rilevamento delle funzionalità 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 o potrebbe avere altre impostazioni che impediscono l'utilizzo dell'API. Per proteggere la privacy degli utenti, non esiste un modo per verificarlo in modo programmatico.