Privacy Sandbox include una selezione di proposte per consentire casi d'uso pubblicitari senza il bisogno del monitoraggio tra siti. Le prove dell'origine offrono agli sviluppatori l'opportunità di valutare e fornire feedback sulle nuove tecnologie web attraverso test nel mondo reale. Nelle prove dell'origine precedenti, i siti erano in grado di eseguire test su singole API. Per le API Topics, FLEDGE e Attribution Reporting forniremo una prova di una singola origine che consente ai siti di eseguire esperimenti unificati sulle API che costituiscono una versione iniziale del ciclo di vita degli annunci end-to-end. Le API sono disponibili per i test in Chrome 101 beta e versioni successive. La release Chrome 101 Beta presenta anche aggiornamenti ai controlli utente mentre continuiamo a eseguire l'iterazione delle opzioni di configurazione.
In qualità di sviluppatore, potrai registrarti a questa prova di una singola origine che ti consentirà di eseguire test sulle API Topics, FLEDGE e Attribution Reporting. Questa guida illustra i passaggi di configurazione per accedere alle API, spiega come convalidare la configurazione e fornisce ulteriori risorse per i test sulle API.
Cosa prevede la prova dell'origine?
Lo scopo di questa prova dell'origine è consentire test significativi durante il ciclo di vita degli annunci su più siti. Per coprire questo percorso, la prova dell'origine include:
- Topics per osservare e accedere agli argomenti di un browser tramite
document.browsingTopics(). - FLEDGE per gestire i gruppi di interesse di un browser, insieme alle offerte e alla selezione degli annunci in base a questi
gruppi e ad altri indicatori.
- In questa prova dell'origine, FLEDGE è disponibile su computer e include un sottoinsieme specifico di tutte le funzionalità proposte. Per ulteriori informazioni, leggi i dettagli della prova dell'origine di FLEDGE.
- Frame fecondati per visualizzare l'URL opaco del vincitore dell'asta dell'annuncio FLEDGE.
- Report sull'attribuzione per
misurare e generare report sul rendimento durante il ciclo di vita degli annunci.
- Nell'ambito dei report sull'attribuzione, i report aggregabili devono essere elaborati e aggregati da un servizio di aggregazione per produrre report di riepilogo. A breve pubblicheremo strumenti e guide aggiuntive per i test delle prove locali e dell'origine.
- Se hai partecipato a prove dell'origine precedenti per Attribution Reporting, tieni presente che dovrai eseguire l'aggiornamento in linea con le ultime modifiche all'API. Per maggiori dettagli, consulta la guida alla migrazione.
Sebbene questa configurazione consenta di eseguire test unificati su tutte queste API, puoi scegliere gli aspetti da implementare in base alle tue esigenze, in base alle tue esigenze.
In che modo gli sviluppatori possono registrarsi per la prova dell'origine?
Registrati al periodo di prova Pertinenza e misurazione di Privacy Sandbox. Fornisci un token di prova con i seguenti tag HTML su ogni pagina in cui vuoi 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 di pagina di primo livello:
Origin-Trial: TOKEN_GOES_HERE
Alcune funzionalità disponibili nella prova dell'origine sono destinate a essere utilizzate in contesti tra siti, ad esempio quando fornisci un servizio come terza parte sul sito di primo livello. Se devi attivare la prova dell'origine per questi contesti aggiuntivi, assicurati di selezionare l'opzione "Corrispondenza di terze parti".
Per attivare la prova dell'origine da JavaScript di terze parti, inserisci il tag <meta> nella 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 a livello locale?
La documentazione per gli sviluppatori dedicata a Topics, FLEDGE e Attribution Reporting fornisce indicazioni specifiche sui test degli sviluppatori locali per ogni API. Le API non sono attive per impostazione predefinita e devono essere abilitate con flag per i test.
Per abilitare le API per i test, devi:
- Utilizza Chrome 101 beta o versione successiva.
- FLEDGE richiede Chrome su computer.
- Le API non sono disponibili nelle versioni iOS di Chrome.
- Abilita le API utilizzando il flag
chrome://flags/#privacy-sandbox-ads-apis.- Questo flag forza l'attivazione delle API per semplificare i test. Se vuoi
replicare un utente idoneo per la prova dell'origine in cui le sue impostazioni
aggiuntive 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 potrebbero avere più flag aggiuntivi per una configurazione più granulare. Per i dettagli, consulta le singole guide.
- Ulteriori flag potrebbero essere in conflitto con questo, quindi ti consigliamo di impostare solo questo flag in caso di problemi.
- Questo flag forza l'attivazione delle API per semplificare i test. Se vuoi
replicare un utente idoneo per la prova dell'origine in cui le sue impostazioni
aggiuntive 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. È accessibile anche su
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 "Consenti tutti i cookie" o "Blocca cookie di terze parti in modalità di navigazione in incognito". È
accessibile anche all'indirizzo
chrome://settings/cookies. - Essere in una sessione di navigazione standard. Non usare la modalità di navigazione in incognito.
In che modo gli sviluppatori controllano se la prova dell'origine è configurata correttamente?
In Risoluzione dei problemi relativi alle prove dell'origine di Chrome viene fornito un elenco di controllo dettagliato per convalidare la configurazione della prova dell'origine.
DevTools mostra lo stato di una prova dell'origine nella scheda Applicazioni sotto i frame.
Sebbene la prova dell'origine venga mostrata come attiva solo per gli utenti idonei, come descritto di seguito, puoi anche utilizzare i flag per sviluppatori per eseguire il test sul tuo sito di produzione.
Quali utenti sono idonei per la prova dell'origine?
Per impostazione predefinita, le prove dell'origine sono concepite per essere eseguite solo su una piccola porzione del traffico complessivo di Chrome e, di conseguenza, dovresti sempre presumere che, anche quando hai abilitato la prova dell'origine sul tuo sito, l'utente potrebbe non avere l'API attiva. Il gruppo sperimentale attivo nella prova dell'origine inizierà con una bassa percentuale di utenti e probabilmente aumenterà con il progredire della prova. Tieni presente che la percentuale di utenti di Chrome nell'esperimento potrebbe non corrispondere a quella di utenti abilitati sul tuo sito.
Tuttavia, per consentire l'esecuzione di test unificati su più siti, questo insieme di utenti idonei deve rimanere per lo più coerente. Ad esempio, se un utente è idoneo alla prova dell'origine quando visualizza un annuncio sul sito di un publisher partecipante, lo stesso utente dovrebbe essere comunque idoneo quando effettua una conversione sul sito di un inserzionista partecipante.
Affinché l'utente sia idoneo, deve:
- Utilizzi Chrome 101 Beta o versioni successive.
- FLEDGE richiede Chrome su computer.
- non sono disponibili prove dell'origine nelle versioni iOS di Chrome.
- navigare durante il periodo di prova per l'origine attiva.
- Attivare le prove di Privacy Sandbox tramite Impostazioni > Sicurezza e
privacy > Privacy Sandbox, accessibile anche tramite
chrome://settings/adPrivacy. - Avere i cookie di terze parti abilitati tramite Impostazioni > Sicurezza e privacy >
Cookie e altri dati dei siti impostati su "Consenti tutti i cookie" o "Blocca
cookie di terze parti in 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.
- Far parte del gruppo sperimentale attivo in Chrome.
In che modo gli sviluppatori dovrebbero rilevare il supporto dell'API nelle funzionalità?
Come per qualsiasi funzionalità della piattaforma web, devi rilevare il supporto per la funzionalità prima di utilizzarla.
Argomenti
Verifica la presenza della funzione browsingTopics() in document e
nel criterio delle autorizzazioni](https://developer.chrome.com/articles/permissions-policy/#featurepolicyallowsfeaturefeature) per l'argomento "browsing-topics".
if ('browsingTopics' in document && document.featurePolicy.allowsFeature('browsing-topics')) {
// Topics enabled
}
FLEDGE
Se vuoi unirti a un gruppo di interesse per gli annunci, verifica la presenza della funzione joinAdInterestGroup in
navigator e delle 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 la funzione runAdAuction in navigator e le norme relative alle autorizzazioni per "run-ad-auction".
if ('runAdAuction' in navigator && document.featurePolicy.allowsFeature('run-ad-auction')) {
// FLEDGE auction enabled
}
Reporting sull'attribuzione
Verifica la presenza dell'oggetto attributionReporting in window e
nelle norme relative alle autorizzazioni per "attribution-reporting".
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// Attribution Reporting API enabled
}
Da dove gli sviluppatori possono fornire feedback e ricevere assistenza?
La pagina di panoramica dei feedback descrive in dettaglio i vari percorsi per fornire feedback su diversi aspetti di Privacy Sandbox. Esistono sezioni specifiche per Topics, FLEDGE e Attribution Reporting che forniscono i singoli link per ogni API.
Forniamo inoltre aggiornamenti regolari sulla serie Progressi nella serie Privacy Sandbox, che fornisce un riepilogo delle notizie importanti.