Recursos de asistencia para la API de Topics en la Web

Encuentra recomendaciones para depurar, solucionar problemas y obtener recursos de asistencia para Temas en la Web.

Solución de problemas

Si realizas una llamada document.browsingTopics() o una solicitud fetch() con el encabezado Sec-Browsing-Topics establecido, pero recibes un array vacío como respuesta, hay varios pasos de depuración que puedes seguir para identificar la causa raíz del problema, tanto en tu entorno de desarrollo local como en el sistema en vivo.

Cómo depurar de forma local

Si realizas pruebas de forma local, asegúrate de ejecutar Chrome con los parámetros requeridos.

  • Para omitir la inscripción, habilita la marca chrome://flags/#privacy-sandbox-enrollment-overrides y agrega la URL del sitio que llama a Topics.

  • Configura la API de Topics para realizar pruebas con las marcas de funciones. Estos marcadores te permiten modificar parámetros como la duración de la época, la cantidad de temas principales y otros, para que puedas probar Topics cómodamente. Puedes usar estas marcas de funciones recomendadas:

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

  • Antes de ejecutar Chrome con marcas, asegúrate de haber cerrado todas las demás instancias y procesos de Chrome.

  • Asegúrate de lo siguiente:

    • Estás usando Chrome 101 o una versión posterior.
    • Tu secuencia de comandos llamó a la API de Topics para observar temas. Cuando realices pruebas, puedes visitar los sitios en los que se encuentra incorporada tu secuencia de comandos para simular el comportamiento de los usuarios. Consulta la demostración para ver un ejemplo práctico.
    • No tienes un bloqueador de anuncios ni una app o extensión similar en ejecución.
    • Si no estás en el modo Incógnito.
    • En chrome://settings/trackingProtection, la opción Block all third-party cookies está inhabilitada.

Cómo depurar la implementación en vivo

Si llamas a la API de Topics desde una aplicación activa durante la primera semana de observación de un usuario, se espera un resultado vacío, ya que es posible que tu aplicación aún no haya observado temas para un usuario. Puedes depurar tu solución siguiendo nuestras recomendaciones.

  • Asegúrate de que tu sitio esté inscrito en Privacy Sandbox.
  • Prueba el código del frontend para asegurarte de que tu JavaScript funcione según lo esperado.
  • Prueba tu backend para recibir los resultados de los temas.
    • Recuerda asegurarte de que los tipos de datos y los parámetros de la API del backend estén configurados correctamente.
    • Asegúrate de que tu backend esté configurado para ajustarse de forma adecuada.
  • Según nuestra experiencia, es necesario esperar al menos tres semanas para comenzar a obtener resultados de temas más relevantes.
  • No todos los usuarios tendrán habilitado Topics:
    • Los usuarios pueden inhabilitar de forma explícita la API de Topics.
    • Las páginas de los publicadores pueden controlar la política de permisos y inhabilitar sus sitios.
  • Agrega métricas y observabilidad a este entorno: las necesitarás para analizar los primeros resultados. Estos son algunos ejemplos de métricas:
    • Latencia de las llamadas.
    • Errores HTTP en las llamadas a temas
  • Intenta limitar los cambios en tu implementación durante las tres semanas iniciales.

Recursos