Misura quando un clic o una visualizzazione dell'annuncio genera una conversione, ad esempio un acquisto sul sito di un inserzionista.
A chi è rivolto questo servizio?
Qui troverai le nozioni di base dei report sull'attribuzione e alcuni concetti sottostanti, ma non molti dettagli tecnici.
- Se lavori nel settore della pubblicità o della tecnologia pubblicitaria, scoprirai in che modo questa API fornisce funzionalità abilitate dai cookie di terze parti. Consulta i casi d'uso dell'API, che forniscono maggiori dettagli su come vengono generati i report.
- Se sei uno sviluppatore o un ingegnere software, consulta la panoramica completa del sistema o sperimenta e partecipa con l'API.
Gli inserzionisti e i publisher che si affidano a piattaforme di tecnologia pubblicitaria per la misurazione delle conversioni non devono utilizzare direttamente l'API. Potresti essere interessato a capire come funziona l'API Attribution Reporting se la tua tecnologia pubblicitaria prevede di integrarsi con questa API.
Che cos'è l'API Attribution Reporting?
Oggi, la misurazione delle conversioni degli annunci si basa spesso sui cookie di terze parti. I browser limitano l'accesso ai cookie di terze parti perché possono essere utilizzati per monitorare gli utenti su più siti e ostacolare la privacy degli utenti.
L'API Attribution Reporting consente queste misurazioni in modo rispettoso della privacy, senza cookie di terze parti.
Questa API consente a inserzionisti e 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 annunci su un sito 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 familiarità 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, visita la pagina Report sull'attribuzione: sperimentazione e partecipazione.
Modifiche alle API
- Tieni traccia delle modifiche all'API.
- Scopri perché abbiamo rilasciato l'API Attribution Reporting nella prima metà del 2023.
Disponibilità
| Proposta | Stato |
|---|---|
| Percorso di conversione: da app a web spiegazione del web e spiegazione di Android Annuncio della 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 previsti piani di implementazione. |
| Impedire la generazione di report aggregabili non validi utilizzando la verifica dei report Spiegazione |
Questa proposta è stata archiviata. Per questo caso d'uso abbiamo implementato trigger_context_id. |
| La lista consentita predefinita per le norme relative alle autorizzazioni dell'API Attribution Reporting rimarrà invariata * Annuncio della mailing list |
Disponibile in Chrome nel primo trimestre del 2023 |
| Epsilon per i report a livello di evento configurabile Problema GitHub |
Disponibile in Chrome nel quarto trimestre del 2023 |
| Spaziatura per il payload dei report aggregabili Spiegazione aggiornata |
Disponibile in Chrome nel quarto trimestre del 2023 |
| A livello di evento flessibile Spiegazione delle configurazioni a livello di evento flessibile |
Disponibile in Chrome nel quarto trimestre del 2023
La possibilità di personalizzare il numero di report sull'attribuzione e il numero/la durata delle finestre dei report. Disponibile in Chrome nel primo trimestre del 2024 La possibilità di personalizzare il numero di bit di dati di attivazione. |
| Supporto per i report di debug dettagliati di Attribution Reporting non dipendenti dai cookie di terze parti Spiegazione |
Disponibile in Chrome nel terzo trimestre del 2024 |
| Supporto dell'API Attribution Reporting e del servizio di aggregazione per Google Cloud Guida all'API Attribution Reporting Guida al servizio di aggregazione |
Disponibile in Chrome nella seconda metà del 2023 |
| Spiegazione del filtro dei contributi flessibili |
Disponibile in Chrome nel terzo trimestre del 2024 |
| Filtro pre-attribuzione: ambiti di attribuzione Spiegazione |
Disponibile in Chrome nel quarto trimestre del 2024 |
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 (sul lato annuncio) ai dati sul lato conversione. I dati lato conversione sono molto limitati e sono soggetti a rumore (il che significa che per 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 tra i vari siti. Come ulteriore protezione della privacy, i report vengono inviati in ritardo.
- I report di riepilogo non sono collegati a un evento specifico sul lato annuncio. Questi report forniscono dati sulle conversioni più ricchi e fedeli rispetto ai report a livello di evento. Una combinazione di tecniche per la 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 dell'annuncio a dati sulle conversioni approssimativi.
news.example (associato all'ID utente Bob_Doe su news.example) ha portato a un acquisto su shop.example.I report a livello di evento sono adatti per:
- Ottimizzazione. Rispondere 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 delle otto categorie, e di 1 bit per le visualizzazioni. La codifica dei dati granulari lato conversione, ad esempio un prezzo specifico o l'ora di conversione, 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 consentono di comprendere i pattern che possono essere utilizzati per identificare attività di spam o non valide.
Report di riepilogo
I report riepilogativi (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.
news.example ha generato 518 conversioni su shoes.example e una spesa totale di 38.174 $. La metà delle conversioni proveniva da utenti di New York, Stati Uniti.I report di riepilogo sono più adatti ai casi d'uso dei report. Questi report ti aiutano a rispondere a domande come: "Qual è il mio ritorno sull'investimento?"
L'utilizzo dei report di riepilogo per l'ottimizzazione, ad esempio per 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 aggregati), è 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 converti sul web.
Supporto browser
- Firefox ed Edge non hanno condiviso indicatori.
- Safari e Webkit sono contrari e hanno proposto un'API diversa per misurare le conversioni degli annunci, chiamata Private Click Measurement.
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.
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.
- Possono essere forniti report a livello di evento.
- I report di riepilogo contengono informazioni dettagliate sia sul lato dei clic/delle visualizzazioni sia su quello delle conversioni.
- Terze parti, come le piattaforme di tecnologie pubblicitarie, possono ricevere report per conto di publisher 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 nei documenti e negli script di primo livello sia negli iframe con stessa origine.
Terze parti arbitrarie, ad esempio iframe di annunci multiorigine che non sono stati aggiunti alla pagina con uno script che ha accesso di primo livello, non possono utilizzare l'API senza la conoscenza di un publisher o di un inserzionista: in questi iframe, l'API Attribution Reporting deve essere abilitata esplicitamente con la policy Permissions.
<iframe src="..." allow="attribution-reporting"></iframe>
Le terze parti con accesso di primo livello che aggiungono iframe multiorigine a una pagina possono anche attivare l'API Attribution Reporting con Permissions Policy.
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 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 società pubblicitarie di ottenere informazioni sulle conversioni senza monitorare l'attività di un individuo su più siti.
Prendiamo una persona di nome Bob. Mario vede un annuncio mentre legge
le notizie su news.example. Una settimana dopo, Paolo acquista delle scarpe su
shoes.example.
Oggi, questa conversione verrebbe monitorata da un cookie di terze parti
utilizzato come identificatore cross-site.
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, inclusi la sua posizione, le sue abitudini di navigazione e le sue letture preferite su news.example. Questo profilo potrebbe includere anche acquisti, attività e dati della carta di credito su shoes.example. Questa giunzione cross-site è utile per misurare
le conversioni degli annunci. Tuttavia, ostacola la privacy degli utenti:
L'attività di Bob viene monitorata su tutti i siti con un elevato livello di dettaglio.
Una piccola quantità di informazioni viene unita
tra i siti, quanto basta per misurare le conversioni, ma non
per monitorare in dettaglio l'attività di Bob tra i siti. L'attività di Bob 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 lato conversione. Sebbene forniscano informazioni cross-site su una conversione, le informazioni lato conversione 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 solo l'accesso ad aggregazioni rumorose.
Ulteriori protezioni della privacy, come i limiti di frequenza, vengono imposte 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 informazioni sulle conversioni senza monitorare gli utenti sui siti, seguendo i seguenti meccanismi di tutela della privacy:
- Non viene utilizzato alcun identificatore cross-site e nessuna attività di navigazione cross-site dettagliata lascia il 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 mappate a un identificatore utente individuale, ma questi 64 bit possono essere collegati solo a pochissime informazioni cross-site: 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ò già essere
disponibile oggi sul lato annuncio.
news.exampleoadtech.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ò già essere
disponibile oggi sul lato annuncio.
- Vengono applicate protezioni aggiuntive per impedire comportamenti illeciti e il monitoraggio tra siti:
- I report vengono inviati con un ritardo.
- I dati sulle conversioni sono disturbati: in una certa percentuale di casi vengono generati report falsi.
- Il numero di report sulle conversioni attribuite è limitato per clic o visualizzazione.
Nel dettaglio: report riepilogativi 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 su tutti i siti, utilizzando i seguenti meccanismi di tutela della privacy:
- Non viene utilizzato alcun identificatore tra siti.
- Ogni attribuzione può dare più contributi a un report di riepilogo risultante. Un determinato utente può attivare più attribuzioni per un particolare clic (o visualizzazione) e conversione.
- I dati vengono aggregati fino al livello di molti eventi (molti utenti) e non è possibile osservare con precisione i singoli eventi. Quando esamini i dati aggregati, man mano che il livello di dettaglio aumenta, aumenta anche il rumore relativo su questi dati. Le sezioni di dati che aggregano molti eventi e utenti sono più precise per preservare l'utilità.
- I report non elaborati che associano un evento di clic o visualizzazione dettagliato a dati di conversione dettagliati sono criptati e non leggibili dalla società di tecnologia pubblicitaria. Questi dati possono essere letti solo dal servizio di aggregazione.
- Vengono applicate protezioni aggiuntive per impedire comportamenti illeciti e il monitoraggio tra siti:
- I report vengono inviati con ritardi casuali.
- Le query su diverse sezioni dei dati sono soggette a limiti di frequenza.
Partecipare e condividere feedback
- Per domande sull'API: crea un problema nel repository dell'API.
- Segui gli aggiornamenti e gli annunci dell'API nella mailing list di Attribution Reporting.
- Se hai domande tecniche, segnala un bug di Chromium.