Passer au contenu principal

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

Comment les Systèmes DAM Fonctionnent avec Topsort

Les systèmes DAM comme Adobe Experience Manager Assets, Bynder ou Webdam :
  1. Centralisent les Actifs : Stockent toutes les bannières, images de produits, vidéos dans un référentiel organisé
  2. Génèrent des URL CDN : Créent des URL optimisées et accessibles publiquement pour chaque actif
  3. Gèrent les Versions : Suivent les versions approuvées et empêchent l’utilisation d’actifs obsolètes
  4. 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 TravailQuiQuandObjectif
Guide d’ImplémentationÉquipe DevOps/IntégrationConfiguration uniqueÉtablir une synchronisation automatisée DAM ↔ Topsort
Flux de Travail UIVendeurs/Admins de MarketplacePar campagneCréer des campagnes de bannières via le tableau de bord avec des URL DAM
Flux de Travail APIGestionnaires de Campagnes/AnnonceursPar campagneCréer des campagnes de bannières de manière programmatique en utilisant des actifs DAM
Enchère & AffichageDéveloppeurs de MarketplaceÀ chaque chargement de pageAfficher 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
**
Début de la création du modèle de marques sponsorisées
**
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 :
const assetResponse = await fetch("https://api.topsort.com/v2/assets", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name: "Holiday Banner 728x90 - Approved v2",
    url: "https://dam-cdn.retailer.com/campaigns/holiday/banner-728x90-v2.jpg",
    dimensions: {
      width: 728,
      height: 90,
    },
    metadata: {
      approved: true,
      brand_compliant: true,
      expiry_date: "2024-12-31",
      version: "v2",
    },
  }),
});

const asset = await assetResponse.json();
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 :
const campaignResponse = await fetch("https://api.topsort.com/v2/campaigns", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name: "Holiday Banner Campaign",
    type: "banners",
    vendor_id: "vendor-123",
    bidding_strategy: "target_roas",
    target_roas: 4.5,
    budget: {
      amount: 5000,
      currency: "USD",
      period: "lifetime",
    },
    start_date: "2024-11-01",
    end_date: "2024-12-31",
    assets: [asset.id], // Référence l'actif créé
    slot_id: "homepage_banner_top",
  }),
});

const campaign = await campaignResponse.json();

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 :
const auctionResponse = await fetch("https://api.topsort.com/v2/auctions", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    auctions: [
      {
        type: "banners",
        slots: 1,
        slotId: "homepage_banner_top",
        device: "desktop",
      },
    ],
  }),
});

const auctionResult = await auctionResponse.json();
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 :
{
  "results": [
    {
      "winners": [
        {
          "rank": 1,
          "type": "product",
          "id": "p_PJbnN",
          "resolvedBidId": "WyJlX1BKYm5OIiwiMTJhNTU4MjgtOGVhZC00Mjk5LTgzMjctY2ViYjAwMmEwZmE4IiwiYmFubmVyQWRzIiwiZGVmYXVsdCIsIiJd",
          "asset": [
            {
              "url": "https://dam-cdn.retailer.com/campaigns/holiday/banner-728x90-v2.jpg"
            }
          ]
        }
      ],
      "error": false
    }
  ]
}
3

Afficher la Bannière avec l'Actif DAM

Utilisez l’URL retournée pour afficher la bannière et suivre les performances :
// Extraire l'URL DAM de la réponse d'enchère
const winner = auctionResult.results[0].winners[0];
const damImageUrl = winner.asset[0].url;
const resolvedBidId = winner.resolvedBidId;

// Afficher la bannière dans votre interface utilisateur
const bannerElement = document.createElement("img");
bannerElement.src = damImageUrl;
bannerElement.addEventListener("click", () => {
  // Suivre l'événement de clic pour la facturation et l'attribution
  fetch("/api/topsort/events", {
    method: "POST",
    body: JSON.stringify({
      type: "click",
      resolvedBidId: resolvedBidId,
    }),
  });
});

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 :
// Exemple de synchronisation automatique des actifs du DAM vers Topsort
const syncApprovedAssets = async () => {
  const approvedAssets = await dam.getAssetsByStatus("approved");

  for (const asset of approvedAssets) {
    if (!asset.syncedToTopsort) {
      await topsortAssetsAPI.create({
        name: asset.name,
        url: asset.cdnUrl,
        dimensions: asset.dimensions,
        metadata: asset.metadata,
      });
      await dam.markAsSynced(asset.id);
    }
  }
};

Référence API

API Topsort pour l’Intégration DAM

APICas d’Utilisation de l’IntégrationStatutDocumentation
API AssetsRéférencer des URL DAM dans les campagnes✅ DisponibleGestion des actifs et collections
API CampaignCréer des campagnes avec des actifs DAM✅ DisponibleGestion complète du cycle de vie des campagnes

Authentification

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

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

  1. 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
  1. É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
  1. 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

  1. É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
  1. 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

  1. Évaluation : Examinez la génération d’URL et les capacités API de votre système DAM actuel
  2. Identifiants API : Obtenez les clés API Topsort et configurez l’authentification
  3. Preuve de Concept : Commencez avec un petit ensemble d’actifs pour tester le flux de travail de connectivité
  4. Automatisation : Implémentez des processus de synchronisation automatisés pour les actifs approuvés
  5. Surveillance : Configurez le suivi pour le succès de la synchronisation des actifs et les performances des campagnes

Ressources Associées

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: