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
摘要报告分为 Attribution Reporting API 和 Private Aggregation API 两种报告类型。摘要报告包含汇总的用户数据,可以包含详细的转化数据,但添加了噪声。摘要报告由汇总报告组成。
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 metodopost
. 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 metodopost
. 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:
- Segui le istruzioni riportate in Definire regole personalizzate utilizzando i filtri.
- 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.
Passaggi successivi
Se è tutto pronto per iniziare l'implementazione, consulta questi documenti:
Configurazione
- Registrare un'origine di 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 dei dati dei report sull'aggregazione
- Comprendere il rumore
- Utilizzare il rumore
Demo e strumenti
- Demo dell'API Attribution Reporting
- Laboratorio rumore
- Strumento di convalida delle intestazioni dei report sull'attribuzione
Pianificazione
Se sei ancora nella fase di pianificazione, dai un'occhiata a questi documenti: