Misura quando un clic o una visualizzazione su un annuncio genera una conversione, come un acquisto sul sito di un inserzionista.
A chi è destinato?
Qui troverai le nozioni di base di Attribution Reporting e alcuni concetti alla base, ma non molti dettagli tecnici.
- Se lavori nel campo della pubblicità o delle tecnologie pubblicitarie, scoprirai in che modo questa API offre funzionalità abilitate dai cookie di terze parti. Consulta i casi d'uso delle API, per scoprire ulteriori dettagli su come vengono generati i report.
- Se sei uno sviluppatore o un ingegnere informatico, vai alla panoramica completa del sistema o sperimenta e partecipa con l'API.
Gli inserzionisti e i publisher che si affidano a piattaforme di tecnologie pubblicitarie per la misurazione delle conversioni non devono utilizzare direttamente l'API. Ti potrebbe interessare scoprire come funziona Attribution Reporting se la tua tecnologia pubblicitaria prevede l'integrazione con questa API.
Che cos'è l'API Attribution Reporting?
Oggi, 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é questi possono essere utilizzati per monitorare gli utenti sui siti e ostacolare 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 sugli annunci.
- Annunci in un iframe di terze parti, come gli annunci sul sito di un publisher che utilizza un fornitore di tecnologia pubblicitaria di terze parti.
- Annunci in un contesto proprietario, ad esempio annunci su un social network o una pagina dei risultati di un motore di ricerca, oppure 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 test in locale nel browser. Imposta un flag, che indichi al browser Chrome di attivare funzionalità sperimentali specifiche.
Se ti interessa sperimentare con l'API, vai ad Attribution Reporting: sperimentare e partecipare.
Modifiche all'API
- Tieni traccia delle modifiche dell'API.
- Scopri perché abbiamo fornito l'API Attribution Reporting nella prima metà del 2023.
Disponibilità
Proposta | Stato |
---|---|
Percorso di conversione: dall'app al web Messaggio esplicativo sul web e Messaggio esplicativo su Android Annuncio relativo alla mailing list |
Disponibile in Chrome e Android per la prova dell'origine |
Percorso di conversione: cross-device Spiegazione |
Questa proposta è stata archiviata. Al momento non sono presenti piani per l'implementazione. |
Prevenzione dei report aggregabili non validi utilizzando la verifica dei report Spiegazione |
Previsto in Chrome nella prima metà del 2024 |
La lista consentita predefinita per il criterio di autorizzazione dell'API Attribution Reporting rimarrà * Annuncio della mailing list |
Disponibile in Chrome nel primo trimestre del 2023 |
Report epsilon a livello di evento configurabile Problemi relativi a GitHub |
Disponibile in Chrome nel quarto trimestre del 2023 |
Spaziatura interna per il payload dei report aggregati Spiegazione aggiornata |
Disponibile in Chrome nel quarto trimestre del 2023 |
Fase 1 Lite: flessibile a livello di evento Spiegazione delle configurazioni flessibili a livello di evento |
Funzionalità disponibile in Chrome nel quarto trimestre del 2023
Possibilità di personalizzare il numero di report sull'attribuzione e il numero/la lunghezza delle finestre di report. Funzionalità disponibile in Chrome nel primo trimestre del 2024 Possibilità di personalizzare il numero di bit dei dati degli attivatori. |
Supporto del debug di Attribution Reporting dopo il ritiro dei cookie di terze parti Ricerca di feedback su GitHub |
Previsto in Chrome nella prima metà del 2024 |
Supporto per l'API Attribution Reporting e Aggregation Service per Google Cloud Spiegazione dell'API Attribution Reporting Aggregation Service Explainer |
Disponibili in Chrome nella seconda metà del 2023 |
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 sull'annuncio (sul lato annuncio) ai dati sul lato conversione. I dati dal lato delle conversioni sono molto limitati e i dati sono distorti (il che significa che per una piccola percentuale di casi vengono inviati dati casuali al posto dei report reali). In questo modo viene tutelata la privacy degli utenti impedendo l'unione dell'identità utente tra i siti. Come ulteriore protezione della privacy, le segnalazioni vengono inviate con un ritardo.
- I report di riepilogo non sono legati a un evento specifico sul lato annuncio. Questi report forniscono dati sulle conversioni più completi e accurati rispetto ai report a livello di evento. Una combinazione di tecniche di tutela della privacy aiuta a ridurre il rischio di unione delle identità tra i siti.
Report a livello di evento
I report a livello di evento associano un clic o una visualizzazione sull'annuncio a dati approssimativi sulle conversioni.
![Report a livello di evento](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/event-level-report-4b1ba87d8a313.png?authuser=7&hl=it)
news.example
(associato all'ID utente Bob_Doe in 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 faccio a migliorare il ritorno sull'investimento?". In particolare, questi report possono essere utilizzati per ottimizzare il posizionamento degli annunci, poiché 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, per cui sono necessarie pochissime informazioni sulla conversione. Attualmente il limite attuale è di 3 bit di dati di conversione per i clic, quindi a una conversione può essere assegnata una di otto categorie e un bit per le visualizzazioni. La codifica dei dati granulari sul lato delle conversioni, ad esempio un prezzo specifico o una data e ora della conversione, non è supportata nei report a livello di evento.
- Rilevamento di attività fraudolente. I dati di alcuni report possono essere utili per il rilevamento e l'analisi di attività fraudolente pubblicitarie, poiché ti consentono di comprendere i pattern che possono essere utilizzati per identificare le attività non valide o di spam.
Report di riepilogo
I report di riepilogo (precedentemente noti come report aggregati) offrono dati sulle conversioni più dettagliati e una maggiore flessibilità per unire i dati sui clic o sulle visualizzazioni e i dati sulle conversioni.
Scopri di più sui report di riepilogo.
![Esempio di approfondimenti dei report di riepilogo.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?authuser=7&hl=it)
news.example
ha generato 518 conversioni nel seguente periodo: shoes.example
e una spesa totale di 38.174 $. Metà delle conversioni proveniva da utenti residenti a New York, Stati Uniti.I report di riepilogo sono più adatti per la segnalazione di casi d'uso. Questi report aiutano a rispondere a domande quali: "Qual è il mio ritorno sull'investimento?"
L'utilizzo dei report di riepilogo per l'ottimizzazione, ad esempio l'ottimizzazione in base a un valore di acquisto, che non è supportato dai report a livello di evento (perché i dati sulle conversioni sono troppo approssimativi), è un'area di ricerca attiva.
Altre caratteristiche
Altre funzionalità di questa API includono:
- Attribuzione da app a web: visualizza o fai clic su un annuncio in un'app ed effettua la conversione sul web.
Supporto del browser
- Firefox ed Edge non hanno indicatori condivisi.
- 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 stanno lavorando insieme per semplificare l'esperienza degli sviluppatori, ad esempio allineando i nomi degli attributi e la struttura JSON per i report.
Il set 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 sul lato clic/visualizzazione sia sul lato delle conversioni.
- Terze parti, come le piattaforme di tecnologia pubblicitaria, possono ricevere report per conto di publisher e inserzionisti.
Configurazione del browser
- Gli utenti possono disattivare l'API con le impostazioni utente all'indirizzo
chrome://settings/adPrivacy
. - L'API non è attiva in modalità di navigazione in incognito.
- L'API non è attiva quando i cookie di terze parti sono disabilitati.
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 nei documenti e negli script di primo livello, sia negli iframe della stessa origine.
Le terze parti arbitrarie, ad esempio iframe di annunci multiorigine 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 ne siano a conoscenza. In questi iframe, l'API Attribution Reporting deve essere abilitata esplicitamente insieme alle norme relative alle autorizzazioni.
<iframe src="..." allow="attribution-reporting"></iframe>
Anche le terze parti con accesso di primo livello che aggiungono iframe multiorigine a una pagina possono attivare l'API Attribution Reporting con le norme relative alle autorizzazioni.
Un sito può disattivare l'API Attribution Reporting per tutte le parti, inclusi gli script con accesso di primo livello, inviando l'intestazione della 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 conversione successiva sul sito di un inserzionista.
Report a livello di evento
![report a livello di evento](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/event-level-report-ef2aec13f54f9.png?authuser=7&hl=it)
Il browser associa i clic o le visualizzazioni ai dati sulle conversioni definiti da una tecnologia pubblicitaria.
Successivamente, il browser invia i report risultanti a un endpoint predefinito, con qualche ritardo e rumore.
Report di riepilogo
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?authuser=7&hl=it)
I report di riepilogo vengono generati come segue:
- Un utente fa clic o visualizza un annuncio appositamente configurato. Il browser, sul dispositivo locale dell'utente, registra questo evento insieme ai dati di configurazione dell'attribuzione prespecificati.
- In seguito, quando l'utente effettua una conversione, il browser associa questo evento dettagliato di visualizzazione o clic (noto come evento origine attribuzione) con dati di conversione dettagliati, noti come dati di attivazione dell'attribuzione. Le dimensioni dei dettagli acquisiti sono predefinite da un'azienda di ad tech e il browser segue una logica specifica definita dalla tecnologia pubblicitaria. Il browser restituisce questi dati in un report aggregabile.
- I report aggregati vengono criptati dal browser e inviati a un server ad tech. Dal server ad tech, i report aggregabili vengono inviati al servizio di aggregazione per produrre un report di riepilogo.
- I report di riepilogo vengono quindi messi a disposizione del team ad tech. Tieni presente che i report di riepilogo non subiscono lo stesso ritardo 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 società pubblicitarie di ottenere informazioni sulle conversioni senza monitorare l'attività di un singolo utente sui siti.
Prendiamo una persona di nome Bob. Roberto vede un annuncio mentre legge
le notizie su news.example
. Una settimana dopo, Bob 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, un'azienda di ad tech può accedere a molti dettagli sull'attività di Roberto su news.example
e su shoes.example
. La tecnologia pubblicitaria può unire queste informazioni per creare un profilo dettagliato di Roberto, che include la posizione, le abitudini di navigazione e le letture preferite su news.example
. Questo profilo potrebbe includere anche
acquisti, attività e dati della carta di credito su
shoes.example
. Questa unione tra siti è utile
per misurare le conversioni degli annunci. ma ostacola la privacy dell'utente:
l'attività di Roberto viene monitorata sui siti con un livello di dettaglio elevato.
![Visualizzazione affiancata del web di oggi (identità unita) e del web di domani (identità partizionata)](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?authuser=7&hl=it)
Viene unita una piccola quantità di informazioni tra i siti: sufficiente per misurare le conversioni, ma non sufficiente per monitorare in dettaglio l'attività di Roberto sui siti. L'attività di Roberto
su news.example
e su shoes.example
rimane
separata.
Protezioni in ogni tipo di report
I report a livello di evento collegano un identificatore lato annuncio a una piccola quantità di dati sul lato conversione. Sebbene forniscono informazioni cross-site su una conversione, le informazioni sul lato conversione sono troppo approssimative per unire l'identità utente su più siti.
I report di riepilogo forniscono approfondimenti dettagliati, 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 ai dati aggregati sul rumore.
Ulteriori protezioni della privacy, come limitazioni di frequenza, sono applicate sia ai report a livello di evento che a quelli aggregati.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?authuser=7&hl=it)
In dettaglio: report e privacy a livello di evento
I report a livello di evento forniscono informazioni sulle conversioni senza monitorare gli utenti su più siti, seguendo i seguenti meccanismi di tutela della privacy:
- Non viene utilizzato alcun identificatore tra siti e nessuna attività di navigazione tra siti dettagliata esce dal dispositivo.
- I report a livello di evento associano 64 bit di informazioni sul lato annuncio
(
news.example
) a solo 1 bit o 3 bit sul lato conversione (shop.example
). 64 bit sono informazioni sufficienti per essere mappati a un identificatore utente singolo, ma questi 64 bit possono essere collegati solo a pochissime informazioni tra siti: 1 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
sul lato annuncio.
news.example
oadtech.example
conosce già l'attività di un determinato utente sunews.example
.
- I 64 bit lato annuncio non sono nuove informazioni. Un ID utente può essere già disponibile
sul lato annuncio.
- Vengono applicate protezioni aggiuntive per impedire utilizzi illeciti e il monitoraggio tra siti:
- I report vengono inviati con ritardo.
- I dati sulle conversioni contengono rumore: una determinata percentuale di volte 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 sulle conversioni dettagliati. Forniscono informazioni sulle conversioni senza monitorare gli utenti tra i siti, utilizzando i seguenti meccanismi di tutela della privacy:
- Non viene utilizzato alcun identificatore tra siti.
- 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 conversione.
- I dati vengono aggregati fino al livello di molti eventi (molti utenti) e nessun singolo evento può essere osservato con precisione. Quando si esaminano i dati aggregati, con l'aumento del livello di dettaglio aumenta anche il rumore relativo su tali dati. Sezioni di dati che aggregano molti eventi e gli utenti sono più precisi per mantenerne l'utilità.
- I report non elaborati che associano un evento dettagliato di clic o visualizzazione a dati sulle conversioni dettagliati sono criptati e non leggibili dall'azienda di ad tech. Questi dati possono essere letti solo dal servizio di aggregazione.
- Vengono applicate protezioni aggiuntive per impedire utilizzi illeciti e il monitoraggio tra siti:
- I report vengono inviati con ritardi casuali.
- Le query su diverse sezioni di dati sono limitate di frequenza.
Interagisci e condividi il feedback
- Per domande sull'API: crea un problema nel repository delle API.
- Segui gli aggiornamenti e gli annunci dell'API nella mailing list Attribution Reporting.
- Se hai domande tecniche, segnala un bug di Chromium.
- Per domande relative all'implementazione, all'integrazione e alle best practice generali: crea un problema nel repository di assistenza per gli sviluppatori di Privacy Sandbox.