API Topics: strumenti di test e analisi

Scopri gli strumenti disponibili in Chrome per visualizzare le informazioni dell'API Topics e comprendere come vengono assegnati gli argomenti.

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 perfezionando e migliorando il design della pagina in base al feedback degli sviluppatori. Puoi contribuire a definire l'API Topics inviando il tuo feedback come bug di Chromium.

Visualizzare gli argomenti osservati per il browser

Gli utenti possono visualizzare le informazioni sugli argomenti osservati per il browser durante le epoche attuali e precedenti visualizzando chrome://topics-internals.

La pagina chrome://topics-internals con il riquadro Stato argomenti selezionato.
Il riquadro Stato argomenti della pagina chrome://topics-internals mostra gli ID argomento, le assegnazioni di argomenti casuali e reali, nonché 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 di Topics per uno o più nomi host in chrome://topics-internals.

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

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

Utilizza solo i nomi host (senza protocollo o percorso) per visualizzare gli argomenti dedotti dal chrome://topics-internals Classificatore. chrome://topics-internals verrà visualizzato un errore se provi a includere un "/" 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. Questa operazione può essere utile per verificare che i flag della riga di comando funzionino 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 chrome://topics-internals Funzionalità e parametri 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 si esegue Chrome dalla riga di comando. Scopri di più su come controllare l'API Topics con i flag di Chrome nella sezione di configurazione dedicata.

--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 dagli host name. Le istruzioni sono disponibili nella descrizione del colab o nel video della procedura dettagliata. Tieni presente che questo colab utilizza la vecchia versione 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 dell'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.