argomenti, cornici recintate e spazio di archiviazione condiviso. keywords: product:PrivacySandbox, docType:Guida, topicAdSetup, contentTypeSolution, categoria:Web, apiGroupAds, audienceAdBuyer, audienceAdSeller, audienceAdMeasurementProvider, skill:Principiante
Privacy Sandbox include una selezione di proposte per consentire l'uso della pubblicità senza la necessità di monitorare tra siti. Origine offrono agli sviluppatori l'opportunità di valutare e fornire feedback sulle nuove tecnologie web attraverso test reali. La Pertinenza e Privacy Sandbox Prova dell'origine della misurazione offre un'unica prova che consente ai siti di eseguire esperimenti unificati Attribution Reporting, API Protected Audience, Topics, cornici recintate e condivisi spazio di archiviazione. Gli sviluppatori possono registrarsi per questa prova con un'unica origine che ti consente di tra le API Topics, Protected Audience e Attribution Reporting. Questo ti guiderà attraverso i passaggi di configurazione per accedere alle API, ti indicherà come convalidare la configurazione e fornisce ulteriori risorse per i test rispetto alle API.
Controllare lo stato della prova dell'origine
Giugno 2023
Aumento del 7% dell'aggregazione privata nel canale stabile
L'API Private Aggregation sarà disponibile per il 7% del traffico stabile di Chrome da martedì 6 giugno 2023. L'API sarà disponibile nel principale gruppo di prova dell'origine unificato (5%), Protected Gruppo isolato pubblico (1%) e gruppo isolato Spazio di archiviazione condiviso (1%). La l'allocazione del traffico per Protected Audience e Archiviazione condivisa non cambierà poiché l'aggregazione privata viene aggiunta agli esperimenti isolati esistenti.
Assegnazione del traffico a martedì 6 giugno:
| API | Assegnazione del traffico | Stato |
| Report sull'attribuzione | Unificato - 5% | 6% di traffico stabile al 13 marzo 2023 |
| Isolato - 1% - solo ARA | ||
| Strutture per recinzioni | Unificato - 5% | 7% di traffico stabile al 13 marzo 2023 |
| Isolati - 1% - Spazio di archiviazione condiviso + aggregazione privata + Solo frame recintati | ||
| Isolati - 1% - Protected Audience + Aggregazione privata + Solo frame recintati | ||
| Protected Audience | Unificato - 5% | 6% di traffico stabile al 13 marzo 2023 |
| Isolati - 1% - Protected Audience + Aggregazione privata + Solo frame recintati | ||
| Aggregazione privata | Unificato - 5% | 7% di traffico stabile al 6 giugno 2023 |
| Isolati - 1% - Protected Audience + Aggregazione privata + Solo frame recintati | ||
| Isolati - 1% - Spazio di archiviazione condiviso + aggregazione privata + Solo frame recintati | ||
| Spazio di archiviazione condiviso | Unificato - 5% | 6% di traffico stabile al 13 marzo 2023 |
| Isolati - 1% - Spazio di archiviazione condiviso + aggregazione privata + Solo frame recintati | ||
| Argomenti | Unificato - 5% | 6% di traffico stabile al 13 marzo 2023 |
| Isolati - 1% - Solo argomenti |
Aggiornamenti precedenti
Dai un'occhiata agli aggiornamenti precedenti sulla prova dell'origine.
Aprile 2023
Aumento dell'1% dell'aggregazione privata nel canale stabile
Il privato
La prova dell'origine dell'API Aggregation sarà disponibile per l'1% della versione stabile di Chrome
traffico unificato dell'esperimento di lunedì 17 aprile. sendHistogramReport()
di aggregazione privata può essere utilizzata nell'API Protected Audience
e Spazio di archiviazione condiviso
di lavoro.
A partire da lunedì 17 aprile, l'assegnazione del traffico sarà simile alla seguente:
| API | Assegnazione del traffico | Stato |
| Report sull'attribuzione | Unificato - 5% | 6% del traffico stabile a partire dal 13 marzo 2023 |
| Isolato - 1% - solo ARA | ||
| Strutture per recinzioni | Unificato - 5% | 7% del traffico stabile a partire dal 13 marzo 2023 |
| Isolato - 1% - Spazio di archiviazione condiviso (selezione URL) + solo frame recintati | ||
| Isolato - 1% - API Protected Audience + solo frame fenced | ||
| API Protected Audience | Unificato - 5% | 6% del traffico stabile a partire dal 13 marzo 2023 |
| Isolato - 1% - API Protected Audience + solo frame fenced | ||
| Aggregazione privata | Unificato - 1% | 1% del traffico stabile a partire dal 17 aprile 2023 |
| Archiviazione condivisa (selezione URL) | Unificato - 5% | 6% del traffico stabile a partire dal 13 marzo 2023 |
| Isolato - 1% - Spazio di archiviazione condiviso (selezione URL) + solo frame recintati | ||
| Argomenti | Unificato - 5% | 6% del traffico stabile a partire dal 13 marzo 2023 |
| Isolati - 1% - Solo argomenti |
Marzo 2023
Aggiornamento degli Spostamenti
Inizialmente abbiamo comunicato che lunedì inizieremo gli esperimenti isolati, 13 marzo 2023, ma i nuovi esperimenti inizieranno giovedì 16 marzo 2023 grazie al tempo aggiuntivo necessario per configurare gli esperimenti. L'1% L'aumento dal 4% al 5% dell'API Protected Audience avverrà anche giovedì, 16 marzo 2023.
Aumento dell'1% dell'API Protected Audience
Il mese scorso, abbiamo ridotto temporaneamente il traffico relativo alla prova dell'origine dell'API Protected Audience dal 5% al 4% di Chrome stabile per i test. I test iniziali si sono conclusi e prevediamo di riportare l'API Protected Audience dal 4% al 5% per l'esperimento unificato di giovedì 16 marzo 2023.
Gli utenti in fase di implementazione graduale saranno dello stesso insieme di utenti che sono stati rimossi. Tuttavia, i precedenti gruppi di interesse sono scaduti, poiché sono trascorsi più di 30 giorni dalla data di applicazione dell'applicazione graduale.
Esperimenti isolati
Per migliorare il nostro processo di test e continuare a osservare le metriche delle API di prova dell'origine, stiamo creando esperimenti isolati per ogni API, in aggiunta all'esperimento unificato esistente. Verranno creati nuovi esperimenti per Attribution Reporting, Topics, una combinazione di API Protected Audience e frame protetti e di una combinazione dell'operazione di selezione dell'URL dello spazio di archiviazione condiviso e dei frame protetti. In ogni esperimento isolato, saranno disponibili solo le API assegnate per gli utenti di quel gruppo.
| API | Allocazione del traffico dell'esperimento isolato |
|---|---|
| Report sull'attribuzione | 1% |
| API Protected Audience + frame recintati | 1% |
| Spazio di archiviazione condiviso (selezione URL) + frame recintati | 1% |
| Argomenti | 1% |
A partire da giovedì 16 marzo, inizierai a ricevere un ulteriore 1% dei Traffico stabile di Chrome per le API elencate sopra, in aggiunta al 5% del traffico che che ricevono dall'esperimento unificato esistente. Verranno assegnati nuovi utenti a ciascun esperimento.
Allocazione del traffico
L'attuale allocazione del traffico delle prove dell'origine unificata a partire da martedì 28 febbraio è la seguente:
| API | Allocazione del traffico dell'esperimento unificata attuale |
|---|---|
| Report sull'attribuzione | 5% |
| Strutture per recinzioni | 5% |
| API Protected Audience | 4% |
| Spazio di archiviazione condiviso (selezione dell'URL) | 5% |
| Argomenti | 5% |
L'assegnazione del traffico sarà simile alla seguente a partire da giovedì 16 marzo, dopo il ripristino dell'API Protected Audience e l'inizio dei nuovi esperimenti isolati:
| API | Nuova allocazione del traffico | Stato |
|---|---|---|
| Report sull'attribuzione | Unificato - 5% | 6% del traffico stabile a partire dal 16 marzo 2023 |
| Isolato - 1% - solo ARA | ||
| Strutture per recinzioni | Unificato - 5% | 7% del traffico stabile a partire dal 16 marzo 2023 |
| Isolato - 1% - Spazio di archiviazione condiviso (selezione URL) + solo frame recintati | ||
| Isolato - 1% - API Protected Audience + solo frame fenced | ||
| API Protected Audience | Unificato: 5% (4% di allocazione attuale + 1% di rampa di back up) | 6% del traffico stabile a partire dal 16 marzo 2023 |
| Isolato - 1% - API Protected Audience + solo frame fenced | ||
| Spazio di archiviazione condiviso (selezione dell'URL) |
Unificato - 5% | 6% del traffico stabile a partire dal 16 marzo 2023 |
| Isolato - 1% - Spazio di archiviazione condiviso (selezione URL) + solo frame recintati | ||
| Argomenti | Unificato - 5% | 6% del traffico stabile a partire dal 16 marzo 2023 |
| Isolati - 1% - Solo argomenti |
Queste modifiche non influiranno sulla configurazione del token di prova dell'origine esistente e non dovrai rinnovare il token di prova dell'origine o generarne uno nuovo.
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% della versione stabile di Chrome a partire dal 26 gennaio 2023. Stimiamo che l'indagine richiederà circa un mese e ti invieremo una notifica quando il traffico sarà nuovamente aumentato.
Questa modifica avverrà automaticamente e non influirà sui token di prova dell'origine esistenti. Per gli utenti nell'1% di traffico che diminuirà, i gruppi di interesse rimarranno nei loro browser. Gli stessi utenti faranno parte dell'applicazione graduale della funzionalità e i loro gruppi basati sugli interessi 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 di Shared Storage aumenterà al 5% del traffico stabile di Chrome.
| API | Note |
|---|---|
| Report sull'attribuzione | Disponibile in versione stabile, aumentato al 5% dal 26 ottobre 2022. |
| Argomenti | Disponibile in versione stabile, aumentato al 5% dal 26 ottobre 2022. |
| API Protected Audience | Disponibile in versione stabile, in calo temporaneamente al 4% dal 26 gennaio 2023. |
| Cornici recintati | Disponibile nel canale stabile, in aumento fino al 5% dal 9 novembre 2022. |
| Spazio di archiviazione condiviso | Disponibile nella versione stabile, con un aumento del 5% dal 26 gennaio 2023. |
Novembre 2022
L'API "selectURL" di Shared Storage entrerà a far parte della prova dell'origine per l'1% del traffico stabile di Chrome a partire dal 9 novembre.
Come annunciato in precedenza nel post del blog sull'aumento del 5%della prova dell'origine di pertinenza e misurazione di Privacy Sandbox, Attribution Reporting e Topics ora sono al 5% con l'API Protected Audience e Fenced Frames a partire dal 9 novembre.
| API | Note |
|---|---|
| Report sull'attribuzione | Disponibile nel canale stabile, aumentato al 5% dal 26 ottobre. |
| Argomenti | Disponibile nel canale stabile, aumentato al 5% dal 26 ottobre. |
| API Protected Audience | Disponibile nel canale stabile, in aumento fino al 5% dal 9 novembre. |
| Cornici recintati | Disponibile nel canale stabile, in aumento fino al 5% dal 9 novembre. |
| Spazio di archiviazione condiviso | Sarà disponibile nella versione stabile a partire dall'1% a partire dal 9 novembre. |
Ottobre 2022: aumento del 5%
Attribution Reporting, Topics, API Protected Audience e cornici recintate sono attualmente disponibili nella versione stabile di Chrome e faranno parte dell'aumento del traffico.
A partire da questa settimana, inizieremo ad aumentare il traffico per Attribution Reporting e Topics, mentre l'API Protected Audience e i frame schermati aumenteranno a partire dal 9 novembre.
Scopri di più nel post del blog sull'aumento del 5%della prova dell'origine di pertinenza e misurazione di Privacy Sandbox.
| API | Note |
|---|---|
| Report sull'attribuzione | Disponibile nel canale stabile, con aumento fino al 5% dopo il 26 ottobre. |
| Argomenti | Disponibile nel canale stabile, con aumento fino al 5% dopo il 26 ottobre. |
| API Protected Audience | Disponibile nel canale stabile, in aumento fino al 5% dal 9 novembre. |
| Cornici recintati | Disponibile nel canale stabile, in aumento fino al 5% dal 9 novembre. |
| Spazio di archiviazione condiviso | Per il momento è disponibile soltanto nelle versioni M105+ Canary, Dev e beta. |
Ottobre 2022
- La prova dell'origine è stata estesa a Chrome 110.
- Guida introduttiva alle prove dell'origine 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 della prova dell'origine.
Questa estensione è stata concessa per concedere all'ecosistema del tempo sul canale stabile continuare a testare e convalidare i miglioramenti dell'API, fornendo al contempo feedback in linea con le attuali tempistiche pubbliche.
Le tempistiche generali di Privacy Sandbox rimangono invariate.
API incluse nella prova:
| API | Note |
|---|---|
| Attribuzione Report | Sviluppatore guida alla prova dell'origine. |
| API Protected Audience | Sviluppatore guida alla prova dell'origine. |
| Argomenti | Sviluppatore guida alla prova dell'origine. |
| Recintato Cornici | Consulta le indicazioni dell'API Protected Audience per l'utilizzo della prova dell'origine. |
| Condiviso Spazio di archiviazione | Per il momento è disponibile soltanto nelle versioni M105+ Canary, Dev e beta. |
Agosto 2022
- La disponibilità della prova dell'origine aumenta fino all'1% degli utenti di computer dalla versione stabile 104 di Chrome.
- Gli aggiornamenti seguiranno quando la disponibilità includerà gli utenti di dispositivi mobili.
- I canali prestabili (Canary, Beta) rimangono al 50% degli utenti.
- Le API non sono disponibili su Chrome per iOS.
Maggio 2022
La disponibilità della prova dell'origine aumenta fino al 50% degli utenti di Chrome 102 beta.
API incluse nella prova:
| API | Note |
|---|---|
| Attribuzione Report | Sviluppatore guida alla prova dell'origine. |
| API Protected Audience | Sviluppatore guida alla prova dell'origine. |
| Argomenti | Guida per gli sviluppatori per dell'origine dati. Topics è stato disattivato per un breve periodo nella prova dell'origine a causa di un bug che la stabilità del browser interessata. |
| Recintato Cornici | Strutture recintate aggiunte alla prova dell'origine. Consulta le indicazioni dell'API Protected Audience per l'utilizzo dell'esperimento. |
Aprile 2022
La prova dell'origine inizia con una proporzione limitata di utenti di Chrome 102 beta.
API incluse nella prova:
| API | Note |
|---|---|
| Attribuzione Report | Intenzione singola all'esperimento (I2E). Attribution Reporting disponibile anche come una prova dell'origine individuale. |
| API Protected Audience | Intenzione singola all'esperimento (I2E). L'API Protected Audience è disponibile solo su computer con un sottoinsieme di funzionalità. |
| Argomenti | Intenzione singola all'esperimento (I2E). |
Registrati per configurare e configurare la prova dell'origine
Per attivare la prova dell'origine sul tuo sito, devi registrarti e incorporare il token di prova dell'origine assegnato (una stringa basata sul tempo per l'accesso specifico prova dell'origine). Scopri di più nella Guida introduttiva all'origine di Chrome Google Cloud.
I token di prova dell'origine vengono concessi immediatamente e puoi revocarli o ricrearli in qualsiasi momento.
Per ogni pagina in cui vuoi utilizzare la prova dell'origine, devi includere un token di prova con il codice HTML o la risposta di quella specifica pagina.
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
joinAdInterestGroup()), il token deve essere fornito all'interno dell'iframe
e corrispondono all'origine dell'iframe.
Configura cross-site con JavaScript
Se utilizzi le funzionalità della prova dell'origine tramite JavaScript tra siti, il provider di JavaScript di terze parti incluso nella pagina di primo livello, dovrai:
- Seleziona l'opzione Corrispondenza di terze parti durante la registrazione per l'origine Google Cloud.
- Il campo Origine web deve corrispondere all'origine dello script.
- Inserisci il tag
<meta>nella pagina di primo livello (ovvero, il tag proprietario pagina di destinazione, non i tuoi contenuti) dallo 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);
esegui il debug della prova dell'origine
Puoi controllare lo stato di una prova dell'origine in DevTools > Applicazioni dal riquadro.
- Scorri verso il basso fino al riquadro Frame.
- Seleziona il frame in cui prevedi di impostare il token. Ad esempio, la parte superiore frame 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 Prove dell'origine.
- Dovresti visualizzare una voce relativa alla prova di
PrivacySandboxAdsAPIs. - Espandi questa voce per vedere lo stato della prova dell'origine e la tua richiesta di token.
La prova dell'origine è limitata a una frazione di utenti di Chrome e il browser potrebbe
non fanno parte del gruppo dell'esperimento. Di conseguenza, potresti vedere un'icona TrialNotAllowed rossa
messaggio relativo a PrivacySandboxAdsAPIs. Quando espandi la voce per controllare
Stato del token, se mostra un messaggio Success verde, la tua prova dell'origine
sia corretta. Gli utenti idonei vedranno il messaggio impostato su Enabled.
Se vengono visualizzati messaggi diversi, consulta la sezione Risoluzione dei problemi relativi all'origine di Chrome Google Cloud per un elenco di controllo dettagliato per convalidare la configurazione della prova dell'origine.
Rileva le funzionalità
Come per tutte le funzionalità web, devi verificare che i report siano disponibili in il browser prima di tentare di utilizzarli. A questo scopo, puoi controllare 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 parte degli utenti di Chrome. Devono inoltre avere la funzionalità pertinente nelle loro impostazioni per poter essere prova:
Impostazioni del browser
Affinché l'utente sia idoneo alla prova, deve:
Avere una versione e un canale di Chrome in cui è disponibile la prova dell'origine. in esecuzione.
- Per le configurazioni correnti, consulta Stato prova origine.
Fai parte del gruppo sperimentale attivo in Chrome.
Impostazioni utente
Affinché l'utente sia idoneo alla prova, deve anche:
- Avere la prova di Privacy Sandbox attivata tramite Impostazioni > Sicurezza e
privacy > Privacy Sandbox, accessibile anche tramite
chrome://settings/adPrivacy. - Avere attivato i cookie di terze parti in Impostazioni > Sicurezza e privacy >
Cookie e altri dati dei siti impostati su "Accetta tutti i cookie" o "Blocca
cookie di terze parti 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 verrà visualizzata come attiva solo agli utenti idonei, puoi anche Utilizzare i flag degli sviluppatori per eseguire test sulla tua produzione sito.
Controlla la tua partecipazione alla prova dell'origine
I meccanismi della prova dell'origine rimangono invariati: ottieni la prova dell'origine per i contesti in cui vuoi sperimentare le API. Con una popolazione di test estesa, assicurati di monitorare attivamente e il controllo del livello di traffico al quale si sceglie di abilitare la prova.
Un buon approccio è:
- Includi i token di prova dell'origine per impostazione predefinita in tutti i contesti in cui vuoi dell'esperimento.
- Usa il rilevamento delle funzionalità per verificare la presenza di API attive.
- Se le API sono attive e, di conseguenza, il browser è idoneo per questo esperimento), scegli se utilizzarli o meno in base al tuo esperimento criteri. Ad esempio, se disponi già dell'infrastruttura di test A/B per fare un esperimento su una percentuale di traffico, sul campionamento o su un altro attributo, A questo punto puoi decidere quali funzioni usare attivamente.
Puoi impedire completamente la partecipazione alla prova dell'origine per qualsiasi browser ad esempio escludendo il token nella risposta. Ad esempio, se disponi raggiunto la tua quota per un esperimento o hai bisogno di risolvere un problema durante di prova, l'esclusione del token garantisce che la funzionalità sperimentale disponibile o attivo nella pagina.
Controllo della prova dell'origine per regione geografica
Non puoi disattivare una prova dell'origine per regioni specifiche. Le prove dell'origine attivi su pagine che contengono i token, incluso tramite intestazioni HTTP (lato server) o meta tag HTML (lato client).
Se riesci a determinare la posizione dell'utente, potresti scrivere il codice da includere il token della prova dell'origine in base alle informazioni sulla posizione. Ad esempio, potrebbe tentare di utilizzare gli indirizzi IP per determinare la località di un utente. Indirizzi IP può essere oggetto di spoofing, pertanto non è una soluzione garantita.
Tuttavia, un'origine geografica specifica può impostare un'opzione Permissions
Policy per stabilire quali funzionalità sono
utilizzabili. Ad esempio, us.example.com e uk.example.com sono
origini geografiche specifiche che possono essere controllate. Ciò non significa che un
regione ha disattivato la prova dell'origine.
Con un criterio sulle autorizzazioni, un sito aggiunge un piccolo snippet di codice alle proprie pagine. che fornisce istruzioni al browser. Quando la pagina si carica, il browser legge le istruzioni delle Norme relative alle autorizzazioni e consentirà o bloccherà funzioni (oppure API) come descritto nelle norme relative alle autorizzazioni. Se un sito vuole limitare un'API in una regione specifica, lo sviluppatore potrebbe impostare un criterio per tutte le pagine richieste dalla regione in questione.
Rinnova il token
I token di prova dell'origine scadono sei settimane dopo la data di emissione (o alla fine del se questo è il periodo di tempo più breve).
È fondamentale rinnovare ed eseguire il deployment del nuovo all'interno della finestra un uso ininterrotto delle funzionalità della prova dell'origine.
Il rinnovo dei token richiede solo pochi minuti e puoi eseguire il deployment di più token per la stessa prova nella stessa pagina. Puoi eseguire il deployment di un token rinnovato prima il token esistente scade, quindi non c'è alcuna interruzione del servizio per gli utenti.
Esegui test in locale
Per indicazioni specifiche sui test per sviluppatori locali, consulta:
Le API non sono attive per impostazione predefinita e devono essere abilitate con per test. Devi assicurarti di avere attivato le stesse impostazioni di configurazione sopra e poi:
- Utilizza una versione e un canale di Chrome in cui le funzionalità sono disponibili.
- Attiva tutte le API di privacy per gli annunci in
chrome://settings/adPrivacy.
Consulta le guide per gli sviluppatori per verificare la disponibilità di API e funzionalità specifiche. per una configurazione più granulare.