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à
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 (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.
![Report a livello di evento](https://developers.google.cn/static/privacy-sandbox/assets/images/event-level-report-4b1ba87d8a313.png?authuser=0&hl=it)
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.
![Esempio di approfondimenti tratti dai report di riepilogo.](https://developers.google.cn/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?authuser=0&hl=it)
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
![report a livello di evento](https://developers.google.cn/static/privacy-sandbox/assets/images/event-level-report-ef2aec13f54f9.png?authuser=0&hl=it)
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
![](https://developers.google.cn/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?authuser=0&hl=it)
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.
![Visualizzazione affiancata del web di oggi (identità unita) e del web di domani (identità partizionata)](https://developers.google.cn/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?authuser=0&hl=it)
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.
![](https://developers.google.cn/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?authuser=0&hl=it)
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.