API de Topics: herramientas de prueba y análisis

Obtén información sobre las herramientas disponibles en Chrome para ver la información de la API de Topics y comprender cómo se asignan los temas.

Consulta la información de la API de Topics

La página chrome://topics-internals está disponible en Chrome para computadoras de escritorio una vez que habilitas la API de Topics. Se muestran los temas del usuario actual, los temas inferidos para los nombres de host y la información técnica sobre la implementación de la API. Estamos iterando y mejorando el diseño de la página en función de los comentarios de los desarrolladores. Para dar forma a la API de Topics, envía tus comentarios como un error de Chromium.

Cómo ver los temas observados para tu navegador

Los usuarios pueden ver información sobre los temas observados para su navegador durante las épocas actuales y anteriores en chrome://topics-internals.

La página chrome://topics-internals con el panel de estado de Topics seleccionado
En el panel Estado de temas de la página chrome://topics-internals, se muestran los IDs de los temas, las tareas de temas aleatorios y reales, y las versiones de taxonomía y modelo.

En esta captura de pantalla, se muestra que los sitios visitados recientemente incluyen topics-demo-cats.glitch.me y cats-cats-cats-cats.glitch.me. Esto hace que la API de Topics seleccione Pets y Cats como dos de los temas principales de la época actual. Los tres temas restantes se eligieron de forma aleatoria, ya que no hay suficiente historial de navegación (en sitios que observan temas) para proporcionar cinco temas.

La columna Observed-by context domains (hashed) proporciona el valor con codificación hash de un nombre de host para el que se observó un tema.

Cómo ver los temas inferidos para los nombres de host

También puedes ver los temas inferidos por el modelo de clasificador de Topics para uno o más nombres de host en chrome://topics-internals.

La página chrome://topics-internals con el panel Classifier seleccionado.
En el panel Clasificador de la página chrome://topics-internals, se muestran los temas seleccionados, los hosts visitados, la versión y la ruta del modelo.

La implementación actual de la API de Topics infiere temas solo de los nombres de host, no de ninguna otra parte de una URL.

Usa solo nombres de host (sin protocolo ni ruta) para ver los temas inferidos del clasificador chrome://topics-internals. chrome://topics-internals mostrará un error si intentas incluir una barra (/) en el campo Host.

Consulta la información de la API de Topics

Puedes encontrar información sobre la implementación y la configuración de la API de Topics, como la versión de la taxonomía y la duración de la época, en chrome://topics-internals. Estos valores reflejan la configuración predeterminada de la API o los parámetros configurados correctamente desde la línea de comandos. Esto puede ser útil para confirmar que las marcas de línea de comandos funcionaron como se esperaba.

En el ejemplo, time_period_per_epoch se estableció en 15 segundos (el valor predeterminado es de siete días).

Página chrome://topics-internals con el panel Funciones y parámetros seleccionado.
En el panel Funciones y parámetros chrome://topics-internals, se muestran las funciones habilitadas, el tiempo por época, la cantidad de épocas que se usarán para calcular los temas, la versión de la taxonomía y otros parámetros de configuración.

Los parámetros que se muestran en la captura de pantalla corresponden a marcas que se pueden establecer cuando se ejecuta Chrome desde la línea de comandos. Obtén más información para controlar la API de Topics con marcas de Chrome en la sección de configuración dedicada.

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

Colab

Ejecuta Colab para aprender a cargar el modelo de TensorFlow Lite que usa Chrome para inferir temas a partir de nombres de host. Encontrarás las instrucciones en la descripción de Colab o en el video de explicación. Ten en cuenta que esta Colab usa la versión anterior de la taxonomía.

Cómo usar la API de Topics en sitios web con prebid.js

Como se señaló en el lanzamiento de Prebid 7, la comunidad desarrolló activamente una integración con la API de Topics mediante un módulo nuevo. Este módulo se fusionó en diciembre de 2022. Lee la documentación del módulo de la API de Topics de Prebid. Para obtener más información sobre la integración, comunícate con Prebid.js a través de cualquier canal estándar que ofrezcan.

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.