Topsort mit Auftragsverwaltungssystemen verbinden
Auftragsverwaltungssysteme (OMS) wie Vantage, Boostr, ADvendio und Placements.io helfen Einzelhändlern bei der Verwaltung von Kampagnenplanung, Buchung und Inventar. Sie können diese Systeme mit den APIs von Topsort integrieren, um die Erstellung und Verwaltung von Kampagnen zu automatisieren.
Dieser Leitfaden zeigt, wie Sie OMS mit Topsort unter Verwendung bestehender APIs für automatisierte Kampagnen-Workflows integrieren.
Workflows
Die OMS-Integration umfasst drei Haupt-Workflows für unterschiedliche Rollen und Zeitpunkte:
| Workflow | Wer | Wann | Ziel |
|---|---|---|---|
| Implementierungsleitfaden | DevOps/Integrationsteam | Einmalige Einrichtung | Automatisierte OMS ↔ Topsort-Synchronisation einrichten |
| Kampagnenerstellung | Kampagnenmanager/Vertriebsteams | Pro Kampagne | Kampagnen automatisch aus OMS-Daten erstellen |
| Leistungssynchronisation | Marketingteams | Fortlaufend | Kampagnenleistung in OMS-Dashboards abrufen |
Wie OMS-Integration funktioniert
- Kampagnenplanung: Vertriebsteams planen Kampagnen in ihrer OMS-Oberfläche
- Automatisierte Erstellung: OMS sendet Kampagnendaten über API-Aufrufe an Topsort
- Echtzeit-Updates: Webhook-Benachrichtigungen halten Systeme synchronisiert
- Einheitliche Berichterstattung: Leistungsdaten fließen zurück zu OMS-Dashboards
Implementierungsbeispiel
Kampagnenerstellung aus OMS-Daten
Rolle: Kampagnenmanager/Vertriebsteams | Häufigkeit: Pro Kampagne
Webhook-Integration für Echtzeit-Updates
API-Referenz
Aktuelle Topsort-APIs für Integration
| API | Integrations-Anwendungsfall | Status | Dokumentation |
|---|---|---|---|
| Campaign API | Kampagnen mit Gebotsstrategie, Budget, Targeting erstellen | ✅ Verfügbar | Vollständiges Kampagnen-Lebenszyklusmanagement |
| Assets API | Asset-URLs in Kampagnen referenzieren | ✅ Verfügbar | Asset- und Sammlungsverwaltung |
| Reporting API | Leistungsdaten zu OMS/Dashboards abrufen | ✅ Verfügbar | Kampagnen-, Anbieter-, Marketplace-Berichte |
| Auctions API | Auktions- und Gebotsparameter konfigurieren | ✅ Verfügbar | Auktionskonfiguration |
Authentifizierung
Massen-Kampagnenoperationen
Abrufen von Leistungsdaten für OMS-Dashboards
Rolle: Marketingteams | Häufigkeit: Fortlaufend/Geplant
Best Practices
Datensynchronisation
- Feldzuordnung: Ordnen Sie OMS-Kampagnenfelder den Topsort-API-Parametern zu
- Datenvalidierung: Validieren Sie Kampagnendaten vor dem Senden an Topsort-APIs
- Massenoperationen: Verwenden Sie Batch-Verarbeitung für unternehmensweites Kampagnenmanagement
Fehlerbehandlung
- Wiederholungslogik: Implementieren Sie exponentiellen Backoff für fehlgeschlagene API-Aufrufe
- Umfassende Protokollierung: Verfolgen Sie alle API-Interaktionen und -Fehler
- Gesundheitsüberwachung: Richten Sie Benachrichtigungen für Integrationsprobleme ein
Sicherheit
- API-Schlüsselverwaltung: Speichern Sie API-Schlüssel sicher und rotieren Sie sie regelmäßig
- Rate Limiting: Beachten Sie API-Rate-Limits, um Throttling zu vermeiden
- Eingabebereinigung: Validieren Sie alle Daten vor dem Senden an APIs
Implementierungsleitfaden
1
API-Zugriff einrichten
Erhalten Sie Topsort-API-Schlüssel und konfigurieren Sie die Authentifizierung:
- Fordern Sie einen erweiterten API-Schlüssel von Ihrem Topsort-Vertreter an
- Speichern Sie API-Schlüssel sicher in Ihren Umgebungsvariablen
- Konfigurieren Sie Authentifizierungs-Header für alle API-Aufrufe
2
Webhooks konfigurieren
Richten Sie Webhook-Endpunkte für Echtzeit-Kampagnen-Updates ein:
- Erstellen Sie einen Webhook-Endpunkt in Ihrem OMS-System
- Registrieren Sie die Webhook-URL bei Topsort für Kampagnenereignisse
- Implementieren Sie Handler für Kampagnenerstellungs-/Aktualisierungs-/Löschereignisse
3
Datenfeldzuordnung
Ordnen Sie OMS-Kampagnenfelder den Topsort-API-Parametern zu:
- Dokumentieren Sie Feldzuordnungen zwischen Systemen
- Implementieren Sie Datentransformationslogik
- Validieren Sie, dass erforderliche Felder vorhanden sind
4
Fehlerbehandlung implementieren
Erstellen Sie umfassende Fehlerbehandlung und Wiederholungslogik:
- Implementieren Sie exponentiellen Backoff für fehlgeschlagene API-Aufrufe
- Fügen Sie umfassende Protokollierung für Debugging hinzu
- Richten Sie Benachrichtigungen für Integrationsfehler ein
5
Tests und Validierung
Testen Sie die Integration mit Sandbox-Daten vor der Produktion:
- Erstellen Sie Test-Kampagnen über den OMS-Workflow
- Überprüfen Sie, dass Kampagnen korrekt in Topsort erscheinen
- Testen Sie Webhook-Zustellung und -Verarbeitung
6
Überwachung und Wartung
Richten Sie kontinuierliche Überwachung für die Integration ein:
- Verfolgen Sie Erfolgs-/Fehlerquoten von API-Aufrufen
- Überwachen Sie die Leistung der Kampagnenerstellung
- Richten Sie Dashboards für Integrationsgesundheit ein
Verwandte Ressourcen
- DAM-Integrationsleitfaden - Digital Asset Management-Konnektivität
- Campaign API-Dokumentation
- Reporting API-Dokumentation
Bereit, Ihr OMS mit Topsort zu integrieren? Kontaktieren Sie Ihren Account-Vertreter, um mit API-Zugriff und Implementierungsunterstützung zu beginnen.
Zuletzt aktualisiert: