API Topics: strumenti di test e analisi

Scopri gli strumenti disponibili in Chrome per visualizzare le informazioni dell'API Topics, capire come vengono assegnati gli argomenti ed eseguire il debug della tua implementazione.

Visualizzare le informazioni sull'API Topics

La pagina chrome://topics-internals è disponibile in Chrome su computer dopo aver abilitato l'API Topics. Vengono visualizzati gli argomenti per l'utente corrente, gli argomenti dedotti per i nomi host e le informazioni tecniche sull'implementazione dell'API. Stiamo aggiornando e migliorando il design della pagina in base al feedback degli sviluppatori. Puoi dare forma all'API Topics inviando il tuo feedback come bug di Chromium.

Visualizza gli argomenti osservati per il tuo browser

Gli utenti possono visualizzare informazioni sugli argomenti osservati per il proprio browser durante il periodo corrente e quelli precedenti visualizzando chrome://topics-internals.

La pagina chrome://topics-internals con il riquadro Stato argomenti selezionato.
Il riquadro Stato degli argomenti della pagina chrome://topics-internals mostra gli ID argomento, le assegnazioni di argomenti casuali e reali e le versioni della tassonomia e del modello.

Questo screenshot mostra che i siti visitati di recente includono topics-demo-cats.glitch.me e cats-cats-cats-cats.glitch.me. Di conseguenza, l'API Topics seleziona Pets e Cats come due degli argomenti principali per l'epoca corrente. I tre argomenti rimanenti sono stati scelti a caso, poiché la cronologia di navigazione (sui siti che osservano gli argomenti) non è sufficiente per fornire cinque argomenti.

La colonna Domini di contesto osservati (sottoposti ad hashing) fornisce il valore sottoposto ad hashing di un nome host per il quale è stato osservato un argomento.

Visualizzare gli argomenti dedotti per i nomi host

Puoi anche visualizzare gli argomenti dedotti dal modello di classificatore Topics per uno o più nomi host in chrome://topics-internals.

La pagina chrome://topics-internals con il riquadro Classificatore selezionato.
Il riquadro Classificatore di pagina chrome://topics-internals mostra gli argomenti selezionati, gli host visitati, la versione e il percorso del modello.

L'attuale implementazione dell'API Topics deduco gli argomenti solo dai nomi host e non da altre parti di un URL.

Utilizza solo i nomi host (senza protocollo o percorso) per visualizzare gli argomenti dedotti dal classificatore chrome://topics-internals. Se tenti di includere il carattere "/", chrome://topics-internals visualizzerà un errore nel campo Host.

Visualizzare le informazioni sull'API Topics

Puoi trovare informazioni sull'implementazione e sulle impostazioni dell'API Topics, ad esempio la versione della tassonomia e la durata dell'epoca, in chrome://topics-internals. Questi valori riflettono le impostazioni predefinite per l'API o i parametri impostati correttamente dalla riga di comando. Ciò può essere utile per confermare che i flag della riga di comando hanno funzionato come previsto.

Nell'esempio, time_period_per_epoch è stato impostato su 15 secondi (il valore predefinito è sette giorni).

Pagina chrome://topics-internals con il riquadro Funzionalità e parametri selezionato.
Il riquadro Funzionalità e parametri di chrome://topics-internals mostra le funzionalità abilitate, il tempo per epoca, il numero di epoche da utilizzare per calcolare gli argomenti, la versione della tassonomia e altre impostazioni.

I parametri mostrati nello screenshot corrispondono ai flag che possono essere impostati quando viene eseguito Chrome dalla riga di comando. Scopri di più su come controllare l'API Topics con i flag di Chrome nella sezione dedicata alla configurazione.

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

Colab

Esegui Colab per scoprire come caricare il modello TensorFlow Lite utilizzato da Chrome per dedurre gli argomenti dai nomi host. Le istruzioni sono disponibili nella descrizione del colab o nel video della procedura dettagliata. Tieni presente che questa Colab utilizza la versione precedente della tassonomia.

Utilizzare l'API Topics sui siti web con prebid.js

Come indicato nel rilascio di Prebid 7, la community ha sviluppato attivamente un'integrazione con l'API Topics utilizzando un nuovo modulo. Questo modulo è stato unito a dicembre 2022. Leggi la documentazione del modulo API Topics di Prebid. Per ulteriori informazioni sull'integrazione, contatta Prebid.js tramite il canale standard che offre.

Next steps

Learn how users and developers can manage and customize the Topics API to suit user's preferences and needs.
Check out our resources for troubleshooting, technical support, filing bugs and asking questions.

See also

Check out our resources to better understand the Topics API on the Web.