Misura quando un clic o una visualizzazione dell'annuncio genera una conversione, ad esempio un acquisto sul sito di un inserzionista.
A chi è rivolta questa funzionalità?
Qui troverai le nozioni di base dei report sull'attribuzione e alcuni concetti di base, ma non molti dettagli tecnici.
- Se lavori nel settore della pubblicità o della tecnologia pubblicitaria, scoprirai in che modo questa API offre funzionalità abilitate dai cookie di terze parti. Consulta i casi d'uso dell'API, che forniscono ulteriori dettagli su come vengono generati i report.
- Se sei uno sviluppatore o un ingegnere del software, consulta la panoramica completa del sistema o esegui esperimenti e partecipa con l'API.
Gli inserzionisti e i publisher che si affidano a piattaforme di ad tech per la misurazione delle conversioni non devono utilizzare direttamente l'API. Ti potrebbe interessare capire come funziona Attribution Reporting se la tua tecnologia pubblicitaria prevede di integrarsi con questa API.
Che cos'è l'API Attribution Reporting?
Attualmente, la misurazione delle conversioni degli annunci si basa spesso su cookie di terze parti. I browser stanno limitando l'accesso ai cookie di terze parti perché possono essere utilizzati per monitorare gli utenti su più siti e minare la loro privacy.
L'API Attribution Reporting consente queste misurazioni nel rispetto della privacy, senza cookie di terze parti.
Questa API consente agli inserzionisti e ai fornitori di tecnologia pubblicitaria di misurare le conversioni nei seguenti casi:
- Clic e visualizzazioni degli annunci.
- Annunci in un iframe di terze parti, ad esempio gli annunci su un sito del publisher che utilizza un fornitore di tecnologia pubblicitaria di terze parti.
- Annunci in un contesto proprietario, ad esempio annunci su un social network o sulla pagina dei risultati di un motore di ricerca o di un publisher che pubblica i propri annunci.
Se non hai dimestichezza con alcuni di questi termini o concetti, consulta il glossario di Privacy Sandbox.
Prova l'API
- Esegui il test localmente nel browser. Imposta un flag, che indica al browser Chrome di attivare funzionalità sperimentali specifiche.
Se ti interessa sperimentare l'API, consulta Report sull'attribuzione: esegui esperimenti e partecipa.
Modifiche all'API
- Tieni traccia delle modifiche all'API.
- Scopri perché abbiamo implementato l'API Attribution Reporting nella prima metà del 2023.
Disponibilità
提案 | 状态 |
---|---|
转化历程:应用到网站 网站说明和 Android 说明 邮寄名单通告 |
适用于 Chrome 和 Android 的源试用 |
转化历程:跨设备 说明 |
此提案已归档。目前没有实施计划。 |
使用报告验证功能防止可汇总报告无效 说明 |
此提案已归档。我们改为为此用例实现了 trigger_context_id 。 |
Attribution Reporting API Permissions-Policy 的默认许可名单将保持不变 * 邮寄名单通告 |
2023 年第 1 季度在 Chrome 中推出 |
可配置的事件级报告 epsilon GitHub 问题 |
2023 年第 4 季度在 Chrome 中推出 |
可汇总报告载荷的填充 更新了说明 |
2023 年第 4 季度在 Chrome 中推出 |
灵活事件级 “灵活事件级配置”说明 |
将于 2023 年第 4 季度在 Chrome 中推出
可自定义归因报告的数量以及报告期的数量/时长。 将于 2024 年第 1 季度在 Chrome 中推出 能够自定义触发器数据的位数。 |
支持不依赖于第三方 Cookie 的 Attribution Reporting 详细调试报告 说明 |
2024 年第 3 季度在 Chrome 中推出 |
支持 Google Cloud 的 Attribution Reporting API 和汇总服务 Attribution Reporting API 说明 汇总服务说明 |
2023 年下半年在 Chrome 中推出 |
灵活的贡献过滤 说明 |
2024 年第 3 季度在 Chrome 中推出 |
归因前过滤:归因范围 说明 |
2024 年第 4 季度在 Chrome 中推出 |
Casi d'uso e funzionalità
L'API Attribution Reporting consente di accedere a diversi tipi di approfondimenti con due tipi di report che possono essere inviati a un inserzionista o a un fornitore di tecnologia pubblicitaria di terze parti. Questi due tipi di report possono essere utilizzati contemporaneamente e sono complementari.
- I report a livello di evento associano un determinato clic o visualizzazione dell'annuncio (lato annuncio) ai dati relativi alle conversioni. I dati lato conversione sono molto limitati e contengono rumore (ovvero, in una piccola percentuale di casi, vengono inviati dati casuali anziché report reali). In questo modo viene preservata la privacy degli utenti impedendo l'unione dell'identità utente su più siti. Come ulteriore protezione della privacy, i report vengono inviati in ritardo.
- I report di riepilogo non sono legati a un evento specifico sul lato dell'annuncio. Questi report forniscono dati sulle conversioni più completi e accurati rispetto ai report a livello di evento. Una combinazione di tecniche di privacy contribuisce a ridurre il rischio di unione di identità su più siti.
Report a livello di evento
I report a livello di evento associano un clic o una visualizzazione dell'annuncio a dati sulle conversioni approssimativi.

news.example
(associato all'ID utente Bob_Doe del giorno news.example
) ha generato un acquisto il giorno shop.example
.I report a livello di evento sono adatti per:
- Ottimizzazione. Rispondi a domande come "Come posso migliorare il mio ritorno sull'investimento?". In particolare, questi report possono essere utilizzati per ottimizzare il posizionamento degli annunci, in quanto gli ID univoci lato annuncio possono essere resi disponibili nei report. I report a livello di evento possono fornire dati di addestramento per i modelli di machine learning.
- Report approssimativi, in cui sono necessarie pochissime informazioni sulla conversione. Il limite attuale è di 3 bit di dati sulle conversioni per i clic, il che significa che a una conversione può essere assegnata una di otto categorie, e di 1 bit per le visualizzazioni. La codifica di dati granulari lato conversione, ad esempio un prezzo o un'ora di conversione specifici, non è supportata nei report a livello di evento.
- Rilevamento delle frodi. I dati di alcuni report possono essere utili per il rilevamento e l'analisi della frode pubblicitaria, in quanto ti consentono di comprendere i pattern che possono essere utilizzati per identificare attività spam o non valide.
Report di riepilogo
I report di riepilogo (in precedenza report aggregati) offrono dati sulle conversioni più dettagliati e una maggiore flessibilità per unire i dati sulle conversioni e sui clic o sulle visualizzazioni.
Scopri di più sui report di riepilogo.

news.example
ha generato 518 conversioni su shoes.example
e una spesa totale di 38.174 $. La metà delle conversioni è stata generata da utenti di New York, Stati Uniti.I report di riepilogo sono i più adatti per i casi d'uso dei report. Questi report aiutano a rispondere a domande come: "Qual è il mio ritorno sull'investimento?"
L'utilizzo dei report di riepilogo per l'ottimizzazione, ad esempio per ottimizzare in base a un valore di acquisto, non supportato dai report a livello di evento (poiché i dati sulle conversioni sono troppo approssimativi), è un'area di ricerca attiva.
Altre funzionalità
Altre funzionalità di questa API includono:
- Attribuzione da app a web: visualizza o fai clic su un annuncio in un'app e genera una conversione sul web.
Supporto browser
- Firefox ed Edge non hanno condiviso indicatori.
- Safari e Webkit sono negativi e hanno proposto un'API diversa per misurare le conversioni degli annunci, chiamata Misurazione dei clic privati.
Sebbene le due API siano diverse, Chrome e WebKit collaborano in modo aperto per semplificare l'esperienza degli sviluppatori, ad esempio allineandosi ai nomi degli attributi e alla struttura JSON per i report.
L'insieme di funzionalità dell'API Attribution Reporting è diverso da quello dell'API Private Click Measurement proposta da Safari e WebKit. In particolare, con l'API Attribution Reporting:
- La misurazione view-through è supportata.
- È possibile fornire report a livello di evento.
- I report di riepilogo contengono informazioni dettagliate sia per i clic/le visualizzazioni sia per le conversioni.
- Terze parti come le piattaforme di tecnologia pubblicitaria possono ricevere report per conto di editori e inserzionisti.
Configurazione del browser
- Gli utenti possono disattivare l'API tramite le impostazioni utente all'indirizzo
chrome://settings/adPrivacy
. - L'API non è attiva in modalità di navigazione in incognito.
In che modo i siti possono controllare l'accesso?
Se l'API è disponibile in un determinato browser, è disponibile per impostazione predefinita in qualsiasi sito, sia in documenti e script di primo livello sia in iframe dello stesso dominio.
Terze parti arbitrarie, ad esempio iframe degli annunci cross-origin che non sono stati aggiunti alla pagina con uno script con accesso di primo livello, non possono utilizzare l'API senza che il publisher o l'inserzionista lo sappiano: in questi iframe, l'API Attribution Reporting deve essere attivata esplicitamente con le norme relative alle autorizzazioni.
<iframe src="..." allow="attribution-reporting"></iframe>
Le terze parti con accesso di primo livello che aggiungono iframe cross-origin a una pagina possono anche attivare l'API Attribution Reporting con il criterio Autorizzazioni.
Un sito può disattivare l'API Attribution Reporting per tutte le parti, inclusi gli script con accesso di primo livello, inviando l'intestazione di risposta HTTP:
Permissions-Policy: attribution-reporting=()
Come funziona l'API Attribution Reporting?
L'API Attribution Reporting consente di misurare due eventi collegati tra loro: un evento sul sito web di un publisher, ad esempio un utente che visualizza o fa clic su un annuncio, con una successiva conversione sul sito di un inserzionista.
Report a livello di evento

