Prueba, implementa y escala una solución basada en temas

En esta página, se explica cómo compilar, probar y escalar una implementación para la producción con la API de Topics.

Implementación del backend de temas

La implementación del backend depende de cómo quieras usar los temas calculados en el navegador. Recomendamos que las soluciones de tecnología publicitaria usen Topics como un indicador adicional de la IBA.

// Use the language/framework/stack of your preference
function processTopicsBackendAPI(topics) {
 // If the list is not empty, continue
 // Use topics as an additional signal
}

Usa Topics como un indicador adicional

Los datos de temas se pueden considerar junto con otros indicadores, como las URLs, las palabras clave o otros metadatos, como un indicador adicional sobre tu público.

Como se explica en Maximizar la relevancia de los anuncios luego de las cookies de terceros, existen varios enfoques para aprovechar Topics y publicar anuncios relevantes. Algunas de estas estrategias implican usar los temas para crear públicos, y otros enfoques sugieren usar los temas como un indicador entre otros para entrenar modelos de aprendizaje automático que se usarán para inferir intereses adicionales del público o incluso para optimizar la lógica de las ofertas.

Compila e implementa

  1. Recopila temas observando a los usuarios en producción (tiempo de implementación estimado: aproximadamente una semana):
    • Comprende tus opciones: cómo llamar a Topics con encabezados HTTP o JavaScript y un iframe.
    • Define el dominio del iframe que llamará a la API de Topics.
    • Compila tu solución con la demostración de encabezado o la demostración de JavaScript como referencia de código.
    • Integra Topics en el código que los publicadores insertan en sus sitios (por ejemplo, tu iframe de anuncio). Asegúrate de llamar a los temas desde la incorporación.
    • Para comenzar a observar los temas de los usuarios, incorpora la versión más reciente de tu secuencia de comandos en tus sitios web de producción. Te recomendamos que primero pruebes la implementación en tus propios sitios web que tengan una pequeña cantidad de visitas mensuales. En esta etapa, te recomendamos que incorpores tu nueva solución basada en temas en al menos cinco sitios.
    • En este punto, se espera que la API devuelva un array vacío como resultado. Esto se debe a que aún no se observaron temas para el usuario. Puede tardar hasta tres semanas en comenzar a recibir temas de usuarios.
    • Realiza pruebas y validaciones funcionales. Puedes probar tu solución de forma manual o automática. Por ejemplo:
      • Abre tu navegador con marcas y establece la época en 15 segundos para que el navegador vuelva a calcular los temas más rápido.
      • Visita los sitios que incorporan tu secuencia de comandos.
      • Verifica si tu secuencia de comandos observa temas en chrome://topics-internals/.
      • Consulta los resultados que puedes esperar.
  2. Usar los datos de Topics junto con otros indicadores contextuales (como URLs, metadatos, etcétera) (tiempo estimado: alrededor de 3 días).
    • Después de tres semanas en producción, tu secuencia de comandos debería haber observado algunos temas de los usuarios. En este punto, deberías poder usar los datos de Temas como un indicador adicional.
    • Una vez que comiences a recibir una lista de temas no vacía, podrás enviarla a tu backend con otros indicadores contextuales.

Implementa en sitios objetivo

Una vez que hayas integrado una llamada a Topics en tu secuencia de comandos, asegúrate de que esté incorporada en algunos sitios de producción para una primera prueba. Asegúrate de que tu implementación funcione según lo previsto:

  • Se llama a la API de Topics.
  • Los temas se pueden observar en este entorno controlado.
  • Se puede acceder a los temas (la API devuelve los temas observados para el usuario).

Elige los sitios objetivo

Antes de implementar tu solución en los sitios de los publicadores, te recomendamos que la pruebes en un entorno controlado, en los sitios web que te pertenecen. Te recomendamos que elijas los sitios web objetivo de la siguiente manera:

  • El sitio recibe una pequeña cantidad de visitas mensuales (menos de un millón de visitas al mes): Primero, debes implementar la API para un público pequeño.
  • Eres propietario y tienes el control del sitio: Si es necesario, puedes inhabilitar rápidamente la implementación sin aprobaciones complejas.
  • El sitio no es fundamental para la empresa: Comienza con sitios objetivo de bajo riesgo.
  • No más de cinco sitios en total: Por ahora, no necesitarás tanto tráfico ni exposición.
  • Los sitios objetivo representan diferentes temas: Elige sitios web que representen diferentes categorías (por ejemplo, uno sobre deportes, otro sobre noticias y uno más sobre comida y bebida). Puedes usar la herramienta de temas internos de Chrome para validar dominios y cómo los clasifica el clasificador de aprendizaje automático de Topics.

