> ## 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.

# Solução de Problemas de Anúncios em Loja

> Problemas comuns e soluções para campanhas de Anúncios em Loja, uploads de ativos e integrações CMS

export const LastUpdatedPt = ({date}) => {
  const label = "Última atualização:";
  return <>
      <style>{`
        .last-updated-component {
          display: inline-flex;
          align-items: center;
          gap: 8px;
          padding: 10px 16px;
          border-radius: 8px;
          margin-top: 12px;
          margin-bottom: 16px;
          font-size: 14px;
          background-color: rgba(0, 0, 0, 0.05);
          border: 1px solid rgba(0, 0, 0, 0.12);
          color: rgba(0, 0, 0, 0.75);
          line-height: 1;
        }

        .last-updated-component svg {
          flex-shrink: 0;
          vertical-align: middle;
        }

        .last-updated-component span {
          display: inline-flex !important;
          align-items: center !important;
          line-height: 1 !important;
        }

        [data-theme="dark"] .last-updated-component {
          background-color: #3a3a3a;
          border: 2px solid #888888;
          color: #ffffff;
        }

        [data-theme="dark"] .last-updated-component svg {
          stroke: #ffffff;
        }
      `}</style>
      <div className="last-updated-component">
        <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
          <circle cx="12" cy="12" r="10" />
          <polyline points="12 6 12 12 16 14" />
        </svg>
        <span>
          <strong style={{
    fontWeight: 600
  }}>{label}</strong> 
          <time dateTime={date}>{date}</time>
        </span>
      </div>
    </>;
};

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Este guia cobre problemas comuns com campanhas de Anúncios em Loja e fornece soluções para uploads de ativos, problemas de integração CMS e otimização de desempenho.
</div>

## Problemas de Upload de Ativos

### Erros de Upload

**Problema**: Ativos falham ao fazer upload ou mostram mensagens de erro

**Causas Comuns e Soluções**:

| Mensagem de Erro                   | Causa                           | Solução                                                        |
| ---------------------------------- | ------------------------------- | -------------------------------------------------------------- |
| "Formato de arquivo não suportado" | Tipo de arquivo inválido        | Use formatos suportados: JPEG, PNG, WebP, GIF, MP4             |
| "Arquivo muito grande"             | Excede o limite de tamanho      | Comprima ou redimensione o arquivo para atender aos requisitos |
| "Limite de upload atingido"        | Máximo de criativos carregados  | Remova ativos existentes ou crie nova campanha                 |
| "Validação falhou"                 | Ativo não atende aos requisitos | Verifique dimensões, formato e diretrizes de conteúdo          |
| "Erro de rede"                     | Problemas de conexão            | Verifique a conexão de internet e tente o upload novamente     |

### Problemas de Upload Sequencial

**Problema**: Processo de upload trava ou para no meio do caminho

**Soluções**:

1. **Atualize a página** e tente fazer upload novamente
2. **Limpe o cache do navegador** se os uploads falharem consistentemente
3. **Tente fazer upload de um arquivo por vez** em vez de uploads em massa
4. **Verifique as permissões do arquivo** no seu sistema local
5. **Desative extensões do navegador** que possam interferir com uploads

### Problemas de Cache e Exibição

**Problema**: Ativos carregados recentemente não aparecem ou ativos antigos ainda são exibidos

**Soluções**:

1. **Clique na área de upload** para acionar atualização do cache
2. **Atualize a página do navegador** para recarregar a lista de ativos
3. **Aguarde alguns minutos** para o processamento do lado do servidor ser concluído
4. **Limpe o cache do navegador** se problemas de exibição persistirem

## Problemas de Integração CMS

### Problemas de Conexão

**Problema**: Incapaz de conectar à plataforma CMS externa

**Passos de Solução**:

1. **Verifique as credenciais da API** estão corretas e atualizadas
2. **Verifique o status da plataforma CMS** para quaisquer interrupções de serviço
3. **Confirme a conectividade de rede** entre sistemas
4. **Revise as configurações de firewall** que possam bloquear conexões
5. **Atualize a configuração de integração** se os endpoints do CMS mudaram

### Problemas de Sincronização de Conteúdo

**Problema**: Conteúdo não aparecendo em telas físicas ou atualizações atrasadas

**Soluções**:

1. **Verifique os logs da plataforma CMS** para erros de sincronização
2. **Verifique o status da tela** na interface de gerenciamento do CMS
3. **Confirme o agendamento da campanha** e configurações de ativação
4. **Revise o fluxo de aprovação de conteúdo** no sistema CMS
5. **Teste com uma única tela** para isolar problemas de rede

### Falhas de Autenticação

**Problema**: Erros de autenticação ao conectar ao CMS

**Passos de Resolução**:

1. **Regenere as chaves da API** na plataforma CMS
2. **Atualize as credenciais** nas configurações de integração de Anúncios em Loja
3. **Verifique a expiração do token** e atualize se necessário
4. **Verifique as permissões do usuário** para integração CMS
5. **Entre em contato com o suporte da plataforma CMS** se a autenticação continuar a falhar

## Problemas de Gerenciamento de Campanha

### Campanha Não Aparecendo

**Problema**: Campanhas de Anúncios em Loja não sendo exibidas nas telas

**Lista de Verificação de Diagnóstico**:

1. **Status da Campanha**: Verifique se a campanha está ativa e dentro do intervalo de datas
2. **Verificação de Orçamento**: Garanta que a campanha tenha orçamento disponível
3. **Configuração de Tela**: Confirme que as telas alvo estão configuradas adequadamente
4. **Aprovação de Conteúdo**: Verifique se o conteúdo requer aprovação no sistema CMS
5. **Agendamento**: Verifique se o agendamento da campanha corresponde à disponibilidade da tela

### Problemas de Desempenho

**Problema**: Desempenho ruim da campanha ou baixo engajamento

**Estratégias de Otimização**:

1. **Qualidade Criativa**: Revise a qualidade e relevância do ativo
2. **Tempo de Colocação**: Ajuste o tempo de exibição para picos de tráfego de pedestres
3. **Localização da Tela**: Avalie o posicionamento e visibilidade da tela
4. **Rotação de Conteúdo**: Implemente variedade na rotação criativa
5. **Segmentação de Público**: Refine a segmentação com base em dados demográficos da loja

### Discrepâncias de Relatórios

**Problema**: Dados de desempenho inconsistentes ou ausentes

**Soluções**:

1. **Verifique as Fontes de Dados**: Verifique se todos os sistemas de rastreamento estão configurados adequadamente
2. **Revise as Configurações de Atribuição**: Confirme que as janelas de atribuição estão definidas corretamente
3. **Valide os IDs de Rastreamento**: Garanta que os identificadores de rastreamento únicos estão funcionando
4. **Faça Referência Cruzada de Métricas**: Compare dados em diferentes sistemas de relatórios
5. **Entre em Contato com o Suporte**: Entre em contato para assistência de validação de dados

## Problemas Técnicos

### Compatibilidade de Navegador

**Problema**: Interface de Anúncios em Loja não funcionando adequadamente em certos navegadores

**Recomendações**:

* **Use navegadores suportados**: Chrome, Firefox, Safari, Edge (versões mais recentes)
* **Ative JavaScript**: Necessário para funcionalidade completa
* **Desative bloqueadores de anúncios**: Podem interferir com o carregamento de ativos
* **Limpe os dados do navegador**: Cache, cookies e armazenamento local
* **Atualize o navegador**: Garanta que você está usando a versão mais recente

### Otimização de Desempenho

**Problema**: Tempos de carregamento lentos ou lag da interface

**Soluções**:

1. **Otimize os Tamanhos de Ativos**: Comprima imagens e vídeos antes de fazer upload
2. **Reduza Uploads Simultâneos**: Faça upload de ativos um de cada vez
3. **Feche Abas Desnecessárias**: Libere memória do navegador
4. **Verifique a Velocidade da Internet**: Garanta largura de banda adequada para uploads
5. **Use Conexão Cabeada**: Mais estável que Wi-Fi para uploads grandes

### Problemas de Acesso Móvel

**Problema**: Interface não funcionando adequadamente em dispositivos móveis

**Notas**:

