Privacy Sandbox include una selezione di proposte per consentire casi d'uso pubblicitari senza la necessità di cross-site, il monitoraggio delle conversioni. Le prove dell'origine offrono l'opportunità agli sviluppatori di valutare e fornire feedback sulle nuove tecnologie web tramite test reali. Nelle prove dell'origine precedenti, i siti potevano testare rispetto alle singole API. Per le API Topics, FLEDGE e Attribution Reporting stiamo fornendo una prova dell'origine singola che consente ai siti di eseguire di esperimenti con le API che costituiscono la versione iniziale dell'annuncio end-to-end durante il ciclo di vita di attività. Le API sono disponibili per i test in Chrome 101 Beta e superiori. La release 101 Beta di Chrome prevede anche aggiornamenti dei controlli utente grazie all'iterazione delle opzioni di configurazione.
In qualità di sviluppatore, potrai registrarti a questa prova origine singola che potrai eseguire test su Topics, FLEDGE e Attribution Reporting su quelle di livello inferiore. Questa guida illustra i passaggi di configurazione per accedere alle API, spiega come convalidare la configurazione e fornisce ulteriori risorse e il test con le API.
Cosa prevede la prova dell'origine?
Lo scopo di questa prova dell'origine è consentire test significativi in tutto l'annuncio il ciclo di vita di più siti. Per coprire questo percorso, la prova dell'origine include:
- Argomenti per osservare e accedere a un
argomenti del browser tramite
document.browsingTopics(). - FLEDGE per gestire
gruppi basati sugli interessi, nonché le offerte di annunci e la selezione in base a questi
gruppi e altri indicatori.
- In questa prova dell'origine, FLEDGE è disponibile su computer e include una un sottoinsieme specifico di tutte le funzionalità proposte. Leggi Dettagli della prova dell'origine di FLEDGE per ulteriori informazioni.
- Frame recintati per visualizzare l'URL opaco del vincitore dell'asta dell'annuncio FLEDGE.
- Attribution Reporting a
Misurare il rendimento e generare i relativi report durante tutto il ciclo di vita dell'annuncio.
- Nell'ambito di Attribution Reporting, i report aggregabili devono elaborati e aggregati da un'aggregazione servizio per produrre report di riepilogo. Pubblicheremo altri strumenti e per i test locali e di origine.
- Se hai partecipato a precedenti prove dell'origine per Attribution Reporting, tieni presente che dovrai aggiornarli in linea con le ultime modifiche all'API. Fai riferimento alla sezione Migrazione guida per maggiori dettagli.
Sebbene questa configurazione consenta i test unificati di tutte queste API, puoi scegliere gli aspetti da implementare, nella misura in cui ciò si adatta al tuo e alle esigenze aziendali.
In che modo gli sviluppatori possono registrarsi per la prova dell'origine?
Registrati al programma Pertinenza e misurazione di Privacy Sandbox Google Cloud. Con i seguenti tag HTML, fornisci un token di prova in ogni pagina in cui desideri eseguire il codice API:
- Tag
<meta>nella sezione<head>della pagina di primo livello:<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE"> - Intestazione HTTP nella risposta della pagina di primo livello:
Origin-Trial: TOKEN_GOES_HERE
Alcune funzionalità disponibili nella prova dell'origine sono destinate all'uso in
contesti tra siti, ad esempio quando fornisci un servizio come
sul sito di primo livello. Se hai bisogno di abilitare la prova dell'origine per questi ulteriori
contesti, assicurati di selezionare l'opzione "Corrispondenza di terze parti".
Per attivare la prova dell'origine da JavaScript di terze parti, inserisci il tag <meta>
alla pagina di primo livello (ovvero la pagina proprietaria, 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);
Scopri di più nella guida introduttiva alle prove dell'origine di Chrome.
In che modo gli sviluppatori eseguono i test localmente?
La documentazione per i singoli sviluppatori per Argomenti, FLEDGE e Attribuzione I report forniscono indicazioni specifiche sui test degli sviluppatori locali per ogni API. Le API non sono attive per impostazione predefinita e deve essere abilitata con per test.
Per abilitare le API per i test, devi:
- Utilizza Chrome 101 Beta o versioni successive.
- FLEDGE richiede Chrome per desktop.
- Le API non sono disponibili sulle versioni iOS di Chrome.
- Abilita le API utilizzando
chrome://flags/#privacy-sandbox-ads-apisflag.- Questo flag forza l'attivazione delle API per semplificare i test, se vuoi
replicare un utente idoneo della prova dell'origine, dove i suoi
impostazioni possono comunque disattivare le API, devi avviare Chrome
utilizzando i flag dell'interfaccia a riga di comando:
--enable-features=BrowsingTopics,InterestGroupStorage,AllowURNsInIframes,PrivacySandboxAdsAPIs. - Le singole API possono avere più flag aggiuntivi per configurazione, consulta le singole guide per i dettagli.
- I flag aggiuntivi potrebbero essere in conflitto con questo, quindi considera solo l'impostazione questo flag in caso di problemi.
- Questo flag forza l'attivazione delle API per semplificare i test, se vuoi
replicare un utente idoneo della prova dell'origine, dove i suoi
impostazioni possono comunque disattivare le API, devi avviare Chrome
utilizzando i flag dell'interfaccia a riga di comando:
- Attiva le prove di Privacy Sandbox nelle Impostazioni di Chrome: Impostazioni >
Sicurezza e privacy > Privacy Sandbox. È inoltre accessibile
alle ore
chrome://settings/adPrivacy. - Attiva i cookie di terze parti nelle Impostazioni di Chrome: Impostazioni >
Sicurezza e privacy. Imposta Cookie e altri dati dei siti su
"Accetta tutti i cookie" o "Blocca cookie di terze parti in modalità di navigazione in incognito". Questo è
accessibile anche da
chrome://settings/cookies. - Essere in una sessione di navigazione standard. Non utilizzare la modalità di navigazione in incognito.
In che modo gli sviluppatori possono controllare se la prova dell'origine è configurata correttamente?
Risoluzione dei problemi relativi alle prove dell'origine di Chrome fornisce un elenco di controllo dettagliato per convalidare la configurazione dell'origine Google Cloud.
DevTools mostra lo stato di una prova dell'origine nella scheda Applicazioni in Cornici.
Mentre la prova dell'origine verrà visualizzata solo come attiva o idonea utenti come descritto di seguito, puoi anche utilizzare lo strumento per sviluppatori di test per il test rispetto al tuo sito di produzione.
Quali utenti sono idonei alla prova dell'origine?
Per impostazione predefinita, le prove dell'origine sono pensate solo su una piccola parte del numero complessivo di prove Traffico di Chrome e Si dovrebbe sempre presupporre che, anche quando hai abilitato l'origine sul tuo sito, l'utente potrebbe non avere l'API attiva. Lo stato attivo del gruppo sperimentale nella prova dell'origine inizia con una bassa percentuale di utenti e probabilmente aumenterà man mano che la prova procede. Ricorda che la percentuale Gli utenti di Chrome inclusi nell'esperimento potrebbero non corrispondere alla percentuale di utenti attivati sul tuo sito.
Tuttavia, per consentire test unificati su tutti i siti, quell'insieme di utenti idonei devono rimanere per lo più coerenti. Ad esempio, se un utente è idoneo per della prova dell'origine quando visualizza un annuncio sul sito di un editore partecipante, la stessa l'utente deve comunque essere idoneo quando effettua una conversione su un inserzionista partecipante sito.
Affinché un utente sia idoneo, deve:
- utilizzare Chrome 101 Beta o
in alto.
- FLEDGE richiede Chrome per desktop.
- non sono disponibili prove dell'origine sulle versioni iOS di Chrome.
- Navigare durante il periodo di prova dell'origine attiva.
- Avere le prove di Privacy Sandbox attivate 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.
- far parte del gruppo sperimentale attivo in Chrome.
In che modo gli sviluppatori dovrebbero utilizzare la funzionalità per rilevare il supporto delle API?
Come per qualsiasi funzionalità della piattaforma web, dovresti rilevare il relativo supporto prima di utilizzarlo.
Argomenti
Verifica la presenza della funzione browsingTopics() in document e
le norme sulle autorizzazioni](https://developer.chrome.com/articles/permissions-policy/#featurepolicyallowsfeaturefeature)
per la sezione "browsing-topics".
if ('browsingTopics' in document && document.featurePolicy.allowsFeature('browsing-topics')) {
// Topics enabled
}
FLEDGE
Se vuoi partecipare a un gruppo di interesse per gli annunci, cerca la funzione joinAdInterestGroup in
navigator e le norme sulle autorizzazioni per "join-ad-interest-group".
if ('joinAdInterestGroup' in navigator && document.featurePolicy.allowsFeature('join-ad-interest-group')) {
// FLEDGE interest group enabled
}
Se vuoi eseguire un'asta, controlla se sono presenti la funzione runAdAuction in navigator e il criterio di autorizzazione per "run-ad-auction".
if ('runAdAuction' in navigator && document.featurePolicy.allowsFeature('run-ad-auction')) {
// FLEDGE auction enabled
}
Report sull'attribuzione
Verifica la presenza dell'oggetto attributionReporting in window e
le Norme sulle autorizzazioni per "attribuzione-reporting".
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// Attribution Reporting API enabled
}
In che modo gli sviluppatori possono fornire feedback e ricevere assistenza?
La pagina di riepilogo dei feedback descrive in dettaglio i vari percorsi per fornire feedback su diversi aspetti di Privacy Sandbox. Esistono sezioni specifiche per Argomenti, FLEDGE e Attribuzione report che forniscono i singoli link per ogni API.
Forniamo inoltre aggiornamenti regolari sui progressi compiuti nell'ambito della Sandbox che fornisce un riepilogo delle notizie importanti.