Demo dell'API Topics

Sperimenta e scopri come gli argomenti vengono dedotti dai nomi host con una configurazione minima.

Stato implementazione

La demo dell'API Topics offre una panoramica del modo in cui gli argomenti vengono dedotti dai nomi host. Puoi visualizzare l'anteprima degli argomenti osservati quando visiti un sito dimostrativo, che richiede una configurazione minima.

La nostra demo è un'anteprima che illustra la maggior parte delle funzionalità dell'API Topics, per consentirti di acquisire familiarità con l'implementazione dell'API.

Puoi anche eseguire la colab di Topics per provare il modello di classificazione di Topics.

Il seguente video mostra come funziona la demo.

Esegui il test con chrome://flags o flag funzionalità

Esistono due modi per provare l'API Topics come singolo utente. È necessario utilizzare Chrome 101 o versioni successive:

  • Attiva l'API nella pagina chrome://flags/#privacy-sandbox-ads-apis di Chrome:

    Attiva l'API Topics utilizzando la pagina chrome://flags/#privacy-sandbox-ads-apis
    La pagina chrome://flags/#privacy-sandbox-ads-apis in cui puoi abilitare o disabilitare l'API.

  • Esegui Chrome dalla riga di comando con i seguenti flag:

    --enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/browsing_topics_max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting

Demo dell'API Topics

La demo di Topics mostra come utilizzare flag aggiuntivi per regolare le impostazioni, ad esempio la durata dell'epoca. Se accedi all'API Topics eseguendo Chrome con i flag della riga di comando, non impostare chrome://flags, che possono sostituire le impostazioni della riga di comando.

Esegui Chromium con flag spiega come impostare i flag durante l'esecuzione di Chrome e di altri browser basati su Chromium dalla riga di comando, anche se questa demo è specifica per Google Chrome.

Demo sulle intestazioni dell'API Topics

La demo all'indirizzo topics-fetch-demo.glitch.me mostra come utilizzare le intestazioni di richiesta e risposta fetch() per accedere agli argomenti e contrassegnarli come osservati.

Accedi all'intestazione della richiesta Sec-Browsing-Topics

Anziché utilizzare document.browsingTopics() da un iframe per visualizzare gli argomenti di un utente, i chiamanti dell'API possono accedere agli argomenti osservati dall'intestazione della richiesta Sec-Browsing-Topics di una richiesta di recupero() che include {browsingTopics: true} nel parametro di opzioni o dalla stessa intestazione di una richiesta XHR che imposta l'attributo deprecatedBrowsingTopics su true.

Ad esempio:

fetch('https://topics-server.glitch.me', {browsingTopics: true})
    .then((response) => {
        // Process the response
 })

Nei browser che supportano l'API, la richiesta fetch() includerà un'intestazione Sec-Browsing-Topics che elenca gli argomenti osservati per il nome host dell'URL della richiesta: in questo esempio, topics-server.glitch.me.

Se non sono stati osservati argomenti per questo nome host e questo utente, l'intestazione è inclusa, ma il valore è vuoto. In altre parole, l'intestazione Sec-Browsing-Topics in una richiesta fetch() include solo argomenti che sono stati osservati per il browser dell'utente corrente da un chiamante la cui origine corrisponde al nome host dell'URL della richiesta. È come se stessi chiamando document.browsingTopics() da un iframe per visualizzare gli argomenti osservati per l'utente corrente.

L'intestazione della richiesta viene inviata per una richiesta a condizione che siano applicate le norme di autorizzazione appropriate, che il contesto sia sicuro e che le impostazioni utente lo permettano. Gli argomenti non vengono forniti nelle intestazioni per le richieste di navigazione.

L'intestazione della richiesta Topics ha il seguente aspetto:

Sec-Browsing-Topics: 186;version="chrome.1:1:2206021246";config_version="chrome.1";model_version="2206021246";taxonomy_version="1", 265;version="chrome.1:1:2206021246";config_version="chrome.1";model_version="2206021246";taxonomy_version="1"

Questo esempio include due argomenti della tassonomia di Topics, 186 e 265, insieme alle informazioni sulla versione di ogni argomento.

L'inclusione dell'intestazione degli argomenti nelle richieste XHR è disponibile solo temporaneamente e in futuro l'assistenza verrà rimossa.

Contrassegna gli argomenti come osservati con Observe-Browsing-Topics

Se una richiesta include un'intestazione Sec-Browsing-Topics e la risposta a tale richiesta include un'intestazione Observe-Browsing-Topics: ?1, gli argomenti nell'intestazione della richiesta verranno contrassegnati dal browser nel modo in cui vengono osservati. Gli argomenti osservati sono idonei per il calcolo da parte dell'API Topics. Questo meccanismo è progettato per abbinare la funzionalità fornita utilizzando l'API JavaScript da un iframe.

Il seguente screenshot mostra gli argomenti registrati dalle visite ai siti nella pagina demo dell'API.

Pagina demo dell'API Topics su glitch.me
La demo glitch.me per provare l'API.

Questo elenco mostra i siti che puoi visitare dalla demo per registrare gli argomenti di tuo interesse. Come puoi vedere, la categoria Arti e intrattenimento/Umorismo nello screenshot non è l'argomento di uno di questi siti web, quindi questo argomento registrato è uno che è stato aggiunto come possibile argomento casuale al 5%.

  • pets-animals-pets-cats.glitch.me
  • cats-cats-cats-cats.glitch.me
  • cats-pets-animals-pets.glitch.me
  • cats-feline-meow-purr-whiskers-pet.glitch.

Nella scheda Stato argomenti della pagina chrome://topics-internals puoi controllare quali argomenti sono reali e quali sono casuali. Questo screenshot mostra un esempio di diverse sessioni di navigazione.

La scheda Stato Argomenti fornisce informazioni sugli argomenti osservati.
La scheda Stato argomenti mostra argomenti reali e casuali.

Passaggi successivi

Se sei uno sviluppatore di ad tech, sperimenta e partecipa con l'API Topics. Per risorse più approfondite, leggi la guida per gli sviluppatori.

Interagisci e condividi il tuo feedback