* O gerenciamento de Anúncios em Loja é otimizado para uso em desktop
* O acesso móvel pode ter funcionalidade limitada
* Use desktop ou tablet para gerenciamento completo de campanha
* Entre em contato com o suporte se acesso móvel for necessário

## Problemas de Dados e Análise

### Dados de Impressão Ausentes

**Problema**: Rastreamento de impressões não funcionando ou mostrando zero impressões

**Solução de Problemas**:

1. **Verifique a Configuração de Rastreamento**: Garanta que a detecção de presença está configurada adequadamente
2. **Verifique o Status da Câmera/Sensor**: Confirme que o hardware de detecção está operacional
3. **Revise as Configurações de Privacidade**: Garanta que o rastreamento esteja em conformidade com os requisitos de privacidade
4. **Valide a Configuração de Zona**: Verifique se as zonas visíveis estão definidas corretamente
5. **Teste o Sistema de Detecção**: Verifique se a detecção de pessoas está funcionando na loja

### Problemas de Atribuição

**Problema**: Atribuição de compra não vinculando à exposição do anúncio

**Soluções**:

1. **Verifique a Correspondência de ID do Usuário**: Verifique a integração do programa de fidelidade
2. **Revise as Janelas de Atribuição**: Confirme que as janelas de tempo são apropriadas
3. **Valide Eventos de Compra**: Garanta que o sistema POS está enviando dados corretamente
4. **Teste o Fluxo de Dados**: Verifique o pipeline de dados de ponta a ponta
5. **Revise a Conformidade de Privacidade**: Garanta que a atribuição atenda aos padrões de privacidade

## Suporte de Integração

### Problemas de API

**Problema**: Integrações personalizadas não funcionando adequadamente

**Recursos**:

1. **Revise a Documentação da API**: Verifique atualizações ou mudanças recentes
2. **Teste os Endpoints da API**: Use ferramentas como Postman para verificar conectividade
3. **Verifique os Limites de Taxa**: Garanta que você não está excedendo os limites de chamadas da API
4. **Valide a Autenticação**: Confirme que as chaves e tokens da API são válidos
5. **Monitore os Logs de Erros**: Verifique os logs do aplicativo para detalhes específicos de erro

### Problemas de Plataforma de Terceiros

**Problema**: Integração com plataformas externas falhando

**Passos**:

1. **Verifique o Status da Plataforma**: Verifique a disponibilidade do serviço de terceiros
2. **Revise os Logs de Integração**: Procure por mensagens de erro específicas
3. **Atualize a Integração**: Garanta que você está usando a versão mais recente da integração
4. **Teste a Conectividade**: Verifique a conexão de rede com a plataforma externa
5. **Entre em Contato com o Suporte da Plataforma**: Entre em contato com o suporte da plataforma de terceiros

## Obtendo Ajuda Adicional

### Quando Entrar em Contato com o Suporte

Entre em contato com o suporte se você experimentar:

* Falhas persistentes de upload após tentar todas as soluções
* Problemas de integração CMS que não podem ser resolvidos
* Discrepâncias de dados que afetam a precisão dos relatórios
* Problemas de autenticação que impedem o acesso
* Problemas técnicos não cobertos neste guia

### Informações a Fornecer

Ao entrar em contato com o suporte, inclua:

* **Mensagens de erro específicas** (capturas de tela são úteis)
* **Passos para reproduzir** o problema
* **Navegador e versão** sendo usados
* **IDs de campanha** com problemas
* **Linha do tempo** de quando os problemas começaram
* **Quaisquer mudanças recentes** feitas na configuração

### Recursos de Suporte

* **Documentação**: Consulte [Visão Geral de Anúncios em Loja](/pt/knowledge-base/offsite-and-instore/instore/) para informações de configuração
* **Referência da API**: Verifique a documentação técnica para problemas de integração
* **Fóruns da Comunidade**: Procure por problemas e soluções semelhantes
* **Portal de Suporte**: Envie tickets para assistência personalizada

<div style={{ textAlign: "justify", marginBottom: "1.5rem" }}>
  Para problemas urgentes afetando campanhas ao vivo, use o canal de suporte prioritário fornecido pelo seu gerente de conta.
</div>

***

<LastUpdatedPt date="2025-11-24" />