il browser abbina clic o visualizzazioni ai dati sulle conversioni definiti da una tecnologia pubblicitaria.
Successivamente, il browser invia i report risultanti a un endpoint predefinito, con un po' di ritardo e rumore.
Report di riepilogo

I report di riepilogo sono generati come segue:
- Un utente fa clic o visualizza un annuncio con una configurazione specifica. Il browser sul dispositivo locale dell'utente registra questo evento, insieme ai dati di configurazione dell'attribuzione prestabiliti.
- In un secondo momento, quando l'utente effettua la conversione, il browser abbina questo evento di clic o visualizzazione dettagliato (noto come evento di origine dell'attribuzione) a dati di conversione dettagliati (noti come dati di attivazione dell'attribuzione). Le dimensioni dei dettagli acquisiti sono predefinite da un'azienda di tecnologia pubblicitaria e il browser segue una logica specifica definita dalla tecnologia pubblicitaria. Il browser restituisce questi dati in un report aggregabile.
- I report aggregabili vengono criptati dal browser e inviati a un server di tecnologia pubblicitaria. Dal server di tecnologia pubblicitaria, i report aggregabili vengono inviati al servizio di aggregazione per produrre un report di riepilogo.
- I report di riepilogo vengono quindi resi disponibili alla tecnologia pubblicitaria. Tieni presente che i report di riepilogo non vengono ritardati nella stessa misura dei report a livello di evento.
Scopri di più sui report di riepilogo.
Privacy
A differenza dei cookie di terze parti, l'API Attribution Reporting consente alle aziende pubblicitarie di ottenere informazioni sulle conversioni senza monitorare l'attività di un individuo su più siti.
Prendiamo ad esempio una persona di nome Bob. Roberto vede un annuncio mentre legge le notizie su news.example
. Una settimana dopo, Paolo acquista scarpe su
shoes.example
.
Oggi questa conversione viene monitorata da un cookie di terze parti
utilizzato come identificatore tra siti.
Con i cookie di terze parti, una società di ad tech può accedere a molti dettagli sull'attività di Bob su news.example
e su
shoes.example
. La tecnologia pubblicitaria può unire queste informazioni per creare un profilo dettagliato di Bob, inclusa la sua posizione, le sue abitudini di navigazione e le letture preferite su news.example
. Questo profilo potrebbe anche includere acquisti, attività e dati della carta di credito su shoes.example
. Questa unione tra siti è utile per misurare le conversioni degli annunci. Tuttavia, ostacola la privacy degli utenti:
l'attività di Bob viene monitorata su più siti con un elevato livello di dettaglio.

Una piccola quantità di informazioni viene unita
tra i siti: sufficiente per misurare le conversioni, ma non
sufficiente per monitorare in dettaglio l'attività di Bob tra i siti. Le attività di Bob su news.example
e shoes.example
rimangono separate.
Protezioni in ogni tipo di report
I report a livello di evento collegano un identificatore lato annuncio a una piccola quantità di dati lato conversione. Sebbene forniscano informazioni su più siti su una conversione, le informazioni relative alle conversioni sono troppo generiche per unire l'identità dell'utente su più siti.
I report di riepilogo forniscono informazioni dettagliate, ma solo a livello aggregato. Poiché i contenuti di questi report aggregabili vengono criptati quando vengono inviati alla tecnologia pubblicitaria, quest'ultima non può ottenere alcuna informazione dai report senza utilizzare un servizio di aggregazione. Il servizio di aggregazione fornisce accesso solo ad aggregati con rumore.
Ulteriori protezioni della privacy, come le limitazioni di frequenza, vengono applicate sia ai report a livello di evento sia a quelli aggregati.

In dettaglio: report a livello di evento e privacy
I report a livello di evento forniscono approfondimenti sulle conversioni senza monitorare gli utenti su più siti, seguendo i seguenti meccanismi di privacy:
- Non viene utilizzato alcun identificatore cross-site e nessuna attività di navigazione cross-site dettagliata viene inviata dal dispositivo.
- I report a livello di evento associano 64 bit di informazioni sul lato dell'annuncio
(
news.example
) a solo 1 bit o 3 bit sul lato della conversione (shop.example
). 64 bit sono informazioni sufficienti per essere associate a un identificatore utente individuale, ma questi 64 bit possono essere collegati solo a pochissime informazioni tra siti: 1 bit o 3 bit, che non sono sufficienti per contenere un identificatore.- I 64 bit lato annuncio non sono nuove informazioni. Un ID utente può essere già disponibile per la parte pubblicitaria.
news.example
oadtech.example
è già a conoscenza dell'attività di un determinato utente sunews.example
.
- I 64 bit lato annuncio non sono nuove informazioni. Un ID utente può essere già disponibile per la parte pubblicitaria.
- Vengono applicate protezioni aggiuntive per prevenire abusi e monitoraggio tra siti web:
- I report vengono inviati con un ritardo.
- I dati sulle conversioni sono contenuti in un contesto caotico: in una certa percentuale di casi, vengono generati report falsi.
- Il numero di report sulle conversioni attribuite è limitato per clic o visualizzazione.
In dettaglio: report di riepilogo e privacy
I report di riepilogo associano un evento di clic o visualizzazione a dati di conversione dettagliati. Forniscono approfondimenti sulle conversioni senza monitorare gli utenti sui siti utilizzando i seguenti meccanismi di privacy:
- Non viene utilizzato alcun identificatore cross-site.
- Ogni attribuzione può apportare più contributi a un report di riepilogo risultante. Qualsiasi utente può attivare più attribuzioni per un determinato clic (o visualizzazione) e una conversione.
- I dati vengono aggregati fino al livello di molti eventi (molti utenti) e non è possibile osservare con precisione singoli eventi. Quando esamini i dati aggregati, con l'aumentare del livello di dettaglio aumenta anche il rumore relativo su questi dati. I dati aggregati che raggruppano molti eventi e utenti sono più precisi per preservarne l'utilità.
- I report non elaborati che associano un evento di clic o visualizzazione dettagliato a dati sulle conversioni dettagliati sono criptati e non sono leggibili dalla società di tecnologia pubblicitaria. Questi dati possono essere letti solo dal servizio di aggregazione.
- Vengono applicate protezioni aggiuntive per prevenire abusi e monitoraggio tra siti web:
- I report vengono inviati con ritardi casuali.
- Le query su diversi segmenti di dati sono limitate in termini di frequenza.
Coinvolgere e condividere feedback
- Per domande sull'API: crea un problema nel repository dell'API.
- Segui gli aggiornamenti e gli annunci relativi all'API nella mailing list di Attribution Reporting.
- Se hai domande tecniche, segnala un bug di Chromium.
- Per domande sull'implementazione, sull'integrazione e sulle best practice generali: crea un problema nel repository di assistenza per sviluppatori di Privacy Sandbox.