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 demostraciones para comprender cómo funciona Topics antes de sumergirte en la implementación.

Habilita Topics en tu navegador

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

  1. Habilita todas las APIs de privacidad en los anuncios de chrome://settings/adPrivacy.
  2. (Recomendado) Ejecuta Chrome desde la línea de comandos con marcas de Chromium y usa parámetros específicos de la API de Topics para configurarlo según sea necesario. Si ejecutas Chrome desde la línea de comandos, tendrás un control más detallado sobre las funciones de Temas. Por ejemplo, es posible establecer ciclos de entrenamiento de Topics (el período que usa la API para calcular los intereses de los usuarios) 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 privacidad en los anuncios 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 la explicación.

Controlar la API de Topics con funciones experimentales de Chrome

Las funciones experimentales 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 Si la API de Topics está habilitada.
PrivacySandboxAdsAPIsOverride habilitado Habilita las APIs de anuncios: Attribution Reporting, Protected Audience, Topics y Marcos vallados.
PrivacySandboxSettings4 inhabilitado Habilita la cuarta versión de la configuración de la IU de Privacy Sandbox.
OverridePrivacySandboxSettingsLocalTesting habilitado Si se habilita, el navegador ya no requiere que se habilite la configuración subyacente para habilitar las funciones de Privacy Sandbox.
BrowsingTopicsBypassIPIsPubliclyRoutableCheck inhabilitado Si está habilitada, se omitirá la verificación de si la dirección IP se puede enrutar públicamente cuando se determine la elegibilidad de una página para que se incluya en el cálculo de temas.
BrowsingTopics:number_of_epochs_to_expose 3 Es la cantidad de épocas a partir de las cuales se calculan los temas que se entregarán a un contexto solicitante. El navegador mantendrá internamente hasta N+1 ciclos de entrenamiento.
BrowsingTopics:time_period_per_epoch 7d-0h-0m-0s Duración de cada ciclo de entrenamiento. Para la depuración, puede ser útil establecer este valor en 15 segundos, en lugar de los siete días predeterminados.
BrowsingTopics:number_of_top_topics_per_epoch 5 Cantidad de temas calculada por ciclo de entrenamiento.
BrowsingTopics:use_random_topic_probability_percent 5 Probabilidades de que un tema individual dentro de un ciclo de entrenamiento se muestre de forma aleatoria desde toda la taxonomía de temas. La aleatoriedad es fija para una época y un sitio.
BrowsingTopics:number_of_epochs_of_observation_data_to_use_for_filtering 3 Cuántas épocas de datos de uso de la API (es decir, observaciones de temas) 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 La cantidad máxima de dominios de contexto observados por mantener para cada tema principal. El objetivo 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 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 Encodifica los parámetros de configuración de la API de Topics. Cada número de versión solo debe asignarse a un conjunto de configuraciones. Por lo general, actualizar los parámetros de configuración sin actualizar el config_version debería estar bien para las pruebas locales, pero, en algunos casos, podría dejar el navegador en un estado incoherente y podría provocar una falla del navegador, por ejemplo, actualizar number_of_top_topics_per_epoch.
BrowsingTopics:taxonomy_version 1 Es la versión de la taxonomía que usa la API.

Antes de comenzar a implementar

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 funciona Topics en la Web.
    3. Prueba las demostraciones y mira las demostraciones, Colab y las herramientas de Topics video explicativo.
    4. Crea una bifurcación de las demostraciones y ejecútalas desde tu propio sitio.
    5. Lee la explicación de la API para comprender más detalles.
  2. Comprende la función de la API en respaldar la relevancia del anuncio en el futuro, en el que las cookies de terceros no estarán disponibles para una proporción creciente 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 sobre problemas con GitHub o llamadas W3C.
  5. Si encuentras términos que no conoces, consulta el glosario de Privacy Sandbox.
  6. Para obtener más información sobre los conceptos de Chrome, como las funciones experimentales de Chrome, consulta los videos y artículos breves 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.