Saltar para o conteúdo principal

Conexión de Topsort com sistemas de gestión de activos digitales

Os sistemas de gestión de activos digitales (DAM), como Adobe Experience Manager Assets, Bynder e otros, centralizan os activos creativos e generan URL optimizadas para seu uso en campanhas. A diferencia da conectividade com os sistemas de gestión de organizaciones (OMS), a conectividade com os sistemas DAM é posible actualmente com as API existentes de Topsort.
Esta guia explica como integrar as API de Topsort com sistemas DAM para optimizar os flujos de trabajo creativos e automatizar a gestión de activos.
Diagram showing dam connectivity

Como Funcionan os sistemas DAM com Topsort

Sistemas DAM como Adobe Experience Manager Assets, Bynder ou Webdam:
  1. Centralizar recursos: Almacenar todos os banners, imágenes de produtos e vídeos en un repositorio organizado.
  2. Gerar URL de CDN: Criar URL optimizadas e de acceso público para cada recurso.
  3. Gerenciar versiones: Realizar un seguimiento das versiones aprobadas e evitar o uso de recursos obsoletos.
  4. Control do cumplimiento da marca: Asegúrese de que solo os activos aprobados e acordes com a marca lleguen a as campanhas.

Flujos de trabajo

A integração de DAM implica cuatro flujos de trabajo distintos para diferentes roles e momentos:
Flujo de trabajoQuiénCuándoObjetivo
Guía de implementaçãoEquipo de DevOps/IntegraçãoConfiguração únicaEstablecer sincronização automatizada de DAM ↔ Topsort
Flujo de trabajo da interfaz de usuárioProveedores/Administradores do mercadoPor campanhaCrea campanhas de banners a través do pano de control com URL de DAM
api WorkflowGestores de campanhas/AnunciantesPor campanhaCrea campanhas de banners de forma programática utilizando recursos DAM
Leilão e visualizaçãoDesarrolladores de MarketplaceCada vez que se carga a páginaMostrar banners ganadores a os usuários

Creação de campanhas de banners com activos DAM

Flujo de trabajo da interfaz de usuário

Rol: Administradores de vendedores/mercados | Frecuencia: Configuração por campanha
**
Inicio da creação da plantila de marcas patrocinadas
**
Para criar campanhas de banners com URL de DAM externas a través de Ad Plataforma, consulte a informação completa [Campanhas de anúncios publicitarios en banners] guia](/pt/knowledge-base/ad-platform/banners/banner-ads-campaigns) que mostra o proceso de interfaz de usuário step-by-step, incluindo como hacer referencia a URL externas en Configuração da campanha.

Flujo de trabajo API: Creação completa de una campanha de banners

Rol: Gestores de campanhas/Anunciantes | Frecuencia: Configuração por campanha
1

Criar activo com DAM URL

Primero, cree un activo en Topsort que haga referencia a seu DAM URL:
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: "Holidae 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

Crea una campanha de banners utilizando o recurso.

A continuação, crea una campanha de banners que haga referencia ao recurso que acabas de criar:
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: "Holidae 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], // Reference the created asset
      slot_id: "homepage_banner_top",
    }),
  }
);

const campaign = await campaignResponse.json();

Respuesta à subasta com URL de DAM

Rol: Desarrolladores de Marketplace | Frecuencia: Cada vez que se carga a página
1

Realiza una subasta para o espacio do banner.

Solicita una subasta para o espacio publicitario donda sua campanha basada en DAM pueda competir:
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

Recibir DAM URL en respuesta

Quando seu campanha de banners gana, a respuesta à subasta inclui o DAM URL original:
{
  "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 renderizado com o recurso DAM

Utilice o objeto URL devuelto para mostrar o banner e realizar un seguimiento do desempenho:
// Extract the DAM URL from auction response
const winner = auctionResult.results[0].winners[0];
const damImageUrl = winner.asset[0].url;
const resolvedBidId = winner.resolvedBidId;

// Render banner in your UI
const bannerElement = document.createElement("img");
bannerElement.src = damImageUrl;
bannerElement.addEventListener("click", () => {
  // Track click event for billing and attribution
  fetch("/api/topsort/events", {
    method: "POST",
    body: JSON.stringify({
      type: "click",
      resolvedBidId: resolvedBidId,
    }),
  });
});

Beneficios clave da integração de DAM

  • Consistencia de marca: Solo os activos aprobados e que cumplen com as normas llegan a as campanhas publicitarias.
  • Eficiencia do flujo de trabajo: Os equipos creativos trabajan com ferramentas DAM conocidas e os recursos se sincronizan automáticamente.
  • Control de versiones: Quando se actualizan os elementos creativos no DAM, os recursos da campanha se actualizan automáticamente.
  • Gestión de derechos: Controlar as licencias de uso e impedir o uso de activos caducados.
  • Distribução globao de activos: Um repositorio de activos sirve a múltiplos canales de marketing

Guía de implementação

Rol: Equipo de DevOps/Integração | Frecuencia: Configuração única
1

Preparação do sistema de represas

Configure seu sistema DAM para una conectividade óptima com Topsort:
  • Organização de recursos: Estructure os recursos com carpetas e metadatos específicos da campanha.
  • Configuração de CDN: Asegurar que o DAM genere URLs optimizadas e accesibles públicamente.
  • Flujos de trabajo de aprobação: Configurar procesos para marcar os activos como listos para a campanha.
  • Estándares de metadatos: Definir un etiquetado coherente para dimensiones, versiones e fechas de caducidade.
2

Topsort Activos API Configuração

Configure a conectividade entre seu DAM e Topsort:
  • Autenticação: Configure as credenciales Topsort e API.
  • URL Validação: Asegurar que as URL de DAM sean accesibles para os sistemas Topsort
  • Sincronização automatizada: Configure webhooks ou tareas programadas para sincronizar os recursos aprobados.
  • Manejo de errores: Implementar lógica de reintento para referencias a recursos fallidas.
3

Automatização de flujos de trabajo

Implementar a sincronização automatizada de activos:
// Example automated asset sync from DAM to 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);
    }
  }
};

Referencia API

API Topsort para a integração de DAM

APICaso de uso de integraçãoEstadoDocumentação
Recursos apiURL de referencia de DAM en campanhas✅ DisponibleGestión e colecciones de recursos
Campanha apiCrea campanhas com recursos DAM✅ DisponibleGestión completa do ciclo de vida da campanha

Autenticação

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Melhores Práticas

Gestión de activos

  • Optimizar as URL: Asegurar que o DAM genere URL de carga rápida e optimizadas para CDN.
  • Control de versiones: Implemente un control de versiones claro para evitar que os recursos das campanhas queden obsoletos.
  • Estándares de metadatos: Utilice un etiquetado coherente para dimensiones, tipos de campanha e estado de aprobação.
  • Control de acceso: Asegúrese de que as URL dos recursos sean accesibles públicamente para os sistemas Topsort.

Automatização de flujos de trabajo

  • Requisitos de aprobação: Sincronice únicamente os recursos aprobados e que cumplan com a marca com Topsort
  • Limpieza automatizada: Elimina os recursos caducados ou desactualizados das campanhas activas.
  • Supervisão de errores: Seguimiento de referencias a recursos fallidas e problemas de sincronização.

Solução de problemas

Problemas comunes de integração de DAM

  1. Problemas com o activo URL
  • Verificar que as URL do DAM sean de acceso público (no estejan protegidas por autenticação).
  • Comprobar que as URL devuelven os códigos de estado HTTP adecuados (200) Asegúrese de que as URL da CDN estejan optimizadas para una carga rápida.
  • Validar que as dimensiones do activo coincidan com os requisitos de Topsort
  1. Fallo de sincronização
  • Comprobar a autenticação e os permisos de API
  • Verificar a compatibilidade do formato de metadados dos activos
  • Supervisar as tasas de éxito de entrega de webhooks
  • Implementar un registro de errores adecuado para as sincronizaciones fallidas.
  1. Problemas de control de versiones
  • Asegurar que os activos actualizados activen as actualizaciones dos activos da campanha
  • Verificar que os activos caducados se eliminen das campanhas activas
  • Comprobar que solo as versiones de activos aprobadas se sincronicen com Topsort

Cuestiones generales de API

  1. Fallo de autenticação
  • Verificar a validez da clave API e os permisos de alcance
  • Comprobar o formato do encabezado de autenticação
  • Monitorear a expiração do token
  1. Limitação de velocidade
  • Implementar una limitação de velocidade adecuada no código de conectividade
  • Utilice operaciones en lote quando estejan disponibles
  • Agregar lógica de reintento com retroceso exponencial

Empezando

Implementação Steps

  1. Evaluação: Revise as capacidades de geração URL e API do seu sistema DAM actual.
  2. Credenciales API: Obtenga as claves Topsort e API e configure a autenticação.
  3. Prueba de concepto: Comience com un pequeño conjunto de recursos para probar o flujo de trabajo de conectividade.
  4. Automatização: Implementar procesos de sincronização automatizados para os activos aprobados.
  5. Monitoreo: Configure o seguimiento para o éxito da sincronização de activos e o desempenho da campanha.

Recursos relacionados


Esta documentação refleja as capacidades actuales de Topsort e API. A conectividade DAM ya está disponible através das API existentes. Para o desarrollo de conectividade personalizada, póngase en contacto com seu representante de Topsort.

Last updated: