Zum Hauptinhalt springen

Topsort mit Digital Asset Management-Systemen verbinden

Digital Asset Management (DAM)-Systeme wie Adobe Experience Manager Assets, Bynder und andere zentralisieren kreative Assets und generieren optimierte URLs für die Verwendung in Kampagnen. Im Gegensatz zur OMS-Konnektivität ist die DAM-Konnektivität derzeit mit den bestehenden APIs von Topsort realisierbar.
Dieser Leitfaden erklärt, wie Sie die APIs von Topsort mit DAM-Systemen integrieren können für optimierte kreative Workflows und automatisierte Asset-Verwaltung.
Diagramm zur Darstellung der DAM-Konnektivität

Wie DAM-Systeme mit Topsort funktionieren

DAM-Systeme wie Adobe Experience Manager Assets, Bynder oder Webdam:
  1. Zentralisieren Assets: Speichern alle Banner, Produktbilder, Videos in einem organisierten Repository
  2. Generieren CDN-URLs: Erstellen optimierte und öffentlich zugängliche URLs für jedes Asset
  3. Verwalten Versionen: Verfolgen genehmigte Versionen und verhindern die Verwendung veralteter Assets
  4. Kontrollieren Markenkonformität: Stellen sicher, dass nur genehmigte und markenkonforme Assets in Kampagnen gelangen
  5. Globale Asset-Verteilung: Ein einzelnes Asset-Repository bedient mehrere Marketingkanäle

Workflows

Die DAM-Integration umfasst vier verschiedene Workflows für unterschiedliche Rollen und Zeitpunkte:
WorkflowWerWannZiel
ImplementierungsleitfadenDevOps/IntegrationsteamEinmalige EinrichtungAutomatisierte DAM ↔ Topsort-Synchronisation einrichten
UI-WorkflowVerkäufer/Marketplace-AdminsPro KampagneBanner-Kampagnen über Dashboard mit DAM-URLs erstellen
API-WorkflowKampagnenmanager/WerbetreibendePro KampagneBanner-Kampagnen programmatisch mit DAM-Assets erstellen
Auktion & AnzeigeMarketplace-EntwicklerBei jedem SeitenladevorgangGewinnende Banner an Nutzer anzeigen

Erstellung von Banner-Kampagnen mit DAM-Assets

UI-Workflow

Rolle: Verkäufer/Marketplace-Admins | Häufigkeit: Pro Kampagnenkonfiguration
**
Beginn der Erstellung einer Sponsored Brands-Vorlage
**
Um Banner-Kampagnen mit externen DAM-URLs über die Werbeplattform zu erstellen, siehe den vollständigen Leitfaden für Banner-Werbekampagnen , der den UI-Prozess Schritt für Schritt zeigt, einschließlich wie man externe URLs in der Kampagnenkonfiguration referenziert.

API-Workflow: Vollständige Banner-Kampagnenerstellung

Rolle: Kampagnenmanager/Werbetreibende | Häufigkeit: Pro Kampagnenkonfiguration
1

Asset mit DAM-URL erstellen

Erstellen Sie zunächst ein Asset in Topsort, das Ihre DAM-URL referenziert:
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

Banner-Kampagne mit Asset erstellen

Erstellen Sie anschließend eine Banner-Kampagne, die das soeben erstellte Asset referenziert:
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], // Referenziert das erstellte Asset
    slot_id: "homepage_banner_top",
  }),
});

const campaign = await campaignResponse.json();

Auktionsantwort mit DAM-URL

Rolle: Marketplace-Entwickler | Häufigkeit: Bei jedem Seitenladevorgang
1

Auktion für Banner-Platzierung ausführen

Fordern Sie eine Auktion für die Banner-Platzierung an, bei der Ihre DAM-basierte Kampagne konkurrieren kann:
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

DAM-URL in Antwort erhalten

Wenn Ihre Banner-Kampagne gewinnt, enthält die Auktionsantwort die ursprüngliche DAM-URL:
{
  "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

Banner mit DAM-Asset anzeigen

Verwenden Sie die zurückgegebene URL, um den Banner anzuzeigen und die Leistung zu verfolgen:
// DAM-URL aus Auktionsantwort extrahieren
const winner = auctionResult.results[0].winners[0];
const damImageUrl = winner.asset[0].url;
const resolvedBidId = winner.resolvedBidId;

// Banner in Ihrer Benutzeroberfläche anzeigen
const bannerElement = document.createElement("img");
bannerElement.src = damImageUrl;
bannerElement.addEventListener("click", () => {
  // Klick-Ereignis für Abrechnung und Attribution verfolgen
  fetch("/api/topsort/events", {
    method: "POST",
    body: JSON.stringify({
      type: "click",
      resolvedBidId: resolvedBidId,
    }),
  });
});

Hauptvorteile der DAM-Integration

  • Markenkonsistenz: Nur genehmigte und konforme Assets gelangen in Werbekampagnen - Workflow-Effizienz: Kreative Teams arbeiten in vertrauten DAM-Tools, Assets synchronisieren sich automatisch - Versionskontrolle: Wenn Creatives im DAM aktualisiert werden, aktualisieren sich Kampagnen-Assets automatisch - Rechteverwaltung: Verfolgen Sie Nutzungslizenzen und verhindern Sie die Verwendung abgelaufener Assets - Globale Asset-Verteilung: Ein einzelnes Asset-Repository bedient mehrere Marketingkanäle

Implementierungsleitfaden

Rolle: DevOps/Integrationsteam | Häufigkeit: Einmalige Einrichtung
1

DAM-System-Vorbereitung

Konfigurieren Sie Ihr DAM-System für optimale Konnektivität mit Topsort:
  • Asset-Organisation: Strukturieren Sie Assets mit kampagnenspezifischen Ordnern und Metadaten
  • CDN-Konfiguration: Stellen Sie sicher, dass das DAM optimierte und öffentlich zugängliche URLs generiert
  • Genehmigungs-Workflows: Richten Sie Prozesse ein, um Assets als kampagnenbereit zu markieren
  • Metadatenstandards: Definieren Sie konsistentes Tagging für Abmessungen, Versionen, Ablaufdaten
2

Topsort Assets API-Konfiguration

Richten Sie die Konnektivität zwischen Ihrem DAM und Topsort ein:
  • Authentifizierung: Konfigurieren Sie Topsort API-Anmeldeinformationen
  • URL-Validierung: Stellen Sie sicher, dass DAM-URLs für Topsort-Systeme zugänglich sind
  • Automatisierte Synchronisation: Richten Sie Webhooks oder geplante Jobs ein, um genehmigte Assets zu synchronisieren
  • Fehlerbehandlung: Implementieren Sie Wiederholungslogik für fehlgeschlagene Asset-Referenzen
3

Workflow-Automatisierung

Implementieren Sie automatisierte Asset-Synchronisation:
// Beispiel für automatische Asset-Synchronisation vom DAM zu 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);
    }
  }
};

