Saltar al contenido principal
Antes de pasar a producción, realice Pruebas de Aceptación del Usuario (UAT) exhaustivas para asegurar una transición fluida. Esta guía le guiará a través de la preparación previa al lanzamiento, procedimientos de prueba, pasos de implementación y monitoreo posterior al lanzamiento.
Su proceso de puesta en producción puede variar dependiendo de su ruta de integración y formatos de anuncios. Esta guía cubre los escenarios más comunes, pero su implementación específica puede diferir. Por ejemplo:
  • Sponsored Listings requieren integración completa del catálogo con datos de productos
  • Banner Ads pueden requerir solo configuración de proveedor/anunciante sin catálogo a nivel de producto
  • Configuraciones de ubicación varían según sus opciones de formato de anuncio
Trabaje con su contacto de Topsort para confirmar qué secciones aplican a su integración.

​
Lista de Verificación Previa al Lanzamiento

​
Configuración Común (Todos los Formatos de Anuncios)

Credenciales API:
  • Las claves API de sandbox están configuradas correctamente
  • Las claves API de producción están listas (no cambiar todavía)
  • Las claves API están almacenadas de forma segura en variables de entorno
  • El proceso de rotación de claves está documentado
Configuración de Entorno:
  • El entorno de staging refleja la configuración de producción
  • Todos los endpoints de API están configurados correctamente
  • Los valores de timeout son apropiados (recomendado: 500-1000ms)
  • El manejo de errores está implementado
Visualización de Anuncios:
  • Las ubicaciones de anuncios se renderizan correctamente en todos los tipos de dispositivos
  • Las etiquetas de anuncios son claramente visibles (ver directrices de etiquetado abajo)
  • Las imágenes/creativos de anuncios se cargan correctamente con respaldos
  • El comportamiento de clic funciona según lo esperado
Rendimiento:
  • Los tiempos de carga de página son aceptables con anuncios
  • Los anuncios no bloquean el renderizado crítico de página
  • La experiencia móvil está optimizada (objetivos táctiles, diseños responsivos, tiempos de carga rápidos)
  • Se cumplen los requisitos de accesibilidad
Instrumentación:
  • El seguimiento de errores está configurado (Sentry, Datadog, etc.)
  • El monitoreo de rendimiento está en su lugar
  • Los dashboards personalizados están configurados
  • Los umbrales de alerta están definidos
Registro:
  • El registro de solicitudes/respuestas API está habilitado
  • Los registros de errores están siendo capturados
  • La pista de auditoría para eventos de anuncios está configurada
  • Las políticas de retención de registros están establecidas

​
Directrices de Etiquetado de Anuncios

Etiquetas Recomendadas

Use etiquetas que indiquen claramente contenido promocional evitando activar bloqueadores de anuncios:
  • “Destacado”
  • “Recomendado”
  • “Elección del Cliente”
  • “Mejor Selección”
Evite usar “Patrocinado” o “Anuncio” ya que estos términos son comúnmente objetivo de bloqueadores de anuncios.

Clientes Europeos (Cumplimiento DSA)

Si opera en la Unión Europea, la Ley de Servicios Digitales (DSA) requiere:
  • Etiquetado claro de que el contenido es un anuncio
  • Visualización del nombre del anunciante en los detalles del anuncio
  • Transparencia sobre por qué se mostró el anuncio al usuario
Trabaje con su equipo legal para asegurar el cumplimiento completo de DSA.

​
Pruebas de Aceptación del Usuario (UAT)

​
2. Pruebas de Subastas y Eventos

Probar con Dos Usuarios Diferentes: Realice todas las pruebas con al menos dos sesiones de usuario únicas para verificar el seguimiento y atribución apropiados del usuario.

​
3. Validación de Datos

1

Capturar Evidencia de Prueba

Para Cada Usuario de Prueba:
  • Tome capturas de pantalla de ubicaciones de anuncios
  • Capture solicitudes de red mostrando llamadas API
  • Documente detalles de pedidos para eventos de compra (si aplica)
  • Anote marcas de tiempo para cada acción
2

Enviar a Topsort

Envíe lo siguiente a su contacto de Topsort:
  • Capturas de pantalla de impresiones de anuncios
  • Registros de red mostrando llamadas de subasta y eventos
  • Nombre de campaña de prueba y rango de tiempo
  • Identificadores de usuario usados en las pruebas
3

Revisar Resumen de Datos

Topsort proporcionará un resumen incluyendo:
  • Total de subastas recibidas
  • Conteos de impresiones y clics
  • Conteos de compras (para integraciones de anuncios de listados)
  • Puntuación de calidad de datos
  • Cualquier discrepancia o problema de datos
Verificar Alineación:
  • Los números coinciden con sus acciones de prueba
  • La cadena de atribución está completa
  • No hay eventos faltantes o duplicados

​
Implementación en Producción

​
Pasos de Implementación

1

Conectar Catálogo de Producción

2

Obtener Credenciales de Producción

Usando Topsort UI:
  1. Topsort proporciona credenciales de panel de administración
  2. Usted recibe URL de API de producción
  3. Genere claves API en admin
  4. Almacene claves de forma segura en entorno de producción
Usando UI Personalizada:
  1. Reciba URL de API de producción de Topsort
  2. Reciba clave(s) API de producción
  3. Configure claves en su entorno
Nunca comprometa claves API al control de versiones. Use variables de entorno o sistemas de gestión de secretos seguros.
3

Implementar Código de Integración

Pre-Implementación:
  • Revise todos los cambios de código una última vez
  • Asegúrese de que las credenciales de sandbox estén parametrizadas
  • Confirme que el procedimiento de rollback esté documentado
  • Programe la implementación durante período de bajo tráfico
Proceso de Implementación:
  1. Implemente código en entorno de producción
  2. Actualice variables de entorno con credenciales de producción
  3. Reinicie servicios para tomar nueva configuración
  4. Verifique que la aplicación inicie exitosamente
Verificación Inmediata:
  • Verifique registros de aplicación para errores
  • Pruebe funcionalidad básica (cargas de página)
  • Verifique conectividad API

​
Estrategia de Aumento de Tráfico

Despliegue Gradual

Enfoque Recomendado:Día 1-2: 10% del tráfico
  • Monitoree de cerca para errores
  • Valide precisión de datos
  • Verifique métricas de rendimiento
Día 3-5: 50% del tráfico
  • Compare métricas con línea base
  • Asegure estabilidad del sistema
  • Ajuste si es necesario
Día 6+: 100% del tráfico
  • Lanzamiento completo en producción
  • Continue monitoreando
  • Optimice rendimiento

Feature Flags

Use Feature Flags para Controlar:
  • Qué ubicaciones muestran anuncios
  • Porcentaje de usuarios viendo anuncios
  • Configuraciones de pruebas A/B
  • Interruptor de emergencia
Beneficios:
  • Rollback instantáneo sin implementación
  • Control de despliegue gradual
  • Configuración por ubicación
  • Riesgo de implementación reducido

​
Monitoreo Post-Lanzamiento

​
Métricas Críticas a Monitorear

Rendimiento API:
  • Tiempo de respuesta de Auction API (objetivo: <500ms p95)
  • Tasa de éxito de Event API (objetivo: >99.5%)
  • Tasas y tipos de errores
  • Frecuencia de timeout de API
Rendimiento de Aplicación:
  • Impacto en tiempo de carga de página
  • Tiempo hasta primer renderizado de anuncio
  • Errores de JavaScript
  • Patrones de uso de memoria
Elementos de Acción si se Detectan Problemas:
  • Tiempo de respuesta >1s: Revisar configuraciones de timeout
  • Tasa de error >1%: Verificar credenciales API y red
  • Errores JS altos: Revisar implementación del lado del cliente
Seguimiento de Eventos:
  • Ratio de impresión a clic (típico: 1-5%)
  • Ratio de clic a compra (típico: 2-10%, para anuncios de listados)
  • Consistencia de volumen de eventos
  • Completitud de atribución
Integridad de Datos:
  • Los IDs de usuario están presentes y son consistentes
  • Los resolvedBidIds están capturados para impresiones y clics
  • Los montos de compra son razonables (anuncios de listados)
  • Los eventos duplicados son mínimos
Verificaciones de Dashboard:
  • Compare dashboard de Topsort con sus análisis
  • Verifique que la atribución de ingresos coincida
  • Verifique brechas o picos de datos
Rendimiento de Campaña:
  • Total de impresiones entregadas
  • Tasa de clic (CTR)
  • Tasa de conversión (anuncios de listados)
  • Retorno de inversión publicitaria (ROAS)
Experiencia de Usuario:
  • Tasas de visualización de anuncios
  • Compromiso de usuario con anuncios
  • Impacto en tasa de conversión orgánica
  • Cambios en tasa de rebote de página
Impacto en Ingresos:
  • Ingresos incrementales de anuncios
  • Cambios en valor promedio de pedido
  • Tasa de adopción de proveedores
  • Velocidad de creación de campañas

​
Solución de Problemas Comunes

No se Muestran Productos

Causas Posibles:
  • No hay campañas activas
  • Montos de puja demasiado bajos
  • Targeting de productos demasiado estrecho
  • Errores de Auction API
Pasos de Depuración:
  1. Verifique la consola del navegador para errores
  2. Verifique respuesta de Auction API
  3. Confirme que las campañas estén activas
  4. Revise criterios de targeting

Eventos de Compra Faltantes

Causas Posibles:
  • Evento no activado en checkout
  • ID de usuario faltante en payload del evento
  • Formato de ID de producto incorrecto
  • Fallas de red
Pasos de Depuración:
  1. Pruebe flujo de compra manualmente
  2. Verifique estructura de payload del evento
  3. Verifique que el ID de usuario esté incluido
  4. Revise registros del servidor

​
Mejores Prácticas

Comunicación

Coordinación Interna:
  • Notifique al equipo de ingeniería sobre la implementación
  • Alerte al soporte al cliente sobre nuevas características
  • Actualice al equipo de ventas sobre capacidades
Comunicación Externa:
  • Coordine con el equipo de Topsort
  • Programe llamadas de lanzamiento
  • Establezca rutas de escalación

Documentación

Mantener:
  • Runbooks de implementación
  • Procedimientos de rollback
  • Especificaciones de integración API
  • Guías de solución de problemas
Mantener Actualizado:
  • Cambios de configuración
  • Problemas conocidos y soluciones alternativas
  • Benchmarks de rendimiento

Optimización

Mejora Continua:
  • Revise rendimiento semanalmente
  • Optimice consultas lentas
  • Refine targeting
  • Pruebe nuevas ubicaciones
Pruebas A/B:
  • Posiciones de ubicación de anuncios
  • Número de anuncios por página
  • Formatos y estilos de anuncios
  • Estrategias de targeting

Soporte

Establecer:
  • Rotación de guardia
  • Proceso de respuesta a incidentes
  • Contactos de escalación de Topsort
  • Expectativas de SLA
Documentar:
  • Escenarios de soporte comunes
  • Procedimientos de resolución
  • Información de contacto
Una vez que esté en vivo, estará listo para comenzar a optimizar. Comuníquese con su contacto de Topsort para obtener orientación sobre estrategias de campaña, ajuste de atribución y configuraciones avanzadas.

¿Necesitas ayuda con tu integración de Topsort?

Habla con nosotros, el equipo de ingeniería de integraciones.Contáctanos a través de tu canal de mensajería dedicado o en support@topsort.com.Si aún no eres cliente, agenda una demo con nuestro equipo de ventas.