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.
Como Funcionan os sistemas DAM com Topsort
Sistemas DAM como Adobe Experience Manager Assets, Bynder ou Webdam:
- Centralizar recursos: Almacenar todos os banners, imágenes de produtos e vídeos en un repositorio organizado.
- Gerar URL de CDN: Criar URL optimizadas e de acceso público para cada recurso.
- Gerenciar versiones: Realizar un seguimiento das versiones aprobadas e evitar o uso de recursos obsoletos.
- 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 trabajo | Quién | Cuándo | Objetivo |
|---|---|---|---|
| Guía de implementação | Equipo de DevOps/Integração | Configuração única | Establecer sincronização automatizada de DAM ↔ Topsort |
| Flujo de trabajo da interfaz de usuário | Proveedores/Administradores do mercado | Por campanha | Crea campanhas de banners a través do pano de control com URL de DAM |
| api Workflow | Gestores de campanhas/Anunciantes | Por campanha | Crea campanhas de banners de forma programática utilizando recursos DAM |
| Leilão e visualização | Desarrolladores de Marketplace | Cada vez que se carga a página | Mostrar 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
**
**

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:
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:
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:
2
Recibir DAM URL en respuesta
Quando seu campanha de banners gana, a respuesta à subasta inclui o DAM URL original:
3
Banner renderizado com o recurso DAM
Utilice o objeto URL devuelto para mostrar o banner e realizar un seguimiento do desempenho:
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:
Referencia API
API Topsort para a integração de DAM
| API | Caso de uso de integração | Estado | Documentação |
|---|---|---|---|
| Recursos api | URL de referencia de DAM en campanhas | ✅ Disponible | Gestión e colecciones de recursos |
| Campanha api | Crea campanhas com recursos DAM | ✅ Disponible | Gestión completa do ciclo de vida da campanha |
Autenticação
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
- 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
- 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.
- 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
- 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
- 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
- Evaluação: Revise as capacidades de geração URL e API do seu sistema DAM actual.
- Credenciales API: Obtenga as claves Topsort e API e configure a autenticação.
- Prueba de concepto: Comience com un pequeño conjunto de recursos para probar o flujo de trabajo de conectividade.
- Automatização: Implementar procesos de sincronização automatizados para os activos aprobados.
- Monitoreo: Configure o seguimiento para o éxito da sincronização de activos e o desempenho da campanha.
Recursos relacionados
- Guía de integração do OMS - Conectividade do sistema de gestión de pedidos
- Documentação de recursos api
- Documentação da campanha api
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: