Prova dell'origine unificata di misurazione e pertinenza

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

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.

Stato Token riuscito e abilitato.
Stato del token riuscito e abilitato.
  1. Scorri verso il basso fino al riquadro Frame.
  2. 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.
  3. Nel riquadro a destra, scorri verso il basso fino alla sezione Prove dell'origine.
  4. Dovresti visualizzare una voce relativa alla prova di PrivacySandboxAdsAPIs.
  5. 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.

Stato Token riuscito e non abilitato.
Stato Token riuscito e non abilitato.

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.

  • 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 è:

  1. Includi i token di prova dell'origine per impostazione predefinita in tutti i contesti in cui vuoi dell'esperimento.
  2. Usa il rilevamento delle funzionalità per verificare la presenza di API attive.
  3. 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.