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 producción con la API de Topics.

Implementación del backend de Topics

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

// 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 indicador adicional

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

Como se explica en Maximiza la relevancia de los anuncios después de las cookies de terceros, existen varios enfoques para aprovechar Topics para publicar anuncios relevantes. Algunos de ellos implican usar temas para crear públicos, y otros enfoques sugieren usar 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 ofertas.

Compila e implementa

  1. Observa a los usuarios en producción para recopilar temas (tiempo de implementación estimado: aproximadamente una semana):
    • Comprende tus opciones: cómo llamar a Topics con encabezados HTTP o iframe y JavaScript.
    • Define el dominio del iframe que llamará a la API de Topics.
    • Compila tu solución usando la demostración del 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 anuncios). Asegúrate de llamar a los temas desde la incorporación.
    • Para comenzar a observar los temas de los usuarios, incorpora la última versión de la secuencia de comandos en tus sitios web de producción. Te recomendamos que pruebes la implementación en tus propios sitios web que tengan primero 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 muestre un array vacío como resultado. Esto se debe a que aún no se observaron temas para el usuario. Comenzar a obtener temas de usuarios puede demorar hasta tres semanas.
    • 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 el ciclo de entrenamiento en 15 segundos para que el navegador vuelva a calcular los temas antes.
      • Visita los sitios que incorporan tu secuencia de comandos.
      • Verifica si tu secuencia de comandos observa los temas en chrome://topics-internals/.
      • Consulta qué resultados puedes esperar.
  2. Usa 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 la producción, tu secuencia de comandos debió haber observado las fallas temas. En este punto, deberías poder usar los datos de Topics como un indicador adicional.
    • Una vez que comiences a recibir una lista de temas no vacía, puedes enviarla a tu backend con otros indicadores contextuales.

Implementación en sitios de destino

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 la implementación funcione según lo esperado:

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

Elija sitios de destino

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 de segmentación 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 para un público pequeño.
  • Eres propietario y controlas el 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 de destino de bajo riesgo.
  • Total: cinco sitios como máximo: Por el momento, no necesitarás tanto tráfico ni exposición.
  • Los sitios de segmentación representan diferentes temas: Elige sitios web que representen diferentes categorías (por ejemplo, uno sobre deportes, otro sobre noticias y otro sobre comidas y bebidas). Puedes usar la herramienta de temas internos en Chrome para validar los 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:

  • Un array vacío de temas [], si esta es la primera llamada de este dispositivo, para este sitio y llamador 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 para el usuario, calculados a partir de los nombres de host de las páginas en las que el llamador observó los temas durante esa semana.
  • 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 mostrará los mismos temas durante toda una época. Esto ayuda a evitar exponer demasiados de los 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:

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

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

Escalamiento 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 esperaba, es momento de escalar esta implementación. Implementar el mismo código en más sitios web objetivo Esto te permitirá observar a más usuarios, recopilar más datos de temas y profundizar tu comprensión de tus públicos.

Este es 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 datos de temas (tiempo estimado: alrededor de cuatro semanas)
    • Incorporar los datos de temas como un indicador aditivo junto con otros datos
    • Busca socios de pruebas de ofertas en tiempo real.
    • Ejecuta pruebas de utilidad con temas como un indicador adicional a tus otros datos.

Pruebas de carga

Para asegurarte de que tu sistema pueda manejar el tráfico, recomendamos realizar pruebas de carga antes de implementar tu solución basada en temas para las .

  1. Realiza la implementación gradualmente en más sitios de destino de tu propiedad, en especial en aquellos que tienen un volumen mayor de tráfico.
  2. Realiza pruebas de carga de tus datos de temas según el tráfico esperado.
    • Deberás enviar 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 seleccionar los anuncios que sean más relevantes para el usuario. A medida que más sitios incorporen tu incorporación, la cantidad de llamadas a tu backend aumentará de forma significativa. Confirma que tu backend puede 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 si hay algún problema grave del usuario final. Sigue revisando tus métricas con regularidad.
  4. Si ocurre una interrupción o un 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.