> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topsort.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Entrando em Produção

> Guia completo para preparar e executar uma transição suave para produção com estratégias abrangentes de teste e monitoramento.

export const IntegrationsCard1APt = () => {
  return <>
      <style>{`
        .integrations-card-1a-pt {
          display: flex;
          flex-direction: column;
          background-color: #f0f2f4;
          border: 1px solid rgba(0, 0, 0, 0.08);
          border-radius: 12px;
          padding: 1.25rem 1.5rem;
          gap: 0.25rem;
          color: #25253b;
          box-shadow: 0 1px 3px rgba(0, 0, 0, 0.02);
          transition: box-shadow 0.2s ease, border-color 0.2s ease, transform 0.2s ease;
          margin-top: 2rem;
        }

        .integrations-card-1a-pt:hover {
          box-shadow: 0 4px 12px rgba(0, 0, 0, 0.06);
          border-color: rgba(0, 0, 0, 0.12);
        }

        .dark .integrations-card-1a-pt {
          background-color: #25253b;
          color: #f6f8fa;
          border-color: rgba(255, 255, 255, 0.08);
          box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);
        }

        .dark .integrations-card-1a-pt:hover {
          box-shadow: 0 4px 12px rgba(0, 0, 0, 0.2);
          border-color: rgba(255, 255, 255, 0.12);
        }

        .integrations-card-1a-pt-avatar-row {
          display: flex;
          margin-left: 14px;
          flex-wrap: wrap;
        }

        .integrations-card-1a-pt-avatar {
          width: 44px;
          height: 44px;
          border-radius: 50%;
          border: 2px solid #f0f2f4;
          margin-left: -14px;
          object-fit: cover;
          box-shadow: 0 2px 6px rgba(0, 0, 0, 0.08);
          pointer-events: none;
          cursor: default;
        }

        .dark .integrations-card-1a-pt-avatar {
          border-color: #25253b;
          box-shadow: 0 2px 8px rgba(0, 0, 0, 0.2);
        }

        .integrations-card-1a-pt h2 {
          margin: 0;
          line-height: 1.25;
          font-size: clamp(1.25rem, calc(0.875rem + 1.25vw), 1.75rem);
          font-weight: 700;
          letter-spacing: -0.025em;
          color: #111827;
        }

        .dark .integrations-card-1a-pt h2 {
          color: #f9fafb;
        }

        .integrations-card-1a-pt-subtitle {
          font-size: 0.9375rem;
          font-weight: 500;
          line-height: 1.5;
          color: #4b5563;
          margin: 0;
        }

        .dark .integrations-card-1a-pt-subtitle {
          color: #d1d5db;
        }

        .integrations-card-1a-pt p {
          margin: 0;
          line-height: 1.5;
          font-size: 0.875rem;
          color: #374151;
        }

        .dark .integrations-card-1a-pt p {
          color: #d1d5db;
        }

        .integrations-card-1a-pt a {
          color: #0500ff;
          text-decoration: none;
          font-weight: 500;
          transition: color 0.15s ease;
        }

        .integrations-card-1a-pt a:hover {
          color: #0400cc;
        }

        .dark .integrations-card-1a-pt a {
          color: #8280ff;
        }

        .dark .integrations-card-1a-pt a:hover {
          color: #a19fff;
        }

        @media (max-width: 640px) {
          .integrations-card-1a-pt-avatar {
            width: 38px;
            height: 38px;
            margin-left: -12px;
          }

          .integrations-card-1a-pt-avatar-row {
            margin-left: 12px;
          }
        }

        @media (min-width: 1280px) {
          .integrations-card-1a-pt p {
            font-size: 0.6875rem;
            line-height: 1.4;
            letter-spacing: -0.01em;
          }

          .integrations-card-1a-pt h2 {
            font-size: clamp(1rem, calc(0.75rem + 1vw), 1.25rem);
          }

          .integrations-card-1a-pt-subtitle {
            font-size: 0.75rem;
          }
        }
      `}</style>
      <div className="integrations-card-1a-pt">
        <div className="integrations-card-1a-pt-avatar-row">
          <img src="/images/integration-team/agustin.webp" alt="" loading="lazy" className="integrations-card-1a-pt-avatar" />
          <img src="/images/integration-team/amelia.webp" alt="" loading="lazy" className="integrations-card-1a-pt-avatar" />
          <img src="/images/integration-team/bernardita.webp" alt="" loading="lazy" className="integrations-card-1a-pt-avatar" />
          <img src="/images/integration-team/borumy.webp" alt="" loading="lazy" className="integrations-card-1a-pt-avatar" />
          <img src="/images/integration-team/felipe.webp" alt="" loading="lazy" className="integrations-card-1a-pt-avatar" />
          <img src="/images/integration-team/gui.webp" alt="" loading="lazy" className="integrations-card-1a-pt-avatar" />
          <img src="/images/integration-team/javiera.webp" alt="" loading="lazy" className="integrations-card-1a-pt-avatar" />
          <img src="/images/integration-team/linn.webp" alt="" loading="lazy" className="integrations-card-1a-pt-avatar" />
          <img src="/images/integration-team/marcio.webp" alt="" loading="lazy" className="integrations-card-1a-pt-avatar" />
          <img src="/images/integration-team/mateus.webp" alt="" loading="lazy" className="integrations-card-1a-pt-avatar" />
          <img src="/images/integration-team/max.webp" alt="" loading="lazy" className="integrations-card-1a-pt-avatar" />
          <img src="/images/integration-team/rodrigo.webp" alt="" loading="lazy" className="integrations-card-1a-pt-avatar" />
        </div>

        <h2>Precisa de ajuda com sua integração Topsort?</h2>

        <p className="integrations-card-1a-pt-subtitle">
          Fale conosco, a equipe de engenharia de integrações.
        </p>

        <p>
          Entre em contato através do <strong>seu canal de mensagens dedicado</strong> ou em{" "}
          <a href="mailto:support@topsort.com">support@topsort.com</a>.
        </p>

        <p>
          Se você ainda não é cliente,{" "}
          <a href="https://www.topsort.com/book-a-demo">agende uma demo</a> com nossa
          equipe de vendas.
        </p>
      </div>
    </>;
};

Antes de migrar para produção, conduza Testes de Aceitação do Usuário (UAT) completos para garantir uma transição suave. Este guia orienta você através da preparação pré-lançamento, procedimentos de teste, etapas de implantação e monitoramento pós-lançamento.

<Note>
  **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

  Trabalhe com seu contato da Topsort para confirmar quais seções se aplicam à sua integração.
</Note>

## Lista de Verificação Pré-Lançamento

<Tabs>
  <Tab title="Sponsored Listings">
    <AccordionGroup>
      <Accordion title="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)
      </Accordion>

      <Accordion title="Integração de Leilões">
        * [ ] As solicitações de leilão incluem todos os campos obrigatórios
        * [ ] O tratamento de resposta está implementado
      </Accordion>

      <Accordion title="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
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Banner Ads">
    <AccordionGroup>
      <Accordion title="Configuração de Fornecedor/Anunciante">
        * [ ] Os fornecedores/anunciantes estão configurados no sistema
        * [ ] Os posicionamentos ou modelos JSON estão criados no sistema
        * [ ] Os recursos criativos de banner estão carregados e aprovados
        * [ ] As URLs de clique estão configuradas corretamente
        * [ ] (Opcional) Os padrões de conteúdo estão carregados no sistema
      </Accordion>

      <Accordion title="Integração de Leilões">
        * [ ] As solicitações de leilão incluem todos os campos obrigatórios
        * [ ] Os IDs de posicionamento de banner estão configurados corretamente
        * [ ] O tratamento de resposta retorna dados criativos do banner
        * [ ] A lógica de renderização de banner está implementada
      </Accordion>

      <Accordion title="Integração de Eventos">
        * [ ] O rastreamento de impressão dispara quando o banner está visível
        * [ ] O rastreamento de cliques dispara em cliques de banner
        * [ ] Os IDs de usuário são consistentes em todos os eventos
      </Accordion>
    </AccordionGroup>
  </Tab>
</Tabs>

### Configuração Comum (Todos os Formatos de Anúncio)

<AccordionGroup>
  <Accordion title="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

    **Configuração de Ambiente:**

    * [ ] 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
  </Accordion>

  <Accordion title="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

    **Desempenho:**

    * [ ] 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
  </Accordion>

  <Accordion title="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

    **Registro:**

    * [ ] 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
  </Accordion>
</AccordionGroup>

### Diretrizes de Rotulagem de Anúncios

<CardGroup cols={2}>
  <Card title="Etiquetas Recomendadas" icon="tag">
    Use etiquetas que indiquem claramente conteúdo promocional evitando gatilhos de bloqueadores de anúncios:

    * **"Em Destaque"**
    * **"Recomendado"**
    * **"Escolha do Cliente"**
    * **"Melhor Escolha"**

    <Warning>
      Evite usar "Patrocinado" ou "Anúncio", pois esses termos são comumente alvos de bloqueadores de anúncios.
    </Warning>
  </Card>

  <Card title="Clientes Europeus (Conformidade DSA)" icon="eu">
    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

    Trabalhe com sua equipe jurídica para garantir total conformidade com a DSA.
  </Card>
</CardGroup>

## Testes de Aceitação do Usuário (UAT)

### 1. Testes de Catálogo

<Tabs>
  <Tab title="Sponsored Listings">
    <Card icon="box" title="Verificar Dados de Produtos">
      **No Painel de Administração da Topsort:**

      1. Navegue até a seção de Catálogo
      2. Verifique se os produtos estão visíveis e pesquisáveis
      3. 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

      **Testar Criação de Campanha:**

      1. Crie uma nova campanha de teste chamada `UAT-TEST-[DATA]`
      2. Tente adicionar produtos à campanha
      3. Verifique se a busca e filtragem de produtos funciona
      4. Confirme se a seleção de produtos salva corretamente

      **Resultado Esperado:** Todos os produtos devem ser selecionáveis ao criar campanhas, com informações precisas e completas.
    </Card>
  </Tab>

  <Tab title="Banner Ads (Configuração de Fornecedor)">
    <Card icon="rectangle-ad" title="Verificar Configuração de Fornecedor/Banner">
      **No Painel de Administração da Topsort:**

      1. Navegue até a seção de Fornecedores/Anunciantes
      2. Verifique se os fornecedores estão configurados corretamente
      3. Verifique se as URLs de clique estão corretas

      **Testar Criação de Campanha:**

      1. Crie uma nova campanha de teste chamada `UAT-TEST-[DATA]`
      2. Selecione formato de anúncio de banner
      3. Configure segmentação e configurações de lance
      4. Ative a campanha

      **Resultado Esperado:** As campanhas de banner devem ser criáveis com recursos criativos apropriados e opções de segmentação.
    </Card>
  </Tab>
</Tabs>

### 2. Testes de Leilões e Eventos

<Tabs>
  <Tab title="Sponsored Listings">
    <CardGroup cols={2}>
      <Card icon="gavel" title="Testes de Leilão">
        **Configuração:**

        * Crie campanha `UAT-TEST` com 3-5 produtos
        * Defina valor de lance alto (\$10+) para garantir vitórias
        * Ative a campanha

        **Cenários de Teste:**

        1. Verifique se a solicitação de leilão é enviada
        2. Verifique se os produtos vencedores são retornados
        3. Confirme se os produtos renderizam na página

        **Validação:**

        * 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
      </Card>

      <Card icon="chart-simple" title="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

        **Eventos de Clique:**

        * 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

        **Eventos de Compra:**

        * 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)
      </Card>
    </CardGroup>
  </Tab>

  <Tab title="Banner Ads">
    <CardGroup cols={2}>
      <Card icon="gavel" title="Testes de Leilão">
        **Configuração:**

        * Crie campanha de banner `UAT-TEST`
        * Defina valor de lance alto para garantir vitórias
        * Ative a campanha

        **Cenários de Teste:**

        1. Carregue a página com posicionamento de banner
        2. Verifique se a solicitação de leilão é enviada
        3. Verifique se o criativo de banner vencedor é retornado
        4. Confirme se o banner renderiza corretamente na página

        **Validação:**

        * Verifique a aba de rede do navegador para chamadas de API
        * Verifique se a resposta do leilão contém dados do banner
        * Garanta que resolvedBidId seja capturado para rastreamento de eventos
      </Card>

      <Card icon="chart-simple" title="Testes de Eventos">
        **Testar Todos os Tipos de Eventos:**

        **Eventos de Impressão:**

        * Carregue a página com posicionamento de banner
        * Verifique se o evento de impressão dispara quando o banner está visível
        * Verifique se resolvedBidId está incluído

        **Eventos de Clique:**

        * Clique no banner
        * Verifique se o evento de clique dispara imediatamente
        * Confirme se a navegação da URL de clique funciona

        **Nota:** Os eventos de compra podem não se aplicar a integrações somente de banner, a menos que você esteja rastreando conversões downstream.
      </Card>
    </CardGroup>
  </Tab>
</Tabs>

<Tip>
  **Testar com Dois Usuários Diferentes:** Execute todos os testes com pelo menos duas sessões de usuário exclusivas para verificar o rastreamento e atribuição adequados do usuário.
</Tip>

### 3. Validação de Dados

<Steps>
  <Step title="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
  </Step>

  <Step title="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
  </Step>

  <Step title="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

    **Verificar Alinhamento:**

    * Os números correspondem às suas ações de teste
    * A cadeia de atribuição está completa
    * Não há eventos faltando ou duplicados
  </Step>
</Steps>

## Implantação em Produção

### Etapas de Implantação

<Steps>
  <Step title="Conectar Catálogo de Produção">
    <Tabs>
      <Tab title="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

        **Opção 2: API de Catálogo**

        * Use a [API de Catálogo](/pt/ad-server/catalog/) para atualizações em tempo real
        * Implemente operações de criar, atualizar e excluir
        * Configure sincronização completa do catálogo agendada

        **Verificar:**

        * A contagem de produtos corresponde às expectativas
        * Todos os campos obrigatórios estão preenchidos
        * As imagens estão carregando corretamente
      </Tab>

      <Tab title="Banner Ads">
        **Configuração de Fornecedor:**

        * Confirme que todos os fornecedores/anunciantes estão configurados
        * Verifique se os criativos de banner estão carregados e aprovados
        * Verifique se as URLs de clique estão prontas para produção

        **Verificar:**

        * Todos os fornecedores ativos estão visíveis no admin
        * Os criativos de banner são exibidos corretamente
        * As opções de segmentação estão configuradas
      </Tab>
    </Tabs>
  </Step>

  <Step title="Obter Credenciais de Produção">
    **Usando Topsort UI:**

    1. A Topsort fornece credenciais do painel de administração
    2. Você recebe a URL da API de produção
    3. [Gere chaves de API](/pt/api-reference/authentication) no admin
    4. Armazene as chaves com segurança no ambiente de produção

    **Usando UI Personalizada:**

    1. Receba a URL da API de produção da Topsort
    2. Receba chave(s) de API de produção
    3. Configure as chaves no seu ambiente

    <Warning>
      **Nunca faça commit de chaves de API no controle de versão.** Use variáveis de ambiente ou sistemas de gerenciamento de segredos seguros.
    </Warning>
  </Step>

  <Step title="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

    **Processo de Implantação:**

    1. Implante o código no ambiente de produção
    2. Atualize as variáveis de ambiente com credenciais de produção
    3. Reinicie os serviços para aplicar nova configuração
    4. Verifique se a aplicação inicia com sucesso

    **Verificação Imediata:**

    * Verifique os logs da aplicação para erros
    * Teste funcionalidade básica (carregamentos de página)
    * Verifique a conectividade da API
  </Step>
</Steps>

### Estratégia de Aumento de Tráfego

<CardGroup cols={2}>
  <Card title="Lançamento Gradual" icon="gauge-high">
    **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

    **Dia 3-5:** 50% do tráfego

    * Compare métricas com linha de base
    * Garanta a estabilidade do sistema
    * Ajuste se necessário

    **Dia 6+:** 100% do tráfego

    * Lançamento completo em produção
    * Continue monitorando
    * Otimize o desempenho
  </Card>

  <Card title="Feature Flags" icon="flag">
    **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

    **Benefícios:**

    * Rollback instantâneo sem implantação
    * Controle de lançamento gradual
    * Configuração por posicionamento
    * Risco de implantação reduzido
  </Card>
</CardGroup>

## Monitoramento Pós-Lançamento

### Métricas Críticas a Monitorar

<AccordionGroup>
  <Accordion title="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

    **Desempenho da Aplicação:**

    * 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

    **Itens de Ação se Problemas Forem Detectados:**

    * 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
  </Accordion>

  <Accordion title="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

    **Integridade de Dados:**

    * 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

    **Verificações de Dashboard:**

    * Compare o dashboard da Topsort com suas análises
    * Verifique se a atribuição de receita corresponde
    * Verifique lacunas ou picos de dados
  </Accordion>

  <Accordion title="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)

    **Experiência do Usuário:**

    * 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

    **Impacto na Receita:**

    * 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
  </Accordion>
</AccordionGroup>

### Solução de Problemas Comuns

<Tabs>
  <Tab title="Listing Ads">
    <CardGroup cols={2}>
      <Card title="Nenhum Produto Sendo Exibido" icon="circle-exclamation">
        **Causas Possíveis:**

        * Nenhuma campanha ativa
        * Valores de lance muito baixos
        * Segmentação de produto muito restrita
        * Erros da Auction API

        **Etapas de Depuração:**

        1. Verifique o console do navegador para erros
        2. Verifique a resposta da Auction API
        3. Confirme que as campanhas estão ativas
        4. Revise os critérios de segmentação
      </Card>

      <Card title="Eventos de Compra Ausentes" icon="chart-line-down">
        **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

        **Etapas de Depuração:**

        1. Teste o fluxo de compra manualmente
        2. Verifique a estrutura do payload do evento
        3. Verifique se o ID do usuário está incluído
        4. Revise os logs do servidor
      </Card>
    </CardGroup>
  </Tab>

  <Tab title="Banner Ads">
    <CardGroup cols={2}>
      <Card title="Nenhum Banner Sendo Exibido" icon="circle-exclamation">
        **Causas Possíveis:**

        * Nenhuma campanha de banner ativa
        * Valores de lance muito baixos
        * Criativo de banner não aprovado
        * Erros da Auction API

        **Etapas de Depuração:**

        1. Verifique o console do navegador para erros
        2. Verifique a resposta da Auction API
        3. Confirme que as campanhas estão ativas
        4. Verifique o status de aprovação do criativo
      </Card>

      <Card title="Banner Não Renderiza" icon="image">
        **Causas Possíveis:**

        * URL do criativo inacessível
        * Formato de imagem não suportado
        * Problemas de CORS
        * Problemas de dimensionamento do contêiner

        **Etapas de Depuração:**

        1. Verifique a URL do criativo diretamente
        2. Verifique se a imagem carrega no navegador
        3. Verifique a aba de rede para erros de CORS
        4. Revise o CSS do contêiner
      </Card>
    </CardGroup>
  </Tab>

  <Tab title="Problemas Comuns">
    <CardGroup cols={2}>
      <Card title="Degradação de Desempenho" icon="gauge">
        **Causas Possíveis:**

        * Respostas lentas da API
        * Chamadas de leilão bloqueantes
        * Arquivos de imagem grandes
        * Muitos posicionamentos

        **Soluções:**

        1. Implemente timeouts apropriados
        2. Use chamadas assíncronas/não bloqueantes
        3. Otimize o carregamento de imagens
        4. Faça cache das respostas de leilão
      </Card>

      <Card title="Discrepâncias de Dados" icon="triangle-exclamation">
        **Causas Possíveis:**

        * Contagem dupla de eventos
        * Cadeia de atribuição ausente
        * Incompatibilidades de fuso horário
        * Tráfego de bots

        **Investigação:**

        1. Compare contagens de eventos brutos
        2. Verifique IDs duplicados
        3. Verifique o tratamento de fuso horário
        4. Revise a filtragem de user agent
      </Card>
    </CardGroup>
  </Tab>
</Tabs>

## Melhores Práticas

<CardGroup cols={2}>
  <Card title="Comunicação" icon="comments">
    **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

    **Comunicação Externa:**

    * Coordene com a equipe da Topsort
    * Agende chamadas de lançamento
    * Estabeleça caminhos de escalação
  </Card>

  <Card title="Documentação" icon="book">
    **Manter:**

    * Runbooks de implantação
    * Procedimentos de rollback
    * Especificações de integração de API
    * Guias de solução de problemas

    **Manter Atualizado:**

    * Mudanças de configuração
    * Problemas conhecidos e soluções alternativas
    * Benchmarks de desempenho
  </Card>

  <Card title="Otimização" icon="arrows-maximize">
    **Melhoria Contínua:**

    * Revise o desempenho semanalmente
    * Otimize consultas lentas
    * Refine a segmentação
    * Teste novos posicionamentos

    **Testes A/B:**

    * 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
  </Card>

  <Card title="Suporte" icon="headset">
    **Estabelecer:**

    * Rotação de plantão
    * Processo de resposta a incidentes
    * Contatos de escalação da Topsort
    * Expectativas de SLA

    **Documentar:**

    * Cenários de suporte comuns
    * Procedimentos de resolução
    * Informações de contato
  </Card>
</CardGroup>

***

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.

<IntegrationsCard1APt />