Connexion de Topsort avec les Systèmes de Gestion des Commandes
Les Systèmes de Gestion des Commandes (OMS) comme Vantage, Boostr, ADvendio et Placements.io aident les détaillants à gérer la planification, la réservation et l’inventaire des campagnes. Vous pouvez intégrer ces systèmes avec les API de Topsort pour automatiser la création et la gestion des campagnes.
Ce guide montre comment intégrer l’OMS avec Topsort en utilisant les API existantes pour des flux de travail de campagnes automatisés.
Flux de Travail
L’intégration OMS implique trois flux de travail principaux pour différents rôles et moments :
| Flux de Travail | Qui | Quand | Objectif |
|---|---|---|---|
| Guide d’Implémentation | Équipe DevOps/Intégration | Configuration unique | Établir une synchronisation automatisée OMS ↔ Topsort |
| Création de Campagnes | Gestionnaires de Campagnes/Équipes Commerciales | Par campagne | Créer des campagnes automatiquement à partir des données OMS |
| Synchronisation des Performances | Équipes Marketing | En continu | Extraire les performances de campagne dans les tableaux de bord OMS |
Comment Fonctionne l’Intégration OMS
- Planification de Campagne : Les équipes commerciales planifient les campagnes dans leur interface OMS
- Création Automatisée : L’OMS envoie les données de campagne à Topsort via des appels API
- Mises à Jour en Temps Réel : Les notifications webhook maintiennent les systèmes synchronisés
- Rapports Unifiés : Les données de performance retournent aux tableaux de bord OMS
Exemple d’Implémentation
Création de Campagnes à Partir de Données OMS
Rôle : Gestionnaires de Campagnes/Équipes Commerciales | Fréquence : Par campagne
Intégration Webhook pour les Mises à Jour en Temps Réel
Référence API
API Topsort Actuelles pour l’Intégration
| API | Cas d’Utilisation de l’Intégration | Statut | Documentation |
|---|---|---|---|
| API Campaign | Créer des campagnes avec stratégie d’enchères, budget, ciblage | ✅ Disponible | Gestion complète du cycle de vie des campagnes |
| API Assets | Référencer les URL d’actifs dans les campagnes | ✅ Disponible | Gestion des actifs et collections |
| API Reporting | Extraire les données de performance vers OMS/tableaux de bord | ✅ Disponible | Rapports de campagnes, vendeurs, marketplace |
| API Auctions | Configurer les paramètres d’enchères et d’offre | ✅ Disponible | Configuration des enchères |
Authentification
Opérations de Campagnes en Masse
Récupération des Données de Performance pour les Tableaux de Bord OMS
Rôle : Équipes Marketing | Fréquence : En continu/Planifié
Meilleures Pratiques
Synchronisation des Données
- Mappage de Champs : Mappez les champs de campagne OMS aux paramètres de l’API Topsort
- Validation des Données : Validez les données de campagne avant de les envoyer aux API Topsort
- Opérations en Masse : Utilisez le traitement par lots pour la gestion de campagnes à l’échelle de l’entreprise
Gestion des Erreurs
- Logique de Nouvelle Tentative : Implémentez un backoff exponentiel pour les appels API échoués
- Journalisation Complète : Suivez toutes les interactions API et les échecs
- Surveillance de la Santé : Configurez des alertes pour les problèmes d’intégration
Sécurité
- Gestion des Clés API : Stockez les clés API en toute sécurité et effectuez une rotation régulière
- Limitation de Débit : Respectez les limites de débit de l’API pour éviter la limitation
- Assainissement des Entrées : Validez toutes les données avant de les envoyer aux API
Guide d’Implémentation
1
Configuration de l'Accès API
Obtenez les clés API Topsort et configurez l’authentification :
- Demandez une clé API avancée à votre représentant Topsort
- Stockez les clés API en toute sécurité dans vos variables d’environnement
- Configurez les en-têtes d’authentification pour tous les appels API
2
Configuration des Webhooks
Configurez les points de terminaison webhook pour les mises à jour de campagne en temps réel :
- Créez un point de terminaison webhook dans votre système OMS
- Enregistrez l’URL du webhook avec Topsort pour les événements de campagne
- Implémentez des gestionnaires pour les événements de création/mise à jour/suppression de campagne
3
Mappage des Champs de Données
Mappez les champs de campagne OMS aux paramètres de l’API Topsort :
- Documentez les mappages de champs entre les systèmes
- Implémentez la logique de transformation des données
- Validez que les champs requis sont présents
4
Implémentation de la Gestion des Erreurs
Construisez une gestion complète des erreurs et une logique de nouvelle tentative :
- Implémentez un backoff exponentiel pour les appels API échoués
- Ajoutez une journalisation complète pour le débogage
- Configurez des alertes pour les échecs d’intégration
5
Tests et Validation
Testez l’intégration avec des données sandbox avant la production :
- Créez des campagnes de test via le flux de travail OMS
- Vérifiez que les campagnes apparaissent correctement dans Topsort
- Testez la livraison et la gestion des webhooks
6
Surveillance et Maintenance
Configurez une surveillance continue pour l’intégration :
- Suivez les taux de succès/échec des appels API
- Surveillez les performances de création de campagnes
- Configurez des tableaux de bord pour la santé de l’intégration
Ressources Associées
- Guide d’Intégration DAM - Connectivité Digital Asset Management
- Documentation de l’API Campaign
- Documentation de l’API Reporting
Prêt à intégrer votre OMS avec Topsort ? Contactez votre représentant de compte pour commencer avec l’accès API et le support d’implémentation.
Last updated: