Proteside Docs

Verificar a instalação

Confirme no dashboard e no console do navegador que o SDK está ativo no checkout.

Depois de publicar o snippet, abra a página de checkout da loja em um navegador. Em poucos segundos o SDK começa a reportar. Use os três pontos abaixo para confirmar que está tudo certo.

No dashboard

Indicador no topo

No topo do dashboard (na versão para computador) há um indicador de status do SDK:

  • Proteside ativo (verde): a loja tem tráfego real recente do SDK.
  • Proteside não detectado (vermelho): nenhum tráfego real recente.

O indicador é um link para Configurações → Páginas e Domínios. Lá, a seção Páginas detectadas lista cada página que já enviou eventos, agrupada por domínio, com o selo SDK ativo (atividade recente) ou Não detectado.

Saúde do SDK

A página Saúde do SDK mostra se o SDK está reportando tráfego real de clientes, separado da verificação sintética.

Página Saúde do SDK com a faixa de status, os domínios com tráfego real, as métricas de 48 horas, o gráfico de eventos por hora, as versões do SDK e a configuração
StatusSignificado
SDK ativoSessões reais de clientes reportaram recentemente.
SDK não detectadoNenhum evento recebido ainda.
Só verificação sintéticaSó o verificador sintético do Proteside enviou eventos. Nenhum cliente real passou pelo checkout com o SDK ainda.
SDK silenciosoHá histórico, mas nenhuma sessão de cliente recente. Verifique se o snippet ainda está publicado.
SDK pausado (modo desenvolvedor)O modo desenvolvedor está ligado e o SDK não executa proteções.

A página também mostra os Domínios com tráfego real, os totais das últimas 48 horas, o gráfico Eventos por hora, as Versões do SDK vistas nos últimos 7 dias e a configuração atual (canal, modo desenvolvedor e modo de proteção). Os dados são agregados por hora: recarregue a página para atualizar.

Mais detalhes em Saúde do SDK.

No navegador

Abra o checkout, abra as ferramentas de desenvolvedor (F12) e use a aba Console.

Status do SDK

Proteside.getStatus()

Resposta esperada, alguns segundos depois do carregamento:

{
  initialized: true,            // o SDK terminou de iniciar
  version: '1.2.0',
  installationOrderValid: true  // false = há script antes do snippet
}
ResultadoO que significa
Proteside is not definedO shield.js não carregou. Veja se o snippet está publicado, se a CSP permite cdn.proteside.com e se um bloqueador de anúncios não interferiu.
initialized: false por mais de alguns segundosFalta o data-key, a chave tem formato inválido ou o shield.js foi carregado como type="module".
installationOrderValid: falseHá algum script antes do snippet. Veja Solução de problemas.

Se o modo desenvolvedor estiver ligado, a Saúde do SDK mostra SDK pausado (modo desenvolvedor).

Snippet completo

Abra o código-fonte da página publicada (Ctrl+U) e confira se o bloco entre <!-- Proteside Start --> e <!-- Proteside End --> é o primeiro item do <head> e traz as duas tags: o <script> inline do bootstrapper e a tag do shield.js.

Requisições de rede

Na aba Rede (Network), filtre por proteside:

RequisiçãoResposta esperada
shield.js em cdn.proteside.com200
Requisições para app.proteside.comsucesso (2xx), alguns segundos depois do carregamento

Um erro 4xx indica problema de chave ou de conta: confira em Saúde do SDK. Se você trocou a chave, copie o snippet atual em Páginas e Domínios.

O que esperar nos primeiros minutos

  1. Primeiros segundos: initialized: true no console e as primeiras requisições para app.proteside.com.
  2. Até 30 segundos: recarregue o dashboard. O indicador do topo passa a Proteside ativo, e a página aparece em Páginas detectadas.
  3. Primeiros minutos: os scripts da página aparecem em Scripts com o status Precisa revisão. Revise e autorize os legítimos; veja Scripts.
  4. Quando um cliente pagar: os cartões de Integridade de Pagamento saem de AGUARDANDO para ÍNTEGRO conforme cada método é validado. Veja Integridade de pagamento e Pix.

O gráfico da Saúde do SDK é agregado por hora. Um evento recém-enviado pode levar alguns minutos para aparecer ali, mesmo com o indicador do topo já verde.

Próximos passos

Nesta página