Conexión de Topsort con sistemas de gestión de pedidos
Los sistemas de gestión de pedidos (OMS), como Vantage, Boostr, ADvendio y Placements.io, ayudan a los minoristas a gestionar la planificación de campañas, las reservas y el inventario. Puede integrar estos sistemas con las API de Topsort para automatizar la creación y gestión de campañas.
Esta guía muestra cómo integrar OMS con Topsort utilizando las API existentes para flujos de trabajo de campañas automatizadas.
Flujos de trabajo
La integración del OMS implica tres flujos de trabajo principales para diferentes roles y momentos:
| Flujo de trabajo | Quién | Cuándo | Objetivo |
|---|---|---|---|
| Guía de implementación | Equipo de DevOps/Integración | Configuración única | Establecer sincronización automatizada de OMS ↔ Topsort |
| Creación de campañas | Gestores de campañas/Equipos de ventas | Por campaña | Crear campañas automáticamente a partir de datos de OMS |
| Sincronización de rendimiento | Equipos de marketing | En curso | Incorporar el rendimiento de las campañas a los paneles de OMS |
Cómo funciona la integración de OMS
- Planificación de campañas: Los equipos de ventas planifican las campañas en su interfaz OMS.
- Creación automatizada: OMS envía datos de campaña a Topsort mediante llamadas a API.
- Actualizaciones en tiempo real: Las notificaciones de webhook mantienen los sistemas sincronizados.
- Informes unificados: Los datos de rendimiento se envían de vuelta a los paneles de control de OMS.
Ejemplo de implementación
Creación de campañas a partir de datos de OMS
Rol: Gestores de campañas/Equipos de ventas | Frecuencia: Por campaña
Integración de webhook para actualizaciones en tiempo real
Referencia API
API Topsort actuales para la integración
| API | Caso de uso de integración | Estado | Documentación |
|---|---|---|---|
| Campaña api | Crea campañas con estrategia de puja, presupuesto y segmentación | ✅ Disponible | Gestión completa del ciclo de vida de la campaña |
| Recursos api | URL de referencia de recursos en campañas | ✅ Disponible | Gestión y colecciones de recursos |
| Informes api | Obtener datos de rendimiento para OMS/paneles de control | ✅ Disponible | Informes de campaña, proveedor y marketplace |
| Subastas api | Configurar parámetros de subasta y pujas | ✅ Disponible | Configuración de subastas |
Autenticación
Operaciones de campaña masivas
Recuperación de datos de rendimiento para paneles de control de OMS
Rol: Equipos de Marketing | Frecuencia: Continua/Programada
Mejores prácticas
Sincronización de datos
- Asignación de campos: Asigne los campos de campaña de OMS a los parámetros Topsort y API.
- Validación de datos: Validar los datos de la campaña antes de enviarlos a las API de Topsort
- Operaciones masivas: Utilice el procesamiento por lotes para la gestión de campañas a escala empresarial.
Manejo de errores
- Lógica de reintento: Implementar un retroceso exponencial para las llamadas fallidas a API
- Registro completo: Seguimiento de todas las interacciones y fallos de API
- Monitoreo de salud: Configurar alertas para problemas de integración
Seguridad
- Gestión de claves API: Almacene las claves API de forma segura y rótelas periódicamente.
- Limitación de velocidad: Respete los límites de velocidad de API para evitar la limitación de ancho de banda.
- Sanitización de entrada: Validar todos los datos antes de enviarlos a las API.
Guía de implementación
1
API Configuración de acceso
Obtenga las claves Topsort y API y configure la autenticación:
- Solicite la clave avanzada API a su representante de Topsort
- Almacena las claves API de forma segura en tus variables de entorno
- Configurar los encabezados de autenticación para todas las llamadas a API
2
Configuración de webhook
Configura los endpoints de webhook para actualizaciones de campaña en tiempo real:
- Crea un punto de conexión webhook en tu sistema OMS
- Registra el webhook URL con Topsort para eventos de campaña
- Implementar controladores para eventos de creación/actualización/eliminación de campañas
3
Asignación de campos de datos
Asignar los campos de la campaña de OMS a los parámetros Topsort y API:
- Asignación de campos de documentos entre sistemas
- Implementar la lógica de transformación de datos
- Verificar que los campos obligatorios estén presentes
4
Implementación del manejo de errores
Implemente una lógica integral de manejo de errores y reintentos:
- Implementar retroceso exponencial para llamadas fallidas a API
- Agregar registro completo para depuración
- Configurar alertas para fallos de integración
5
Pruebas y validación
Prueba la integración con datos de prueba antes de la producción:
- Crear campañas de prueba mediante el flujo de trabajo de OMS
- Verificar que las campañas aparezcan correctamente en Topsort
- Prueba de entrega y manejo de webhooks
6
Monitoreo y mantenimiento
Establecer un sistema de monitoreo continuo para la integración:
- Seguimiento de las tasas de éxito/fracaso de las llamadas a API
- Supervisar el rendimiento de la creación de campañas
- Configurar paneles de control para el estado de la integración
Recursos relacionados
- Guía de integración de DAM - Conectividad de gestión de activos digitales
- Documentación de la campaña api
- Documentación de informes api
¿Listo para integrar su OMS con Topsort? Póngase en contacto con su representante de cuenta para comenzar con el acceso a API y el soporte de implementación.
Last updated: