Connexion de Topsort avec les Systèmes de Gestion des Actifs Numériques
Les systèmes de Gestion des Actifs Numériques (DAM) comme Adobe Experience Manager
Assets, Bynder et d’autres centralisent les actifs créatifs et génèrent des
URL optimisées pour l’utilisation dans les campagnes. Contrairement à la connectivité OMS, la connectivité DAM est actuellement
réalisable avec les API existantes de Topsort.
Ce guide explique comment intégrer les API de Topsort avec les systèmes DAM pour
des flux de travail créatifs rationalisés et une gestion automatisée des actifs.
Comment les Systèmes DAM Fonctionnent avec Topsort
Les systèmes DAM comme Adobe Experience Manager Assets, Bynder ou Webdam :
- Centralisent les Actifs : Stockent toutes les bannières, images de produits, vidéos dans un référentiel organisé
- Génèrent des URL CDN : Créent des URL optimisées et accessibles publiquement pour chaque actif
- Gèrent les Versions : Suivent les versions approuvées et empêchent l’utilisation d’actifs obsolètes
- Contrôlent la Conformité de la Marque : Garantissent que seuls les actifs approuvés et conformes à la marque atteignent les campagnes
Flux de Travail
L’intégration DAM implique quatre flux de travail distincts 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 DAM ↔ Topsort |
| Flux de Travail UI | Vendeurs/Admins de Marketplace | Par campagne | Créer des campagnes de bannières via le tableau de bord avec des URL DAM |
| Flux de Travail API | Gestionnaires de Campagnes/Annonceurs | Par campagne | Créer des campagnes de bannières de manière programmatique en utilisant des actifs DAM |
| Enchère & Affichage | Développeurs de Marketplace | À chaque chargement de page | Afficher les bannières gagnantes aux utilisateurs |
Création de Campagnes de Bannières avec des Actifs DAM
Flux de Travail UI
Rôle : Vendeurs/Admins de Marketplace | Fréquence : Par configuration de campagne
**
**

Pour créer des campagnes de bannières avec des URL DAM externes via la Plateforme
Publicitaire, consultez le
guide complet des Campagnes de Bannières Publicitaires
qui
montre le processus UI étape par étape, y compris comment référencer des URL externes dans
la configuration de campagne.
Flux de Travail API : Création Complète de Campagne Bannière
Rôle : Gestionnaires de Campagnes/Annonceurs | Fréquence : Par configuration de campagne
1
Créer un Actif avec une URL DAM
Tout d’abord, créez un actif dans Topsort qui référence votre URL DAM :
2
Créer une Campagne de Bannière en Utilisant l'Actif
Ensuite, créez une campagne de bannière qui référence l’actif que vous venez de créer :
Réponse d’Enchère avec URL DAM
Rôle : Développeurs de Marketplace | Fréquence : À chaque chargement de page
1
Exécuter une Enchère pour un Emplacement de Bannière
Demandez une enchère pour l’emplacement de bannière où votre campagne basée sur DAM peut concourir :
2
Recevoir l'URL DAM dans la Réponse
Lorsque votre campagne de bannière gagne, la réponse d’enchère inclut l’URL DAM originale :
3
Afficher la Bannière avec l'Actif DAM
Utilisez l’URL retournée pour afficher la bannière et suivre les performances :
Avantages Clés de l’Intégration DAM
- Cohérence de la Marque : Seuls les actifs approuvés et conformes atteignent les campagnes publicitaires - Efficacité du Flux de Travail : Les équipes créatives travaillent dans des outils DAM familiers, les actifs se synchronisent automatiquement - Contrôle de Version : Lorsque les créations sont mises à jour dans le DAM, les actifs de campagne se mettent à jour automatiquement - Gestion des Droits : Suivez les licences d’utilisation et empêchez l’utilisation d’actifs expirés - Distribution Mondiale des Actifs : Un référentiel d’actifs unique sert plusieurs canaux marketing
Guide d’Implémentation
Rôle : Équipe DevOps/Intégration | Fréquence : Configuration unique
1
Préparation du Système DAM
Configurez votre système DAM pour une connectivité optimale avec Topsort :
- Organisation des Actifs : Structurez les actifs avec des dossiers et métadonnées spécifiques aux campagnes
- Configuration CDN : Assurez-vous que le DAM génère des URL optimisées et accessibles publiquement
- Flux de Travail d’Approbation : Configurez des processus pour marquer les actifs comme prêts pour les campagnes
- Normes de Métadonnées : Définissez un balisage cohérent pour les dimensions, versions, dates d’expiration
2
Configuration de l'API Assets Topsort
Configurez la connectivité entre votre DAM et Topsort :
- Authentification : Configurez les identifiants de l’API Topsort
- Validation des URL : Assurez-vous que les URL DAM sont accessibles aux systèmes Topsort
- Synchronisation Automatisée : Configurez des webhooks ou des tâches planifiées pour synchroniser les actifs approuvés
- Gestion des Erreurs : Implémentez une logique de nouvelle tentative pour les références d’actifs échouées
3
Automatisation du Flux de Travail
Implémentez la synchronisation automatisée des actifs :
Référence API
API Topsort pour l’Intégration DAM
| API | Cas d’Utilisation de l’Intégration | Statut | Documentation |
|---|---|---|---|
| API Assets | Référencer des URL DAM dans les campagnes | ✅ Disponible | Gestion des actifs et collections |
| API Campaign | Créer des campagnes avec des actifs DAM | ✅ Disponible | Gestion complète du cycle de vie des campagnes |
Authentification
Meilleures Pratiques
Gestion des Actifs
- Optimiser les URL : Assurez-vous que le DAM génère des URL optimisées pour un chargement rapide via CDN - Contrôle de Version : Implémentez un versionnage clair pour éviter les actifs obsolètes dans les campagnes - Normes de Métadonnées : Utilisez un balisage cohérent pour les dimensions, types de campagnes, statut d’approbation - Contrôle d’Accès : Assurez-vous que les URL d’actifs sont accessibles publiquement aux systèmes Topsort
Automatisation du Flux de Travail
- Portes d’Approbation : Synchronisez uniquement les actifs approuvés et conformes à la marque vers Topsort - Nettoyage Automatisé : Supprimez les actifs expirés ou obsolètes des campagnes actives
- Surveillance des Erreurs : Suivez les références d’actifs échouées et les problèmes de synchronisation
Dépannage
Problèmes Courants d’Intégration DAM
- Problèmes d’URL d’Actifs
- Vérifiez que les URL DAM sont accessibles publiquement (pas derrière une authentification) - Vérifiez que les URL retournent des codes de statut HTTP appropriés (200) - Assurez-vous que les URL CDN sont optimisées pour un chargement rapide - Validez que les dimensions des actifs correspondent aux exigences de Topsort
- Échecs de Synchronisation
- Vérifiez l’authentification API et les permissions - Vérifiez la compatibilité du format des métadonnées des actifs
- Surveillez les taux de succès de livraison des webhooks - Implémentez une journalisation appropriée des erreurs pour les synchronisations échouées
- Problèmes de Contrôle de Version - Assurez-vous que les actifs mis à jour déclenchent des mises à jour des actifs de campagne
- Vérifiez que les actifs expirés sont supprimés des campagnes actives - Vérifiez que seules les versions d’actifs approuvées se synchronisent avec Topsort
Problèmes Généraux d’API
- Échecs d’Authentification
- Vérifiez la validité de la clé API et les permissions de portée - Vérifiez le format de l’en-tête d’authentification
- Surveillez l’expiration des jetons
- Limitation de Débit - Implémentez une limitation de débit appropriée dans le code de connectivité - Utilisez des opérations groupées lorsque disponibles - Ajoutez une logique de nouvelle tentative avec backoff exponentiel
Démarrage
Étapes d’Implémentation
- Évaluation : Examinez la génération d’URL et les capacités API de votre système DAM actuel
- Identifiants API : Obtenez les clés API Topsort et configurez l’authentification
- Preuve de Concept : Commencez avec un petit ensemble d’actifs pour tester le flux de travail de connectivité
- Automatisation : Implémentez des processus de synchronisation automatisés pour les actifs approuvés
- Surveillance : Configurez le suivi pour le succès de la synchronisation des actifs et les performances des campagnes
Ressources Associées
- Guide d’Intégration OMS - Connectivité Order Management System - Documentation de l’API Assets - Documentation de l’API Campaign
Cette documentation reflète les capacités actuelles de l’API Topsort. La connectivité DAM
est disponible maintenant en utilisant les API existantes. Pour le développement de connectivité personnalisée,
veuillez contacter votre représentant Topsort.
Last updated: