Topics, Fenced Frames e Shared Storage. keywords: product:PrivacySandbox, docType:Guide, topicAdSetup, contentTypeSolution, category:Web, apiGroupAds, audienceAdBuyer, audienceAdSeller, audienceAdMeasurementProvider, skill:Beginner
Privacy Sandbox include una selezione di proposte per abilitare casi d'uso pubblicitario senza la necessità del monitoraggio tra siti. I provvedimenti Origin offrono agli sviluppatori l'opportunità di valutare e fornire feedback sulle nuove tecnologie web tramite test reali. La prova dell'origine Privacy Sandbox per la pertinenza e la misurazione consente ai siti di eseguire un unico esperimento per condurre esperimenti unificati su Attribution Reporting, API Protected Audience, Topics, frame delimitati e spazio di archiviazione condiviso. Gli sviluppatori possono registrarsi per questa singola prova dell'origine che consente di eseguire test su Topics, sull'API Protected Audience e sulle API Attribution Reporting. Questa guida illustra i passaggi di configurazione per accedere alle API, ti spiega come convalidare la configurazione e fornisce ulteriori risorse per i test in base alle API.
Controllare lo stato della prova dell'origine
Giugno 2023
Aggregazione privata: implementazione graduale del 7% nella versione stabile
L'API Private Aggregation sarà disponibile per il 7% del traffico di Chrome Stable da martedì 6 giugno 2023. L'API sarà disponibile nel gruppo principale della prova dell'origine unificata (5%), nel gruppo isolato Protected Audience (1%) e nel gruppo isolato dello spazio di archiviazione condiviso (1%). L'allocazione del traffico per Protected Audience e Shared Storage non cambierà poiché l'aggregazione privata viene aggiunta agli esperimenti isolati esistenti.
Assegnazione del traffico a partire da martedì 6 giugno:
| API | Assegnazione del traffico | Stato |
| Report sull'attribuzione | Unificato - 5% | 6% del traffico stabile dal 13 marzo 2023 |
| Isolato - 1% - Solo ARA | ||
| Cornici recintate | Unificato - 5% | 7% del traffico stabile al 13 marzo 2023 |
| Isolato - 1% - Spazio di archiviazione condiviso + Aggregazione privata + Solo frame delimitati | ||
| Isolato - 1% - Solo Protected Audience + Aggregazione privata + Frame delimitati | ||
| Protected Audience | Unificato - 5% | 6% del traffico stabile dal 13 marzo 2023 |
| Isolato - 1% - Solo Protected Audience + Aggregazione privata + Frame delimitati | ||
| Private Aggregation | Unificato - 5% | 7% del traffico stabile a partire dal 6 giugno 2023 |
| Isolato - 1% - Solo Protected Audience + Aggregazione privata + Frame delimitati | ||
| Isolato - 1% - Spazio di archiviazione condiviso + Aggregazione privata + Solo frame delimitati | ||
| Spazio di archiviazione condiviso | Unificato - 5% | 6% del traffico stabile dal 13 marzo 2023 |
| Isolato - 1% - Spazio di archiviazione condiviso + Aggregazione privata + Solo frame delimitati | ||
| Argomenti | Unificato - 5% | 6% del traffico stabile dal 13 marzo 2023 |
| Isolati - 1% - Solo argomenti |
Aggiornamenti precedenti
Consulta gli aggiornamenti precedenti sulla prova dell'origine.
Aprile 2023
Aggregazione privata: implementazione graduale del 1% in versione stabile
La prova dell'origine dell'API Private Aggregation sarà disponibile per l'1% del traffico dell'esperimento unificato di Chrome Stable a partire da lunedì 17 aprile. La funzione sendHistogramReport()
di aggregazione privata è disponibile per l'utilizzo nei worklet dell'API Protected Audience
e di Shared Storage.
A partire da lunedì 17 aprile, l'allocazione del traffico sarà la seguente:
| API | Assegnazione del traffico | Stato |
| Report sull'attribuzione | Unificato - 5% | Il 6% del traffico stabile a partire dal 13 marzo 2023 |
| Isolato - 1% - Solo ARA | ||
| Cornici recintate | Unificato - 5% | Il 7% del traffico stabile a partire dal 13 marzo 2023 |
| Isolato - 1% - Spazio di archiviazione condiviso (selezione URL) + solo frame delimitati | ||
| Isolato - 1% - Solo API Protected Audience + frame delimitati | ||
| API Protected Audience | Unificato - 5% | Il 6% del traffico stabile a partire dal 13 marzo 2023 |
| Isolato - 1% - Solo API Protected Audience + frame delimitati | ||
| Private Aggregation | Unificato - 1% | 1% del traffico stabile a partire dal 17 aprile 2023 |
| Spazio di archiviazione condiviso (selezione dell'URL) | Unificato - 5% | Il 6% del traffico stabile a partire dal 13 marzo 2023 |
| Isolato - 1% - Spazio di archiviazione condiviso (selezione URL) + solo frame delimitati | ||
| Argomenti | Unificato - 5% | Il 6% del traffico stabile a partire dal 13 marzo 2023 |
| Isolati - 1% - Solo argomenti |
Marzo 2023
Aggiornamento della sequenza temporale
Inizialmente avevamo comunicato che avremmo iniziato gli esperimenti isolati lunedì 13 marzo 2023, ma i nuovi esperimenti inizieranno ora giovedì 16 marzo 2023 a causa del tempo aggiuntivo necessario per la configurazione degli esperimenti. Anche il ritorno all'1% dell'API Protected Audience dal 4% al 5% avverrà giovedì 16 marzo 2023.
Riavvio graduale dell'API Protected Audience del 1%
Il mese scorso abbiamo ridotto temporaneamente il traffico della prova dell'origine dell'API Protected Audience dal 5% al 4% di Chrome stabile per i test. I test iniziali sono stati completati e prevediamo di aumentare l'API Protected Audience dal 4% al 5% per l'esperimento unificato giovedì 16 marzo 2023.
Gli utenti sottoposti a un aumento saranno gli stessi sottoposti a una riduzione. Tuttavia, i gruppi di interesse precedenti sono scaduti, poiché sono trascorsi più di 30 giorni dal ritiro.
Esperimenti isolati
Per migliorare la nostra procedura di test e continuare a osservare le metriche delle API di prova dell'origine, stiamo creando esperimenti isolati per ogni API, oltre all'esperimento unificato esistente. Verranno creati nuovi esperimenti per Attribution Reporting, Topics, una combinazione di API Protected Audience e frame delimitati e una combinazione dell'operazione di selezione dell'URL di Shared Storage e dei frame delimitati. In ogni esperimento isolato, per gli utenti del gruppo saranno disponibili solo le API assegnate.
| API | Allocazione del traffico dell'esperimento isolato |
|---|---|
| Report sull'attribuzione | 1% |
| API Protected Audience + Fenced Frames | 1% |
| Spazio di archiviazione condiviso (selezione dell'URL) + riquadri delimitati | 1% |
| Argomenti | 1% |
A partire da giovedì 16 marzo, inizierai a ricevere un ulteriore 1% del traffico di Chrome Stable per le API sopra elencate, oltre al 5% di traffico che ricevi dall'esperimento unificato esistente. I nuovi utenti verranno assegnati a ogni esperimento.
Allocazione del traffico
L'attuale allocazione del traffico delle prove con origini unificate a partire da martedì 28 febbraio è la seguente:
| API | Allocazione del traffico dell'esperimento unificato corrente |
|---|---|
| Report sull'attribuzione | 5% |
| Cornici recintate | 5% |
| API Protected Audience | 4% |
| Spazio di archiviazione condiviso (selezione dell'URL) | 5% |
| Argomenti | 5% |
A partire da giovedì 16 marzo, dopo il ripristino dell'API Protected Audience e l'inizio dei nuovi esperimenti isolati, l'allocazione del traffico sarà la seguente:
| API | Nuova allocazione del traffico | Stato |
|---|---|---|
| Report sull'attribuzione | Unificato - 5% | Il 6% del traffico stabile a partire dal 16 marzo 2023 |
| Isolato - 1% - Solo ARA | ||
| Cornici recintate | Unificato - 5% | Il 7% del traffico stabile a partire dal 16 marzo 2023 |
| Isolato - 1% - Spazio di archiviazione condiviso (selezione URL) + solo frame delimitati | ||
| Isolato - 1% - Solo API Protected Audience + frame delimitati | ||
| API Protected Audience | Unificato: 5% (4% di allocazione attuale + 1% di aumento graduale) | Il 6% del traffico stabile a partire dal 16 marzo 2023 |
| Isolato - 1% - Solo API Protected Audience + frame delimitati | ||
| Spazio di archiviazione condiviso (selezione dell'URL) |
Unificato - 5% | Il 6% del traffico stabile a partire dal 16 marzo 2023 |
| Isolato - 1% - Spazio di archiviazione condiviso (selezione URL) + solo frame delimitati | ||
| Argomenti | Unificato - 5% | Il 6% del traffico stabile a partire dal 16 marzo 2023 |
| Isolati - 1% - Solo argomenti |
Queste modifiche non influiranno sulla configurazione esistente del token di prova dell'origine e non dovrai rinnovare o generare un nuovo token di prova dell'origine.
Gennaio 2023
Nell'ambito di un'indagine sulla regressione di Chrome, ridurremo temporaneamente il traffico della prova dell'origine dell'API Protected Audience dal 5% al 4% di Chrome Stable a partire dal 26 gennaio 2023. Stimiamo che l'indagine richiederà circa un mese e ti informeremo quando il traffico sarà ripristinato.
Questa modifica verrà applicata automaticamente e non influirà sui token di prova dell'origine esistenti. Per gli utenti che fanno parte dell'1% di traffico che verrà ridotto, i gruppi di interesse rimarranno nei loro browser. Gli stessi utenti faranno parte della fase di ripristino graduale e i relativi gruppi di interesse potranno essere riutilizzati. Tuttavia, i gruppi di interesse scadono dopo 30 giorni e l'indagine sulla regressione potrebbe richiedere più tempo.
Inoltre, a partire dal 26 gennaio 2023, la prova dell'origine dell'API URL Selection per lo spazio di archiviazione condiviso verrà estesa al 5% del traffico di Chrome Stable.
| API | Note |
|---|---|
| Attribution Reporting | Disponibile nella versione stabile, aumentato al 5% dal 26 ottobre 2022. |
| Argomenti | Disponibile nella versione stabile, aumentato al 5% dal 26 ottobre 2022. |
| API Protected Audience | Disponibile nella versione stabile, in calo temporaneo al 4% dal 26 gennaio 2023. |
| Frame con recinzione | Disponibile nella versione stabile, aumenterà al 5% dal 9 novembre 2022. |
| Shared Storage | Disponibile nella versione stabile, con un aumento del 5% a partire dal 26 gennaio 2023. |
Novembre 2022
A partire dal 9 novembre, l'API "selectURL" di Shared Storage entrerà a far parte della prova dell'origine per l'1% del traffico di Chrome Stable.
Come annunciato in precedenza nel post del blog Aumento della prova dell'origine di Privacy Sandbox per la pertinenza e la misurazione al 5%, Attribution Reporting e Topics ora sono al 5%, mentre l'API Protected Audience e i frame delimitati seguiranno il 9 novembre.
| API | Note |
|---|---|
| Attribution Reporting | Disponibile nella versione stabile, aumentata al 5% dal 26 ottobre. |
| Argomenti | Disponibile nella versione stabile, aumentata al 5% dal 26 ottobre. |
| API Protected Audience | Disponibile nella versione stabile, aumenta al 5% dal 9 novembre. |
| Frame con recinzione | Disponibile nella versione stabile, aumenta al 5% dal 9 novembre. |
| Shared Storage | Sarà disponibile nella versione stabile a partire dal 9 novembre con una percentuale dell'1%. |
Ottobre 2022: aumento del 5%
I report sull'attribuzione, Topics, l'API Protected Audience e i frame delimitati sono attualmente disponibili in Chrome Stable e faranno parte dell'aumento del traffico.
Inizieremo ad aumentare il traffico per Attribution Reporting e Topics a partire da questa settimana, mentre l'API Protected Audience e i frame delimitati aumenteranno dal 9 novembre.
Scopri di più nel post del blog Aumento della prova dell'origine di misurazione e pertinenza di Privacy Sandbox al 5%.
| API | Note |
|---|---|
| Attribution Reporting | Disponibile nella versione stabile, aumenta al 5% dopo il 26 ottobre. |
| Argomenti | Disponibile nella versione stabile, aumenta al 5% dopo il 26 ottobre. |
| API Protected Audience | Disponibile nella versione stabile, aumenta al 5% dal 9 novembre. |
| Frame con recinzione | Disponibile nella versione stabile, aumenta al 5% dal 9 novembre. |
| Shared Storage | Al momento disponibile solo in M105+ Canary, Dev e Beta. |
Ottobre 2022
- La prova dell'origine è stata estesa a Chrome 110.
- L'articolo Iniziare a utilizzare le prove delle origini di Chrome spiega come rinnovare la registrazione alla prova dell'origine. Ciò include la fornitura di un nuovo token alle origini partecipanti, che è la stessa procedura seguita da qualsiasi altra estensione di prova dell'origine.
Questa estensione è stata concessa per dare all'ecosistema nel canale stabile il tempo di continuare a testare e convalidare i miglioramenti dell'API, fornendo al contempo feedback in linea con le nostre tempistiche pubbliche esistenti.
La cronologia complessiva di Privacy Sandbox rimane invariata.
API incluse nella prova:
| API | Note |
|---|---|
| Attribution Reporting | Guida per gli sviluppatori per la prova dell'origine. |
| API Protected Audience | Guida per gli sviluppatori per la prova dell'origine. |
| Argomenti | Guida per gli sviluppatori per la prova dell'origine. |
| Cornici con recinzione | Consulta le indicazioni sull'API Protected Audience per l'utilizzo della prova dell'origine. |
| Shared Storage | Al momento disponibile solo in M105+ Canary, Dev e Beta. |
Agosto 2022
- La disponibilità della prova di Origin viene estesa al 1% degli utenti desktop a partire da Chrome 104 stabile.
- Seguiranno aggiornamenti quando la disponibilità includerà gli utenti di dispositivi mobili.
- I canali pre-stabili (Canary, Beta) rimangono al 50% degli utenti.
- Le API non sono disponibili su Chrome per iOS.
Maggio 2022
La disponibilità della prova dell'origine viene estesa al 50% degli utenti di Chrome 102 beta.
API incluse nella prova:
| API | Note |
|---|---|
| Attribution Reporting | Guida per gli sviluppatori per la prova dell'origine. |
| API Protected Audience | Guida per gli sviluppatori per la prova dell'origine. |
| Argomenti | Guida per gli sviluppatori per la sperimentazione dell'origine. Topics è stato disattivato brevemente nella prova dell'origine a causa di un bug che ha influito sulla stabilità del browser. |
| Cornici con recinzione | I frame delimitati sono stati aggiunti alla prova dell'origine. Consulta le indicazioni sull'API Protected Audience per l'utilizzo degli esperimenti. |
Aprile 2022
La prova di Origin inizia con una proporzione limitata di utenti di Chrome 102 beta.
API incluse nella prova:
| API | Note |
|---|---|
| Attribution Reporting | Post su Intento per esperimento (I2E) individuale. I report sull'attribuzione sono disponibili anche come prova di un'origine singola. |
| API Protected Audience | Post su Intento per esperimento (I2E) individuale. L'API Protected Audience è disponibile solo su computer con un sottoinsieme di funzionalità. |
| Argomenti | Post su Intento per esperimento (I2E) individuale. |
Registrati e configura la prova dell'origine
Per attivare la prova dell'origine sul tuo sito, devi registrare e incorporare il token della prova dell'origine assegnato (una stringa basata sul tempo per il tuo accesso specifico alla prova dell'origine). Scopri di più nella pagina Iniziare a utilizzare i trial di origine di Chrome.
I token di prova Origin vengono concessi immediatamente e puoi revocarli o ricrearli in qualsiasi momento.
Per ogni pagina in cui vuoi utilizzare la prova dell'origine, dovrai includere un token di prova con il codice HTML o la risposta della pagina specifica.
Utilizza un tag <meta> nella sezione <head> della pagina:
<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
In alternativa, includi la seguente intestazione HTTP nella risposta della pagina:
Origin-Trial: TOKEN_GOES_HERE
Configurazione con un iframe
Se utilizzi le funzionalità della prova dell'origine all'interno di un iframe (ad esempio l'API Protected AudiencejoinAdInterestGroup()), il token deve essere fornito all'interno dell'iframe e corrispondere all'origine dell'iframe.
Configurare la misurazione cross-site con JavaScript
Se utilizzi le funzionalità di prova dell'origine tramite JavaScript cross-site, ad esempio se sei il fornitore di JavaScript di terze parti incluso nella pagina di primo livello, devi:
- Seleziona l'opzione Corrispondenza di terze parti quando ti registri per la prova dell'origine.
- Il campo Origine web deve essere l'origine dello script.
- Inserisci il tag
<meta>nella pagina di primo livello (ovvero la pagina proprietaria, non i tuoi contenuti) dal tuo script. Ad esempio:
const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);
Eseguire il debug della prova dell'origine
Puoi controllare lo stato di una prova dell'origine nel riquadro DevTools > Applications.
- Scorri verso il basso fino al riquadro Frame.
- Seleziona il frame in cui vuoi impostare il token. Ad esempio, l'iframe superiore per la pagina di primo livello o l'iframe specifico per le pagine incorporate.
- Nel riquadro a destra, scorri verso il basso fino alla sezione Sperimentazioni dell'origine.
- Dovresti vedere una voce per la prova di
PrivacySandboxAdsAPIs. - Espandi questa voce per visualizzare lo stato della prova dell'origine e i tuoi token specifici.
La prova dell'origine è limitata a una parte degli utenti di Chrome e il tuo browser potrebbe non essere nel gruppo sperimentale. Di conseguenza, potresti visualizzare un messaggio TrialNotAllowed
rosso accanto a PrivacySandboxAdsAPIs. Quando espandi la voce per controllare lo stato del token, se viene visualizzato un messaggio Success verde, la configurazione della prova dell'origine è corretta. Gli utenti idonei vedranno il messaggio impostato su Enabled.
Se visualizzi messaggi diversi, consulta la sezione Risolvere i problemi relativi alle prove dell'origine di Chrome per una lista di controllo dettagliata per convalidare la configurazione della prova dell'origine.
Rilevare elementi
Come per tutte le funzionalità web, devi verificare che siano segnalate come disponibili nel browser prima di tentare di utilizzarle. A questo scopo, controlla l'esistenza dell'API pertinente nella posizione corretta:
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// Attribution Reporting enabled
}
if ('runAdAuction' in navigator) {
// Protected Audience API enabled
}
if ('browsingTopics' in document) {
// Topics enabled
}
if ('HTMLFencedFrameElement' in window) {
// Fenced Frames enabled
}
if ('sharedStorage' in window) {
// Shared Storage enabled
}
if (window?.sharedStorage?.selectURL instanceof Function) {
// optionally check specifically for the selectURL function in Shared Storage
}
Determinare l'idoneità degli utenti
La prova dell'origine è in esecuzione per una frazione di utenti di Chrome. Inoltre, per poter usufruire della prova, devono avere attivato nelle impostazioni la funzionalità pertinente:
Impostazioni del browser
Affinché un utente sia idoneo alla prova, deve:
Utilizzare una versione e un canale di Chrome in cui è attiva la prova dell'origine.
- Consulta Stato della prova dell'origine per le configurazioni attuali.
Appartenere al gruppo sperimentale attivo in Chrome.
Impostazioni utente
Affinché un utente sia idoneo alla prova, deve inoltre:
- Avere attivato la prova di Privacy Sandbox tramite Impostazioni > Sicurezza e privacy > Privacy Sandbox, accessibile anche tramite
chrome://settings/adPrivacy. - Avere attivato i cookie di terze parti tramite Impostazioni > Sicurezza e privacy >
Cookie e altri dati dei siti impostato su "Consenti tutti i cookie" o "Blocca
cookie di terze parti nella modalità di navigazione in incognito", accessibile anche tramite
chrome://settings/cookies. - essere in una sessione di navigazione standard e non in modalità di navigazione in incognito.
Anche se la prova dell'origine viene visualizzata come attiva solo per gli utenti idonei, puoi anche utilizzare i flag per gli sviluppatori per eseguire test sul tuo sito di produzione.
Controllare la partecipazione alla prova dell'origine
La procedura della prova dell'origine rimane invariata: ottieni token per la prova dell'origine per i contesti in cui vuoi eseguire esperimenti con le API. Con la popolazione di test ampliata, devi assicurarti di monitorare e controllare attivamente il livello di traffico in cui scegli di attivare la prova.
Un buon approccio è:
- Includi i token di prova dell'origine per impostazione predefinita in tutti i contesti in cui vuoi eseguire esperimenti.
- Utilizza il rilevamento delle funzionalità per verificare la presenza di API attive.
- Se le API sono attive (e quindi il browser è idoneo per questo esperimento), scegli se utilizzarle o meno in base ai tuoi criteri dell'esperimento. Ad esempio, se hai già un'infrastruttura di test A/B per eseguire esperimenti su una percentuale di traffico, sul campionamento o su qualche altro attributo, a questo punto puoi decidere quali funzionalità utilizzare attivamente.
Puoi impedire completamente la partecipazione alla prova dell'origine per qualsiasi istanza del browser non includendo il token nella risposta. Ad esempio, se hai raggiunto la tua quota per un esperimento o devi risolvere un problema durante la prova, l'esclusione del token garantisce che nessuna funzionalità sperimentale sia disponibile o attiva nella pagina.
Controllo della prova dell'origine per regione geografica
Non puoi disattivare una prova dell'origine per regioni specifiche. Le prove dell'origine sono attivate sulle pagine che contengono il token, incluso tramite intestazioni HTTP (lato server) o meta tag HTML (lato client).
Se puoi determinare la posizione dell'utente, potresti scrivere codice per includere il token di prova di origine in base a queste informazioni sulla posizione. Ad esempio, potresti tentare di utilizzare gli indirizzi IP per determinare la posizione di un utente. Gli indirizzi IP possono essere contraffatti, quindi questa non è una soluzione garantita.
Tuttavia, un'origine geografica specifica può impostare un Criterio di autorizzazioni per controllare quali funzionalità sono utilizzabili. Ad esempio, us.example.com e uk.example.com sono
origini specifiche per area geografica che possono essere controllate. Ciò non significa che una regione abbia disattivato la prova dell'origine.
Con un criterio di autorizzazione, un sito aggiunge alle sue pagine un piccolo snippet di codice che fornisce istruzioni al browser. Quando la pagina viene caricata, il browser legge le istruzioni delle Norme relative alle autorizzazioni e consente o blocca le funzionalità (o le API) come indicato nelle Norme relative alle autorizzazioni. Se un sito vuole limitare un'API in una regione specifica, lo sviluppatore può impostare un criterio per tutte le pagine richieste da quella regione.
Rinnovare il token
I token di prova di Origin scadono sei settimane dopo la data di emissione (o alla fine della prova, se prima).
È fondamentale rinnovare ed eseguire il deployment dei nuovi token entro questo periodo per un utilizzo ininterrotto delle funzionalità della prova dell'origine.
Il rinnovo dei token richiede solo pochi minuti e puoi implementare più token per la stessa prova all'interno della stessa pagina. Puoi implementare un token rinnovato prima della scadenza del token esistente, in modo che il servizio non venga interrotto per gli utenti.
Eseguire il test localmente
Per indicazioni specifiche sui test degli sviluppatori locali, consulta:
Le API non sono attive per impostazione predefinita e devono essere abilitate con i flag per i test. Assicurati di aver attivato le stesse impostazioni di configurazione indicate sopra, quindi:
- Utilizza una versione e un canale di Chrome in cui le funzionalità sono disponibili.
- Abilita tutte le API di privacy per gli annunci in
chrome://settings/adPrivacy.
Consulta le guide per sviluppatori per verificare la disponibilità di API e funzionalità specifiche e di flag aggiuntivi per una configurazione più granulare.