API de Topics: herramientas de prueba y análisis

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

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. Aquí se muestran temas para el usuario actual, información técnica sobre la implementación de la API y temas inferidos para nombres de host. 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.

Ver los temas observados para tu navegador

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

La página chrome://topics-internals con el panel Estado de temas seleccionado.
En el panel chrome://topics-internals de estado de los temas, se muestran los IDs de los temas, las asignaciones aleatorias y reales de temas, 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 para el ciclo de entrenamiento actual. Los tres temas restantes se elegieron de forma aleatoria, ya que no hay suficiente historial de navegación (en sitios que observan temas) para proporcionar cinco temas.

La columna Dominios de observación por contexto (con codificación hash) proporciona el valor de hash de un nombre de host para el que se observó un tema.

Ver los temas inferidos para 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 Clasificador seleccionado
En el panel Clasificador de la página chrome://topics-internals, se muestran los temas seleccionados, los hosts visitados, y la versión del modelo y la ruta.

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 de acceso) para ver los temas inferidos del clasificador chrome://topics-internals. chrome://topics-internals mostrará un error si intentas incluir una “/” en el campo Host.

Ver 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
El panel chrome://topics-internals Funciones y parámetros muestra las funciones habilitadas, el tiempo por ciclo de entrenamiento, la cantidad de ciclos de entrenamiento que se deben usar para calcular 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 explicativo. Ten en cuenta que esta Colab usa la versión anterior de la taxonomía.

Usa 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 combinó 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.