API-Referenz

Topsort-APIs für DAM-Integration

APIIntegrations-AnwendungsfallStatusDokumentation
Assets APIDAM-URLs in Kampagnen referenzieren✅ VerfügbarAsset- und Sammlungsverwaltung
Campaign APIKampagnen mit DAM-Assets erstellen✅ VerfügbarVollständiges Kampagnen-Lebenszyklusmanagement

Authentifizierung

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Best Practices

Asset-Verwaltung

  • URLs optimieren: Stellen Sie sicher, dass das DAM optimierte URLs für schnelles Laden über CDN generiert - Versionskontrolle: Implementieren Sie klare Versionierung, um veraltete Assets in Kampagnen zu vermeiden - Metadatenstandards: Verwenden Sie konsistentes Tagging für Abmessungen, Kampagnentypen, Genehmigungsstatus - Zugriffskontrolle: Stellen Sie sicher, dass Asset-URLs für Topsort-Systeme öffentlich zugänglich sind

Workflow-Automatisierung

  • Genehmigungs-Gates: Synchronisieren Sie nur genehmigte und markenkonforme Assets mit Topsort - Automatisierte Bereinigung: Entfernen Sie abgelaufene oder veraltete Assets aus aktiven Kampagnen
  • Fehlerüberwachung: Verfolgen Sie fehlgeschlagene Asset-Referenzen und Synchronisationsprobleme

Fehlerbehebung

Häufige DAM-Integrationsprobleme

  1. Asset-URL-Probleme
  • Überprüfen Sie, dass DAM-URLs öffentlich zugänglich sind (nicht hinter Authentifizierung) - Überprüfen Sie, dass URLs angemessene HTTP-Statuscodes zurückgeben (200) - Stellen Sie sicher, dass CDN-URLs für schnelles Laden optimiert sind - Validieren Sie, dass Asset-Abmessungen den Anforderungen von Topsort entsprechen
  1. Synchronisationsfehler
  • Überprüfen Sie API-Authentifizierung und Berechtigungen - Überprüfen Sie die Kompatibilität des Asset-Metadatenformats
  • Überwachen Sie Webhook-Zustellungserfolgsraten - Implementieren Sie angemessene Fehlerprotokollierung für fehlgeschlagene Synchronisationen
  1. Versionskontrollprobleme - Stellen Sie sicher, dass aktualisierte Assets Kampagnen-Asset-Updates auslösen
  • Überprüfen Sie, dass abgelaufene Assets aus aktiven Kampagnen entfernt werden - Überprüfen Sie, dass nur genehmigte Asset-Versionen mit Topsort synchronisiert werden

Allgemeine API-Probleme

  1. Authentifizierungsfehler
  • Überprüfen Sie API-Schlüssel-Gültigkeit und Scope-Berechtigungen - Überprüfen Sie Authentifizierungs-Header-Format
  • Überwachen Sie Token-Ablauf
  1. Rate Limiting - Implementieren Sie angemessenes Rate Limiting im Konnektivitätscode - Verwenden Sie Batch-Operationen, wenn verfügbar - Fügen Sie Wiederholungslogik mit exponentiellem Backoff hinzu

Erste Schritte

Implementierungsschritte

  1. Bewertung: Überprüfen Sie die URL-Generierung und API-Funktionen Ihres aktuellen DAM-Systems
  2. API-Anmeldeinformationen: Erhalten Sie Topsort API-Schlüssel und konfigurieren Sie die Authentifizierung
  3. Proof of Concept: Beginnen Sie mit einem kleinen Satz von Assets, um den Konnektivitäts-Workflow zu testen
  4. Automatisierung: Implementieren Sie automatisierte Synchronisationsprozesse für genehmigte Assets
  5. Überwachung: Richten Sie Tracking für Asset-Synchronisationserfolg und Kampagnenleistung ein

Verwandte Ressourcen

Diese Dokumentation spiegelt die aktuellen Funktionen der Topsort-API wider. DAM-Konnektivität ist jetzt mit bestehenden APIs verfügbar. Für die Entwicklung benutzerdefinierter Konnektivität wenden Sie sich bitte an Ihren Topsort-Vertreter.

Zuletzt aktualisiert: