Misura quando un clic o una visualizzazione su un annuncio genera una conversione, come un acquisto su un sito dell'inserzionista.
A chi è destinato?
Qui troverai le nozioni di base di Attribution Reporting e alcune informazioni di base ma non con molti dettagli tecnici.
- Se lavori nel campo della pubblicità o delle tecnologie pubblicitarie, scoprirai in che modo questa API fornisce funzionalità abilitate dai cookie di terze parti. Controllo i casi d'uso delle API, con maggiori dettagli su come vengono generati report.
- Se sei uno sviluppatore o un ingegnere informatico, consulta la panoramica completa del sistema oppure sperimentare e partecipare con l'API.
Inserzionisti e publisher che si affidano a piattaforme di tecnologie pubblicitarie per le conversioni non hanno bisogno di usare direttamente l'API. Potrebbero interessarti capire 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 soluzioni di terze parti cookie. I browser stanno limitando l'accesso ai cookie di terze parti perché possono essere utilizzati per monitorare gli utenti sui siti e ostacolare la loro privacy.
L'API Attribution Reporting consente queste misurazioni in una che tutela la privacy, senza cookie di terze parti.
Questa API consente agli inserzionisti e ai fornitori di tecnologia pubblicitaria di misurare le conversioni in: 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 una fornitore di tecnologia pubblicitaria di terze parti.
- Annunci in un contesto proprietario, ad esempio annunci su un social network o una ricerca pagina dei risultati del motore di ricerca o 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 indica al browser Chrome di attivare specifiche le funzionalità di machine learning.
Se ti interessa sperimentare l'API, vai a Attribution Reporting: sperimentazione e partecipazione.
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 informazioni con due tipi di report che possono essere inviati a un inserzionista o a un team ad tech di terze parti o il provider di servizi di terze parti. Questi due tipi di report possono essere utilizzati contemporaneamente e sono complementari.
- I report a livello di evento associano un determinato annuncio o una visualizzazione (sul lato degli annunci) con i dati sul lato delle conversioni. I dati dal lato delle conversioni sono molto limitati e i dati sono rumorosi (il che significa che per una piccola percentuale di casi, vengono inviati dati casuali al posto di report reali). In questo modo viene tutelata la privacy dell'utente impedendo l'unione dell'identità utente tra siti. Come ulteriore protezione della privacy, le segnalazioni vengono inviate con un ritardo.
- I report di riepilogo non sono legati a un evento specifico su lato annuncio. Questi report forniscono dati più completi e accurati sulle conversioni. rispetto ai report a livello di evento. Una combinazione di tecniche di tutela della privacy contribuisce a ridurre rischio di unione delle identità tra 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=19&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 mio ritorno sull'investimento sull'investimento?". In particolare, questi report possono essere utilizzati per ottimizzare gli annunci perché 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 approssimati, per cui sono necessarie pochissime informazioni sul e conversione in blocco. Il limite attuale è di 3 bit di dati sulle conversioni per i clic ⏤questo significa che a una conversione può essere assegnata una delle otto categorie ⏤ e 1 bit per visualizzazioni. Codifica dei dati granulari sul lato delle conversioni, ad esempio una per un prezzo o una data e ora della conversione specifici non sono supportati nei report a livello di evento.
- Rilevamento di attività fraudolente. I dati di alcuni report possono essere utili per la frode pubblicitaria rilevamento e analisi, consentendoti di comprendere i pattern che possono utilizzati per identificare spam o attività non valide.
Report di riepilogo
I report di riepilogo (precedentemente noti come report aggregati) offrono informazioni Dati sulle conversioni e maggiore flessibilità per unire i dati relativi a clic o visualizzazioni e conversioni e i dati di Google Cloud.
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=19&hl=it)
news.example
ha generato 518 conversioni nel seguente periodo: shoes.example
e una spesa totale di 38174 $. 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 consentono di Rispondi a domande quali: "Qual è il mio ritorno sull'investimento?"
Utilizzo di report di riepilogo per l'ottimizzazione, ad esempio per ottimizzare per 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 funzionalità
Altre funzionalità di questa API includono:
- Attribuzione da app a web: vedere o fare clic su un annuncio in un'app ed eseguire la conversione sul web.
Supporto browser
- Firefox ed Edge non hanno indicatori condivisi.
- Safari e Webkit è negativo e ha proposto un'API diversa per misurare le conversioni degli annunci, chiamata Private Click Misurazione.
Sebbene le due API siano diverse, Chrome e WebKit stanno lavorando insieme nel disponibili per semplificare l'esperienza degli sviluppatori, ad esempio allineandosi dei nomi degli attributi e Struttura di JSON per i report.
Il set di funzionalità dell'API Attribution Reporting è diverso da quello dell'API Attribution Reporting 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 ad tech, 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 un determinato sito, sia in documenti e script di primo livello sia in iframe della stessa origine.
Terze parti arbitrarie, ad esempio iframe di annunci multiorigine che non erano aggiunto alla pagina con uno script con accesso di primo livello, non puoi utilizzare l'API all'insaputa del publisher o dell'inserzionista: in questi iframe, il parametro L'API Attribution Reporting deve essere abilitata esplicitamente con Autorizzazioni .
<iframe src="..." allow="attribution-reporting"></iframe>
Le terze parti con accesso di primo livello che aggiungono iframe multiorigine a una pagina possono attivare anche l'API Attribution Reporting con Norme relative alle autorizzazioni.
Un sito può disattivare l'API Attribution Reporting per tutte le parti, incluse 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 insieme: un evento sul sito web di un publisher, ad esempio un utente che visualizza o fa clic 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=19&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=19&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 ritardi nello stesso modo 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 conversioni senza il monitoraggio dell'attività di ciascun utente tra siti.
Prendiamo una persona di nome Bob. Roberto vede un annuncio mentre legge
le notizie su news.example
. Una settimana dopo, Bob compra le scarpe
shoes.example
.
Oggi questa conversione viene monitorata da una terza parte
cookie usato come identificatore tra siti.
Con i cookie di terze parti, un'azienda di ad tech può accedere a molti
di dettagli sull'attività di Roberto in data news.example
e su
shoes.example
. La tecnologia pubblicitaria può unire questi elementi
le informazioni per creare un profilo dettagliato di Roberto
tra cui la posizione di Roberto, le sue abitudini di navigazione
letture preferite su news.example
. Questo profilo può anche
che includono acquisti, attività e dati della carta di credito su
shoes.example
. Questa unione tra siti è utile per misurare
conversioni degli annunci. Tuttavia, 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=19&hl=it)
Viene unita una piccola quantità di informazioni
da più siti, è sufficiente per misurare le conversioni, ma non
sufficiente a monitorare in dettaglio l'attività di Roberto sui siti. Di Roberto
rimane attività su news.example
e shoes.example
separate.
Protezioni in ogni tipo di report
I report a livello di evento collegano un identificatore lato annuncio a una piccola quantità di dal lato delle conversioni. Sebbene forniscono informazioni cross-site su un conversione, le informazioni sul lato conversione sono troppo approssimative per unirsi all'utente e l'identità degli utenti tra i siti.
I report di riepilogo forniscono informazioni dettagliate, ma solo a livello aggregato. perché i contenuti di questi report aggregabili vengono criptati quando vengono inviati al team ad tech, informazioni dai report senza utilizzare un servizio di aggregazione. Solo il servizio di aggregazione consente di accedere ad aggregati rumorosi.
Ulteriori protezioni della privacy, come limitazioni di frequenza, vengono applicate a entrambi a livello di evento e aggregati.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?authuser=19&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 di siti, rispettando i seguenti meccanismi di tutela della privacy:
- Non vengono utilizzati identificatori tra siti e non vengono eseguite attività dettagliate di navigazione tra siti esce dal dispositivo.
- I report a livello di evento associano 64 bit di informazioni sul lato annuncio
(
news.example
) con solo 1 bit o 3 bit sul lato della conversione (shop.example
). a 64 bit sono informazioni sufficienti per essere mappate identificatore di singolo utente, ma questi 64 bit possono essere collegati solo con Poche 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ò già essere
disponibili sul lato degli annunci oggi stesso.
news.example
oadtech.example
conosce già determinate attività di un utente sunews.example
.
- I 64 bit lato annuncio non sono nuove informazioni. Un ID utente può già essere
disponibili sul lato degli annunci oggi stesso.
- Vengono applicate protezioni aggiuntive per prevenire comportamenti 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ò dare più contributi a un riepilogo risultante report. Qualsiasi utente può attivare più attribuzioni per un particolare clic (o visualizzazione) e conversioni.
- I dati vengono aggregati fino al livello di molti eventi (molti utenti) e non i singoli eventi possono essere osservati con precisione. Quando si esamina il dati aggregati, poiché con l'aumento del livello di dettaglio aumenta anche il rumore relativo aumenta anche il numero di dati. Sezioni di dati che aggregano molti eventi e gli utenti siano più precisi per preservare l'utilità.
- I report non elaborati che associano un evento dettagliato di clic o visualizzazione a che i dati sulle conversioni siano criptati e illeggibili dall'azienda di ad tech. Questi dati possono essere letti solo dal servizio di aggregazione.
- Vengono applicate protezioni aggiuntive per prevenire comportamenti 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 La mailing list di Attribution Reporting.
- Se hai domande tecniche, segnalare un bug di Chromium.
- Per domande su implementazione, integrazione e best practice generali: crea un problema nel repository di assistenza per gli sviluppatori di Privacy Sandbox.