Pruebas y validación funcionales

Cuando llames a la API de Topics en este entorno limitado, puedes esperar los siguientes resultados:

  • Es un array vacío de temas [] si es la primera llamada de este dispositivo, para este sitio y quien llama en los últimos siete días.

  • Es una lista de entre cero y tres temas que representan los intereses de este usuario. Después de siete días de observación, deberías recibir lo siguiente:

    • Un tema seleccionado entre los cinco principales del usuario, calculado a partir de los nombres de host de las páginas en las que el llamador observó temas durante esa semana.

  • Es la misma respuesta de la API que en todas las llamadas anteriores a la API de Topics. Para el mismo llamador, usuario y sitio de nivel superior, la API devolverá los mismos temas para toda una época. Esto ayuda a evitar exponer demasiados intereses del usuario. Obtén más detalles en GitHub.

  • Un tema nuevo que reemplaza uno de los tres anteriores si llamas a Topics después de cuatro semanas de observación

  • Si no observaste temas para el usuario durante las tres semanas anteriores o más, la API de Topics volverá a mostrar un array vacío [].

Recopila métricas de rendimiento para evaluar la experiencia del usuario:

  • El tiempo de ejecución de las llamadas de JavaScript a la API de Topics dentro de un iframe de origen cruzado se debe medir para usarlo en futuros análisis de rendimiento.
  • Es el tiempo que se tarda en crear un iframe y los temas de postMessage() después de que se reciben los temas.

Para solucionar problemas, consulta la sección de asistencia.

Escala a producción

En este punto, deberías haber probado Topics en un entorno controlado (en algunos sitios de tu propiedad). Si todo funciona como se espera, es hora de escalar esta implementación. Implementa el mismo código en más sitios web objetivo. Esto te permitirá observar a más usuarios, recopilar más datos sobre temas y profundizar tu comprensión de tus públicos.

A continuación, se incluye un resumen paso a paso de cómo puedes escalar a producción:

  1. Prueba tu solución basada en temas con un mayor volumen de tráfico.
  2. Implementa tu solución en los sitios de los publicadores.
    • Una vez que tu solución funcione correctamente en tu propio entorno de pruebas, colabora con los publicadores para integrar tu iframe en sus sitios web. Por ejemplo, es posible que deban actualizar la biblioteca que incluye tu iframe.
  3. Procesar y usar los datos de temas (tiempo estimado: alrededor de cuatro semanas)
    • Incorporar los datos de temas como un indicador aditivo junto con otros datos
    • Buscar socios para realizar pruebas de ofertas en tiempo real
    • Ejecuta pruebas de utilidad con temas como un indicador adicional para tus otros datos.

Pruebas de carga

Para asegurarte de que tu sistema pueda controlar el tráfico, te recomendamos que realices pruebas de carga antes de implementar tu solución basada en temas en los sitios de los publicadores.

  1. Realiza la implementación de forma gradual en más sitios objetivo que sean de tu propiedad, en especial aquellos que tengan un mayor volumen de tráfico.
  2. Realiza pruebas de carga para los datos de tus temas según el tráfico esperado.
    • Deberás enviar la información del tema desde el iframe a tu backend. Esto te permite procesar aún más los resultados de la API de Topics y usarlos como un indicador adicional para ayudar a seleccionar anuncios más relevantes para el usuario. A medida que más sitios incorporen tu integración, la cantidad de llamadas a tu backend aumentará de forma significativa. Confirma que tu backend pueda controlar un gran volumen de llamadas desde el iframe.
    • Configura la recopilación de métricas y los registros para el análisis.
  3. Inmediatamente después de implementar la API de Topics, verifica tus métricas para detectar cualquier problema grave del usuario final. Revisa tus métricas periódicamente.
  4. En caso de interrupción o comportamiento inesperado, revierte la implementación y analiza tus registros para comprender y solucionar el problema.

Consulta también

Consulta nuestros recursos para comprender mejor la API de Topics en la Web.