Configuración de la API de Topics

Prepara tu entorno para usar, probar y desarrollar aplicaciones web con la API de Topics.

Compila y prueba de manera local

En esta sección, se describe cómo configurar tu entorno local para probar la API de Topics como desarrollador individual. Te recomendamos que explores las demos para comprender cómo funciona Topics antes de comenzar con la implementación.

Habilita Topics en tu navegador

Para habilitar la API de Topics en tu propia instancia de Chrome para realizar pruebas locales, tienes dos opciones:

  1. Habilita todas las APIs de Privacidad de anuncios en chrome://settings/adPrivacy.
  2. (Recomendado) Ejecuta Chrome desde la línea de comandos con marcas de Chromium usando parámetros específicos de la API de Topics para configurar según sea necesario. Puedes tener un control más detallado sobre las funciones de Topics si ejecutas Chrome desde la línea de comandos. Por ejemplo, es posible establecer épocas de Topics (el período que usa la API para calcular los intereses del usuario) y configurar el comportamiento de la API según tus necesidades.

Recomendaciones clave

  1. Asegúrate de cerrar y detener todos los procesos de Chrome antes de iniciar el nuevo con las marcas.
  2. Asegúrate de que todas las APIs de Ad privacy estén habilitadas en chrome://settings/adPrivacy.
  3. Si la API no funciona como se espera, prueba nuestras sugerencias para solucionar problemas.
  4. Si tienes preguntas, consulta los problemas de GitHub para el explicador.

Controla la API de Topics con funciones experimentales de Chrome

Las marcas de Chrome pueden modificar el comportamiento de la API de Topics. Ejecuta Chrome desde la línea de comandos con los parámetros especificados para facilitar las pruebas. Por ejemplo, la demostración de encabezados recomienda usar las siguientes marcas:

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

En la siguiente tabla, se explica cada parámetro, su valor predeterminado y su propósito.

Nombre de la marca Valor predeterminado Descripción
BrowsingTopics habilitado Indica si la API de Topics está habilitada.
PrivacySandboxAdsAPIsOverride habilitado Habilita las APIs de anuncios: Attribution Reporting, Protected Audience, Topics y Fenced Frames.
PrivacySandboxSettings4 inhabilitada Habilita la cuarta versión de la configuración de la IU de Privacy Sandbox.
OverridePrivacySandboxSettingsLocalTesting habilitado Si está habilitada, el navegador ya no requiere que se habiliten los parámetros de configuración subyacentes para habilitar las funciones de Privacy Sandbox.
BrowsingTopicsBypassIPIsPubliclyRoutableCheck inhabilitada Si está habilitado, se omitirá la verificación para determinar si se puede enrutar públicamente la dirección IP cuando se determine la elegibilidad de una página para incluirse en el cálculo de temas.
BrowsingTopics:number_of_epochs_to_expose 3 Es la cantidad de épocas a partir de las cuales se calcularán los temas que se proporcionarán a un contexto solicitante. Internamente, el navegador mantendrá hasta N+1 épocas.
BrowsingTopics:time_period_per_epoch 7d-0h-0m-0s Es la duración de cada época. Para la depuración, puede ser útil establecer este valor en (por ejemplo) 15 segundos, en lugar de los siete días predeterminados.
BrowsingTopics:number_of_top_topics_per_epoch 5 Es la cantidad de temas que se calcula por ciclo.
BrowsingTopics:use_random_topic_probability_percent 5 Es la probabilidad de que un tema individual dentro de una época sea uno que se devolvió de forma aleatoria de toda la taxonomía de temas. La aleatoriedad se mantiene para una época y un sitio.
BrowsingTopics:number_of_epochs_of_observation_data_to_use_for_filtering 3 Cantidad de épocas de datos de uso de la API (es decir, observaciones de temas) que se usarán para filtrar los temas de un contexto de llamada.
BrowsingTopics:max_number_of_api_usage_context_domains_to_keep_per_topic 1000 Es la cantidad máxima de dominios de contexto observados que se conservarán para cada tema principal. La intención es limitar la memoria en uso.
BrowsingTopics:max_number_of_api_usage_context_entries_to_load_per_epoch 100000 Es la cantidad máxima de entradas que se pueden recuperar de la base de datos para cada consulta de los contextos de uso de la API. La consulta se realizará una vez por época en el momento del cálculo de temas. El objetivo es limitar el uso máximo de memoria.
BrowsingTopics:max_number_of_api_usage_context_domains_to_store_per_page_load 30 Es la cantidad máxima de dominios de contexto de uso de la API que se pueden almacenar por carga de página.
BrowsingTopics:config_version 1 Codifica los parámetros de configuración de la API de Topics. Cada número de versión solo debe asignarse a un conjunto de configuración. Por lo general, actualizar los parámetros de configuración sin actualizar config_version no debería generar problemas para las pruebas locales, pero, en algunas situaciones, podría dejar el navegador en un estado incoherente y provocar una falla, por ejemplo, si se actualiza number_of_top_topics_per_epoch.
BrowsingTopics:taxonomy_version 1 Versión de la taxonomía que usa la API.

Antes de comenzar la implementación

Antes de comenzar la implementación, te recomendamos que revises estos recursos para familiarizarte con la API de Topics.

  1. Revisa la documentación para desarrolladores:
    1. Comprende el propósito de la API de Topics y su rol en la publicidad basada en intereses
    2. Comprende cómo funcionan los Temas en la Web.
    3. Prueba las demostraciones y mira el video explicativo de las demostraciones, Colab y las herramientas de Topics.
    4. Bifurca las demostraciones y ejecútalas desde tu propio sitio.
    5. Lee la explicación de la API para comprender más detalles.
  2. Comprende el papel de la API en la compatibilidad con la relevancia de los anuncios en el futuro, cuando las cookies de terceros no estén disponibles para una proporción cada vez mayor de usuarios.
  3. Para recibir notificaciones sobre los cambios de estado en la API, únete a la lista de distribución para desarrolladores y mantente al tanto de las actualizaciones más recientes de Topics.
  4. Participa en la conversación en los problemas de GitHub o las llamadas de W3C.
  5. Si te encuentras con términos desconocidos, consulta el glosario de Privacy Sandbox.
  6. Para obtener más información sobre los conceptos de Chrome, como las Chrome flags, revisa los videos y artículos cortos disponibles en goo.gle/cc.

Pasos siguientes

Consulta los detalles de la implementación y los ejemplos de código para que los emisores observen y accedan a los temas.
Aprende a implementar, probar y escalar soluciones basadas en Topics.