Seu processo de lançamento pode variar dependendo do seu caminho de integração e formatos de anúncios. Este guia cobre os cenários mais comuns, mas sua implementação específica pode diferir. Por exemplo:
- Sponsored Listings exigem integração completa do catálogo com dados de produtos
- Banner Ads podem exigir apenas configuração de fornecedor/anunciante sem catálogo em nível de produto
- Configurações de posicionamento variam com base em suas escolhas de formato de anúncio
Lista de Verificação Pré-Lançamento
- Sponsored Listings
Integração de Catálogo
Integração de Catálogo
- O feed de produtos está conectado e atualizando regularmente
- Todos os atributos de produtos (id, nome, preço, imagem, categoria) estão preenchidos
- A disponibilidade do produto é precisa
- A taxonomia de categorias está corretamente mapeada (baseada na sua estrutura de taxonomia acordada)
Integração de Leilões
Integração de Leilões
- As solicitações de leilão incluem todos os campos obrigatórios
- O tratamento de resposta está implementado
Integração de Eventos
Integração de Eventos
- O rastreamento de impressão dispara quando produtos patrocinados estão visíveis
- O rastreamento de cliques dispara em cliques de produtos (incluindo “Adicionar ao Carrinho” se aplicável)
- Os eventos de compra incluem todos os detalhes do pedido
- Os IDs de usuário são consistentes em todos os eventos
Configuração Comum (Todos os Formatos de Anúncio)
Configuração de Ambiente
Configuração de Ambiente
Credenciais API:
- As chaves API de sandbox estão configuradas corretamente
- As chaves API de produção estão prontas (não troque ainda)
- As chaves API estão armazenadas com segurança em variáveis de ambiente
- O processo de rotação de chaves está documentado
- O ambiente de staging espelha a configuração de produção
- Todos os endpoints de API estão configurados corretamente
- Os valores de timeout são apropriados (recomendado: 500-1000ms)
- O tratamento de erros está implementado
Verificação de UI/UX
Verificação de UI/UX
Exibição de Anúncios:
- Os posicionamentos de anúncios renderizam corretamente em todos os tipos de dispositivos
- As etiquetas de anúncios são claramente visíveis (veja diretrizes de rotulagem abaixo)
- As imagens/criativos de anúncios carregam corretamente com fallbacks
- O comportamento de clique funciona conforme esperado
- Os tempos de carregamento da página são aceitáveis com anúncios
- Os anúncios não bloqueiam a renderização crítica da página
- A experiência móvel está otimizada (alvos de toque, layouts responsivos, tempos de carregamento rápidos)
- Os requisitos de acessibilidade são atendidos
Monitoramento e Análises
Monitoramento e Análises
Instrumentação:
- O rastreamento de erros está configurado (Sentry, Datadog, etc.)
- O monitoramento de desempenho está no lugar
- Os dashboards personalizados estão configurados
- Os limites de alerta estão definidos
- O registro de solicitação/resposta da API está habilitado
- Os logs de erros estão sendo capturados
- A trilha de auditoria para eventos de anúncios está configurada
- As políticas de retenção de logs estão definidas
Diretrizes de Rotulagem de Anúncios
Etiquetas Recomendadas
Use etiquetas que indiquem claramente conteúdo promocional evitando gatilhos de bloqueadores de anúncios:
- “Em Destaque”
- “Recomendado”
- “Escolha do Cliente”
- “Melhor Escolha”
Clientes Europeus (Conformidade DSA)
Se operar na União Europeia, a Lei de Serviços Digitais (DSA) requer:
- Rotulagem clara de que o conteúdo é um anúncio
- Exibição do nome do anunciante nos detalhes do anúncio
- Transparência sobre por que o anúncio foi mostrado ao usuário
Testes de Aceitação do Usuário (UAT)
1. Testes de Catálogo
- Sponsored Listings
Verificar Dados de Produtos
No Painel de Administração da Topsort:
- Navegue até a seção de Catálogo
- Verifique se os produtos estão visíveis e pesquisáveis
- Verifique se os dados dos produtos estão completos:
- Nomes de produtos, imagens e preços estão corretos
- As categorias estão corretamente atribuídas
- O status de disponibilidade do produto é preciso
- Crie uma nova campanha de teste chamada
UAT-TEST-[DATA] - Tente adicionar produtos à campanha
- Verifique se a busca e filtragem de produtos funciona
- Confirme se a seleção de produtos salva corretamente
2. Testes de Leilões e Eventos
- Sponsored Listings
Testes de Leilão
Configuração:
- Crie campanha
UAT-TESTcom 3-5 produtos - Defina valor de lance alto ($10+) para garantir vitórias
- Ative a campanha
- Verifique se a solicitação de leilão é enviada
- Verifique se os produtos vencedores são retornados
- Confirme se os produtos renderizam na página
- Verifique a aba de rede do navegador para chamadas de API
- Verifique se a resposta do leilão contém produtos
- Garanta que resolvedBidId seja capturado para rastreamento de eventos
Testes de Eventos
Testar Todos os Tipos de Eventos:Eventos de Impressão:
- Carregue a página com produtos patrocinados
- Verifique se o evento de impressão dispara quando o anúncio está visível
- Verifique se resolvedBidId está incluído
- Clique no produto patrocinado
- Verifique se o evento de clique dispara imediatamente
- Nota: As ações “Adicionar ao Carrinho” também contam como cliques se configuradas
- Confirme se a navegação/ação funciona corretamente
- Complete uma compra com produto patrocinado
- Verifique se o evento de compra inclui:
- ID do produto e quantidade
- Valor do pedido e ID do pedido
- ID do Usuário (necessário para atribuição)
3. Validação de Dados
Capturar Evidências de Teste
Para Cada Usuário de Teste:
- Tire screenshots dos posicionamentos de anúncios
- Capture solicitações de rede mostrando chamadas de API
- Documente detalhes do pedido para eventos de compra (se aplicável)
- Anote timestamps para cada ação
Enviar para Topsort
Envie o seguinte ao seu contato da Topsort:
- Screenshots de impressões de anúncios
- Logs de rede mostrando chamadas de leilão e eventos
- Nome da campanha de teste e intervalo de tempo
- Identificadores de usuário usados nos testes
Revisar Resumo de Dados
A Topsort fornecerá um resumo incluindo:
- Total de leilões recebidos
- Contagens de impressões e cliques
- Contagens de compras (para integrações de anúncios de listagem)
- Pontuação de qualidade de dados
- Quaisquer discrepâncias ou problemas de dados
- Os números correspondem às suas ações de teste
- A cadeia de atribuição está completa
- Não há eventos faltando ou duplicados
Implantação em Produção
Etapas de Implantação
Conectar Catálogo de Produção
- Sponsored Listings
Opção 1: Feed de Produtos
- Compartilhe sua URL de feed de produção com a Topsort
- Garanta que o feed seja acessível e atualize regularmente
- Frequência de atualização recomendada: A cada 15-60 minutos
- Use a API de Catálogo para atualizações em tempo real
- Implemente operações de criar, atualizar e excluir
- Configure sincronização completa do catálogo agendada
- A contagem de produtos corresponde às expectativas
- Todos os campos obrigatórios estão preenchidos
- As imagens estão carregando corretamente
Obter Credenciais de Produção
Usando Topsort UI:
- A Topsort fornece credenciais do painel de administração
- Você recebe a URL da API de produção
- Gere chaves de API no admin
- Armazene as chaves com segurança no ambiente de produção
- Receba a URL da API de produção da Topsort
- Receba chave(s) de API de produção
- Configure as chaves no seu ambiente
Implantar Código de Integração
Pré-Implantação:
- Revise todas as alterações de código uma última vez
- Garanta que as credenciais de sandbox estejam parametrizadas
- Confirme que o procedimento de rollback está documentado
- Agende a implantação durante período de baixo tráfego
- Implante o código no ambiente de produção
- Atualize as variáveis de ambiente com credenciais de produção
- Reinicie os serviços para aplicar nova configuração
- Verifique se a aplicação inicia com sucesso
- Verifique os logs da aplicação para erros
- Teste funcionalidade básica (carregamentos de página)
- Verifique a conectividade da API
Estratégia de Aumento de Tráfego
Lançamento Gradual
Abordagem Recomendada:Dia 1-2: 10% do tráfego
- Monitore de perto para erros
- Valide a precisão dos dados
- Verifique métricas de desempenho
- Compare métricas com linha de base
- Garanta a estabilidade do sistema
- Ajuste se necessário
- Lançamento completo em produção
- Continue monitorando
- Otimize o desempenho
Feature Flags
Use Feature Flags para Controlar:
- Quais posicionamentos mostram anúncios
- Porcentagem de usuários vendo anúncios
- Configurações de teste A/B
- Interruptor de emergência
- Rollback instantâneo sem implantação
- Controle de lançamento gradual
- Configuração por posicionamento
- Risco de implantação reduzido
Monitoramento Pós-Lançamento
Métricas Críticas a Monitorar
Saúde Técnica
Saúde Técnica
Desempenho da API:
- Tempo de resposta da Auction API (meta: <500ms p95)
- Taxa de sucesso da Event API (meta: >99.5%)
- Taxas e tipos de erros
- Frequência de timeout da API
- Impacto no tempo de carregamento da página
- Tempo até primeira renderização de anúncio
- Erros de JavaScript
- Padrões de uso de memória
- Tempo de resposta >1s: Revisar configurações de timeout
- Taxa de erro >1%: Verificar credenciais da API e rede
- Erros JS altos: Revisar implementação do lado do cliente
Qualidade de Dados
Qualidade de Dados
Rastreamento de Eventos:
- Taxa de impressão para clique (típico: 1-5%)
- Taxa de clique para compra (típico: 2-10%, para anúncios de listagem)
- Consistência do volume de eventos
- Completude da atribuição
- Os IDs de usuário estão presentes e consistentes
- Os resolvedBidIds são capturados para impressões e cliques
- Os valores de compra são razoáveis (anúncios de listagem)
- Eventos duplicados são mínimos
- Compare o dashboard da Topsort com suas análises
- Verifique se a atribuição de receita corresponde
- Verifique lacunas ou picos de dados
Métricas de Negócio
Métricas de Negócio
Desempenho da Campanha:
- Total de impressões entregues
- Taxa de cliques (CTR)
- Taxa de conversão (anúncios de listagem)
- Retorno sobre gastos com anúncios (ROAS)
- Taxas de visualização de anúncios
- Engajamento do usuário com anúncios
- Impacto na taxa de conversão orgânica
- Mudanças na taxa de rejeição da página
- Receita incremental de anúncios
- Mudanças no valor médio do pedido
- Taxa de adoção de fornecedores
- Velocidade de criação de campanha
Solução de Problemas Comuns
- Listing Ads
- Problemas Comuns
Nenhum Produto Sendo Exibido
Causas Possíveis:
- Nenhuma campanha ativa
- Valores de lance muito baixos
- Segmentação de produto muito restrita
- Erros da Auction API
- Verifique o console do navegador para erros
- Verifique a resposta da Auction API
- Confirme que as campanhas estão ativas
- Revise os critérios de segmentação
Eventos de Compra Ausentes
Causas Possíveis:
- Evento não acionado no checkout
- ID de usuário ausente no payload do evento
- Formato de ID do produto incorreto
- Falhas de rede
- Teste o fluxo de compra manualmente
- Verifique a estrutura do payload do evento
- Verifique se o ID do usuário está incluído
- Revise os logs do servidor
Melhores Práticas
Comunicação
Coordenação Interna:
- Notifique a equipe de engenharia sobre a implantação
- Alerte o suporte ao cliente sobre novos recursos
- Atualize a equipe de vendas sobre capacidades
- Coordene com a equipe da Topsort
- Agende chamadas de lançamento
- Estabeleça caminhos de escalação
Documentação
Manter:
- Runbooks de implantação
- Procedimentos de rollback
- Especificações de integração de API
- Guias de solução de problemas
- Mudanças de configuração
- Problemas conhecidos e soluções alternativas
- Benchmarks de desempenho
Otimização
Melhoria Contínua:
- Revise o desempenho semanalmente
- Otimize consultas lentas
- Refine a segmentação
- Teste novos posicionamentos
- Posições de posicionamento de anúncios
- Número de anúncios por página
- Formatos e estilos de anúncios
- Estratégias de segmentação
Suporte
Estabelecer:
- Rotação de plantão
- Processo de resposta a incidentes
- Contatos de escalação da Topsort
- Expectativas de SLA
- Cenários de suporte comuns
- Procedimentos de resolução
- Informações de contato
Depois de estar no ar, você estará pronto para começar a otimizar. Entre em contato com seu contato da Topsort para orientação sobre estratégias de campanha, ajuste de atribuição e configurações avançadas.
