Conexão do Topsort com Sistemas de Gestão de Ativos Digitais
Os sistemas de gestão de ativos digitais (DAM), como Adobe Experience Manager
Assets, Bynder e outros, centralizam os ativos criativos e geram URLs
otimizadas para uso em campanhas. Diferentemente da conectividade com os
sistemas de gestão de organizações (OMS), a conectividade com os sistemas DAM
é possível atualmente com as APIs existentes do Topsort.
Este guia explica como integrar as APIs do Topsort com sistemas DAM para
otimizar os fluxos de trabalho criativos e automatizar a gestão de ativos.
Como Funcionam os Sistemas DAM com o Topsort
Sistemas DAM como Adobe Experience Manager Assets, Bynder ou Webdam:
- Centralizar recursos: Armazenar todos os banners, imagens de produtos e vídeos em um repositório organizado.
- Gerar URLs de CDN: Criar URLs otimizadas e de acesso público para cada recurso.
- Gerenciar versões: Realizar o acompanhamento das versões aprovadas e evitar o uso de recursos obsoletos.
- Controle de conformidade da marca: Garantir que apenas os ativos aprovados e de acordo com a marca cheguem às campanhas.
Fluxos de Trabalho
A integração de DAM envolve quatro fluxos de trabalho distintos para
diferentes funções e momentos:
| Fluxo de trabalho | Quem | Quando | Objetivo |
|---|---|---|---|
| Guia de implementação | Equipe de DevOps/Integração | Configuração única | Estabelecer sincronização automatizada de DAM ↔ Topsort |
| Fluxo de trabalho da interface | Fornecedores/Administradores do marketplace | Por campanha | Criar campanhas de banners através do painel com URLs de DAM |
| Fluxo de trabalho API | Gestores de campanhas/Anunciantes | Por campanha | Criar campanhas de banners de forma programática utilizando recursos DAM |
| Leilão e visualização | Desenvolvedores de Marketplace | Cada vez que a página é carregada | Mostrar banners vencedores aos usuários |
Criação de Campanhas de Banners com Ativos DAM
Fluxo de Trabalho da Interface
Função: Administradores de fornecedores/marketplace | Frequência:
Configuração por campanha

Para criar campanhas de banners com URLs de DAM externas através da
Plataforma de Anúncios, consulte o
guia completo de Campanhas de Anúncios em
Banners que
mostra o processo da interface passo a passo, incluindo como referenciar URLs
externas na configuração da campanha.
Fluxo de Trabalho API: Criação Completa de uma Campanha de Banners
Função: Gestores de campanhas/Anunciantes | Frequência: Configuração
por campanha
1
Criar ativo com URL do DAM
Primeiro, crie um ativo no Topsort que faça referência à sua URL do DAM:
2
Criar uma campanha de banners utilizando o recurso
Em seguida, crie uma campanha de banners que faça referência ao recurso que você acabou de criar:
Resposta ao Leilão com URLs do DAM
Função: Desenvolvedores de Marketplace | Frequência: Cada vez que a
página é carregada
1
Realizar um leilão para o espaço do banner
Solicite um leilão para o espaço publicitário onde sua campanha baseada em DAM pode competir:
2
Receber URL do DAM na resposta
Quando sua campanha de banners vence, a resposta ao leilão inclui a URL original do DAM:
3
Renderizar banner com o recurso DAM
Utilize a URL retornada para exibir o banner e acompanhar o desempenho:
Benefícios Principais da Integração de DAM
- Consistência de marca: Apenas os ativos aprovados e em conformidade chegam às campanhas publicitárias. - Eficiência do fluxo de trabalho: As equipes criativas trabalham com ferramentas DAM conhecidas e os recursos são sincronizados automaticamente. - Controle de versões: Quando os elementos criativos são atualizados no DAM, os recursos da campanha são atualizados automaticamente. - Gestão de direitos: Controlar as licenças de uso e impedir o uso de ativos expirados. - Distribuição global de ativos: Um repositório de ativos serve a múltiplos canais de marketing.
Guia de Implementação
Função: Equipe de DevOps/Integração | Frequência: 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 ativos:
Referência da API
APIs do Topsort para Integração de DAM
| API | Caso de uso de integração | Status | Documentação |
|---|---|---|---|
| API de Recursos | Referenciar URLs de DAM em campanhas | ✅ Disponível | Gestão e coleções de recursos |
| API de Campanhas | Criar campanhas com recursos DAM | ✅ Disponível | Gestão completa do ciclo de vida da campanha |
Autenticação
Melhores Práticas
Gestão de Ativos
- Otimizar as URLs: Garantir que o DAM gere URLs de carregamento rápido e otimizadas para CDN. - Controle de versões: Implemente um controle de versões claro para evitar que os recursos das campanhas fiquem obsoletos. - Padrões de metadados: Utilize uma rotulagem consistente para dimensões, tipos de campanha e status de aprovação. - Controle de acesso: Garanta que as URLs dos recursos sejam acessíveis publicamente para os sistemas do Topsort.
Automatização de Fluxos de Trabalho
- Requisitos de aprovação: Sincronize apenas os recursos aprovados e em conformidade com a marca com o Topsort. - Limpeza automatizada: Remova os recursos expirados ou desatualizados das campanhas ativas. - Monitoramento de erros: Acompanhe referências a recursos com falha e problemas de sincronização.
Solução de Problemas
Problemas Comuns de Integração de DAM
- Problemas com URLs de ativos
- Verificar que as URLs do DAM sejam de acesso público (não estejam protegidas por autenticação). - Verificar que as URLs retornem os códigos de status HTTP adequados (200). - Garantir que as URLs da CDN estejam otimizadas para carregamento rápido. - Validar que as dimensões do ativo correspondam aos requisitos do Topsort.
- Falha de sincronização
- Verificar a autenticação e as permissões da API. - Verificar a compatibilidade do formato de metadados dos ativos. - Monitorar as taxas de sucesso de entrega de webhooks. - Implementar um registro de erros adequado para as sincronizações com falha.
- Problemas de controle de versões - Garantir que os ativos atualizados acionem as atualizações dos ativos da campanha. - Verificar que os ativos expirados sejam removidos das campanhas ativas. - Verificar que apenas as versões de ativos aprovadas sejam sincronizadas com o Topsort.
Questões Gerais da API
- Falha de autenticação
- Verificar a validade da chave de API e as permissões de escopo. - Verificar o formato do cabeçalho de autenticação. - Monitorar a expiração do token.
- Limitação de taxa - Implementar uma limitação de taxa adequada no código de conectividade. - Utilizar operações em lote quando disponíveis. - Adicionar lógica de nova tentativa com recuo exponencial.
Começando
Etapas de Implementação
- Avaliação: Revise as capacidades de geração de URL e API do seu sistema DAM atual.
- Credenciais da API: Obtenha as chaves de API do Topsort e configure a autenticação.
- Prova de conceito: Comece com um pequeno conjunto de recursos para testar o fluxo de trabalho de conectividade.
- Automatização: Implemente processos de sincronização automatizados para os ativos aprovados.
- Monitoramento: Configure o acompanhamento para o sucesso da sincronização de ativos e o desempenho da campanha.
Recursos Relacionados
- Guia de Integração do OMS - Conectividade do sistema de gestão de pedidos - Documentação da API de Recursos - Documentação da API de Campanhas
Esta documentação reflete as capacidades atuais do Topsort e da API. A
conectividade DAM já está disponível através das APIs existentes. Para o
desenvolvimento de conectividade personalizada, entre em contato com seu
representante do Topsort.
Última atualização: