Testare le API di misurazione e pertinenza degli annunci di Privacy Sandbox

Privacy Sandbox include una selezione di proposte per abilitare casi d'uso pubblicitari senza la necessità del monitoraggio tra siti. I provini di Origin offrono agli sviluppatori l'opportunità di valutare e fornire feedback sulle nuove tecnologie web tramite test reali. Nelle prove precedenti, i siti di origine sono stati in grado di eseguire test su singole API. Per le API Topics, FLEDGE e Attribution Reporting, stiamo offrendo una prova dell'origine singola che consente ai siti di eseguire esperimenti unificati tra le API, creando 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 beta di Chrome 101 include anche aggiornamenti ai controlli per gli utenti, man mano che continuiamo a eseguire l'iterazione sulle opzioni di configurazione.

In qualità di sviluppatore, potrai registrarti a questa prova dell'origine singola che ti consentirà di eseguire test sulle API Topics, FLEDGE e Attribution Reporting. Questa guida illustra la procedura di configurazione per accedere alle API, spiega come convalidare la configurazione e fornisce ulteriori risorse per i test sulle API.

Che cos'è la prova dell'origine?

Lo scopo di questa prova dell'origine è consentire test significativi nel ciclo di vita dell'annuncio 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, nonché le offerte e la selezione degli annunci in base a questi gruppi e ad altri indicatori.
  • Frame delimitati per visualizzare l'URL opaco del vincitore dell'asta di annunci FLEDGE.
    • Attribution Reporting per misurare e generare report sul rendimento durante il ciclo di vita dell'annuncio.
    • 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 ulteriori strumenti e guide per i test di prova locale e di origine.
    • Se hai partecipato a prove precedenti dell'origine per i report sull'attribuzione, tieni presente che dovrai eseguire l'aggiornamento in linea con le modifiche più recenti dell'API. Per maggiori dettagli, consulta la guida alla migrazione.

Sebbene questa configurazione consenta test unificati su tutte queste API, puoi scegliere quali aspetti implementare, in base alle tue esigenze.

Come possono gli sviluppatori registrarsi per la prova dell'origine?

Registrati per la prova di rilevanza e misurazione di Privacy Sandbox. Con i seguenti tag HTML, fornisci un token di prova in 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 della pagina di primo livello: Origin-Trial: TOKEN_GOES_HERE

Alcune funzionalità disponibili nella prova dell'origine sono destinate all'utilizzo in contesti cross-site, ad esempio quando fornisci un servizio come terze parti 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) 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);

Scopri di più nella guida introduttiva ai trial di Origin di Chrome.

In che modo gli sviluppatori eseguono i test in locale?

La documentazione per sviluppatori delle singole API 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 i flag per i test.

Per abilitare le API per i test, devi:

  • Utilizza Chrome 101 Beta o versioni successive.
    • FLEDGE richiede Chrome per computer.
    • Le API non sono disponibili nelle versioni di Chrome per iOS.
  • 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 della prova dell'origine in cui le impostazioni aggiuntive possono comunque disattivare le API, devi avviare Chrome utilizzando i flag CLI: --enable-features=BrowsingTopics,InterestGroupStorage,AllowURNsInIframes,PrivacySandboxAdsAPIs. * Le singole API potrebbero avere altri flag aggiuntivi per una configurazione più granulare. Per maggiori dettagli, consulta le singole guide.
    • I flag aggiuntivi potrebbero entrare in conflitto con questo, quindi ti consigliamo di impostare solo questo flag se riscontri problemi.
  • Attiva le prove di Privacy Sandbox nelle Impostazioni di Chrome: Impostazioni > Sicurezza e privacy > Privacy Sandbox. È accessibile anche all'indirizzo 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 nella modalità di navigazione in incognito". È anche accessibile all'indirizzo chrome://settings/cookies.
  • Devi essere in una sessione di navigazione standard. Non utilizzare la modalità di navigazione in incognito.

In che modo gli sviluppatori possono verificare se la prova dell'origine è configurata correttamente?

La pagina Risoluzione dei problemi relativi alle prove delle origini di Chrome fornisce un elenco di controllo dettagliato per convalidare la configurazione della prova dell'origine.

DevTools che mostra lo stato della prova dell&#39;origine in Applicazioni

DevTools mostra lo stato di una prova dell'origine nella scheda Applicazioni, in Frames.

Sebbene la prova dell'origine venga visualizzata come attiva solo per gli utenti idonei, come descritto di seguito, puoi anche utilizzare i flag per sviluppatori per eseguire test sul tuo sito di produzione.

Quali utenti sono idonei per la prova dell'origine?

Per impostazione predefinita, le prove dell'origine devono essere eseguite solo su una piccola parte del traffico complessivo di Chrome. Pertanto, devi sempre presumere che, anche se hai attivato la prova dell'origine sul tuo sito, l'utente potrebbe non avere attivato l'API. Il gruppo sperimentale attivo nella prova di origine inizierà con una bassa proporzione di utenti e probabilmente aumenterà man mano che la prova procede. Tieni presente che la percentuale di utenti di Chrome nell'esperimento potrebbe non corrispondere alla percentuale di utenti abilitati sul tuo sito.

Tuttavia, per consentire test unificati su più siti, questo insieme di utenti idonei deve rimanere per lo più coerente. Ad esempio, se un utente è idoneo per la prova dell'origine quando visualizza un annuncio sul sito di un publisher partecipante, lo stesso utente deve essere ancora idoneo quando effettua una conversione sul sito di un inserzionista partecipante.

Affinché un utente sia idoneo, deve:

  • Utilizzare Chrome 101 Beta o versioni successive.
    • FLEDGE richiede Chrome per computer.
    • non sono disponibili prove delle origini nelle versioni di Chrome per iOS.
  • navigare durante il periodo di prova dell'origine attiva.
  • Avere attivato le prove di Privacy Sandbox tramite Impostazioni > Sicurezza e privacy > Privacy Sandbox, accessibile anche tramitechrome://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.
  • Devi far parte del gruppo sperimentale attivo in Chrome.

In che modo la funzionalità per gli sviluppatori deve rilevare il supporto dell'API?

Come per qualsiasi funzionalità della piattaforma web, devi rilevare il supporto della funzionalità prima di utilizzarla.

Argomenti

Verifica la presenza della funzione browsingTopics() in document e nelle Norme relative alle autorizzazioni](https://developer.chrome.com/articles/permissions-policy/#featurepolicyallowsfeaturefeature) per "browsing-topics".

if ('browsingTopics' in document && document.featurePolicy.allowsFeature('browsing-topics')) {
  // Topics enabled
}

FLEDGE

Se vuoi partecipare a un gruppo di interessi degli annunci, controlla la funzione joinAdInterestGroup in navigator e le Norme relative alle 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 runAdAuctionfunzione 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
}

Report sull'attribuzione

Cerca l'oggetto attributionReporting in window e nel criterio di Permissions per "attribution-reporting".

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // Attribution Reporting API enabled
}

Dove possono gli sviluppatori fornire feedback e ricevere assistenza?

La pagina di panoramica dei feedback descrive i vari modi per fornire feedback su diversi aspetti di Privacy Sandbox. Esistono sezioni specifiche per Topics, FLEDGE e Report sull'attribuzione che forniscono i singoli link per ogni API.

Forniamo inoltre aggiornamenti regolari sulla serie Progress in Privacy Sandbox, che fornisce un riepilogo delle notizie importanti.