Passer au contenu principal

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.
Diagramme montrant la connectivité OMS

Flux de Travail

L’intégration OMS implique trois flux de travail principaux pour différents rôles et moments :
Flux de TravailQuiQuandObjectif
Guide d’ImplémentationÉquipe DevOps/IntégrationConfiguration uniqueÉtablir une synchronisation automatisée OMS ↔ Topsort
Création de CampagnesGestionnaires de Campagnes/Équipes CommercialesPar campagneCréer des campagnes automatiquement à partir des données OMS
Synchronisation des PerformancesÉquipes MarketingEn continuExtraire les performances de campagne dans les tableaux de bord OMS

Comment Fonctionne l’Intégration OMS

  1. Planification de Campagne : Les équipes commerciales planifient les campagnes dans leur interface OMS
  2. Création Automatisée : L’OMS envoie les données de campagne à Topsort via des appels API
  3. Mises à Jour en Temps Réel : Les notifications webhook maintiennent les systèmes synchronisés
  4. Rapports Unifiés : Les données de performance retournent aux tableaux de bord OMS
Avantage Entreprise : L’intégration OMS élimine la configuration manuelle des campagnes, réduisant les erreurs et permettant aux équipes commerciales de gérer les campagnes à grande échelle sans apprendre de nouveaux outils.

Exemple d’Implémentation

Création de Campagnes à Partir de Données OMS

Rôle : Gestionnaires de Campagnes/Équipes Commerciales | Fréquence : Par campagne
// Données de campagne de votre OMS
const campaignData = {
  name: "Q4 Holiday Campaign - Brand X",
  budget: 15000,
  startDate: "2024-11-01",
  endDate: "2024-12-31",
  biddingStrategy: "target_roas",
  targetRoas: 4.5,
  vendorId: "vendor-123",
};

// Créer une campagne dans Topsort
const response = await fetch("https://api.topsort.com/v2/campaigns", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name: campaignData.name,
    type: "sponsored_products",
    vendor_id: campaignData.vendorId,
    bidding_strategy: campaignData.biddingStrategy,
    target_roas: campaignData.targetRoas,
    budget: {
      amount: campaignData.budget,
      currency: "USD",
      period: "lifetime",
    },
    start_date: campaignData.startDate,
    end_date: campaignData.endDate,
  }),
});

const campaign = await response.json();

Intégration Webhook pour les Mises à Jour en Temps Réel

// Configurer un webhook pour recevoir les mises à jour de campagne
const webhookPayload = {
  url: "https://your-oms.com/webhooks/topsort",
  events: ["campaign:create", "campaign:update", "campaign:delete"],
};

await fetch("https://api.topsort.com/v2/webhooks", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify(webhookPayload),
});

// Gérer le webhook dans votre OMS
app.post("/webhooks/topsort", (req, res) => {
  const { channel, payload } = req.body;

  switch (channel) {
    case "campaign:create":
      updateOMSCampaignStatus(payload.campaign_id, "active");
      break;
    case "campaign:update":
      syncCampaignData(payload);
      break;
  }

  res.status(200).send("OK");
});

Référence API

API Topsort Actuelles pour l’Intégration

APICas d’Utilisation de l’IntégrationStatutDocumentation
API CampaignCréer des campagnes avec stratégie d’enchères, budget, ciblage✅ DisponibleGestion complète du cycle de vie des campagnes
API AssetsRéférencer les URL d’actifs dans les campagnes✅ DisponibleGestion des actifs et collections
API ReportingExtraire les données de performance vers OMS/tableaux de bord✅ DisponibleRapports de campagnes, vendeurs, marketplace
API AuctionsConfigurer les paramètres d’enchères et d’offre✅ DisponibleConfiguration des enchères

Authentification

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Opérations de Campagnes en Masse

// Créer plusieurs campagnes à partir d'un lot OMS
async function createBulkCampaigns(campaignsList) {
  const results = [];

  for (const campaignData of campaignsList) {
    try {
      const response = await fetch("https://api.topsort.com/v2/campaigns", {
        method: "POST",
        headers: {
          Authorization: "Bearer YOUR_API_KEY",
          "Content-Type": "application/json",
        },
        body: JSON.stringify(campaignData),
      });

      const campaign = await response.json();
      results.push({ success: true, campaign });
    } catch (error) {
      results.push({ success: false, error: error.message });
    }
  }

  return results;
}

Récupération des Données de Performance pour les Tableaux de Bord OMS

Rôle : Équipes Marketing | Fréquence : En continu/Planifié
// Extraire les performances de campagne vers l'OMS
async function syncPerformanceData(campaignId) {
  const reportResponse = await fetch(
    `https://api.topsort.com/v2/reports/campaigns/${campaignId}`,
    {
      method: "GET",
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
      },
    }
  );

  const performanceData = await reportResponse.json();

  // Mettre à jour le tableau de bord OMS avec les métriques de performance
  await updateOMSDashboard(campaignId, {
    impressions: performanceData.impressions,
    clicks: performanceData.clicks,
    spend: performanceData.spend,
    conversions: performanceData.conversions,
  });
}

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é

Exigences de Sécurité : Les intégrations OMS gèrent des données de campagnes et financières sensibles. Assurez une authentification appropriée, la validation des données et une gestion sécurisée des clés API.
  • 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


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: