Fase 3 · Instalar o código

5 min de leituraInicianteAtualizado 27 jul 2026

Instalar o Sonar é colar uma linha no seu site. Pixel, domínio e regras você configura depois no painel, sem tocar no código de novo. Aqui você vê o que o Sonar faz, como instalar e como conferir que está no ar.

O que o Sonar faz (e por que server side)

O Sonar rastreia suas vendas do lado do servidor, sem depender do navegador do visitante, e manda as conversões direto pro Meta. Ele reúne num lugar só o rastreamento que antes exigia montar contêiner de tags e um proxy de servidor.

Na prática, ele faz três coisas:

  1. 1Reconhece o visitante que entrou pelo seu anúncio e segue ele pelo funil, mesmo trocando de página ou de domínio.
  2. 2Envia cada evento pro Meta por dois caminhos, o pixel no navegador e o servidor (CAPI), com o mesmo identificador, pro Meta contar a conversão uma vez só. Isso se chama deduplicação.
  3. 3Fecha o ciclo na venda: quando o pagamento é aprovado no seu checkout, o Sonar dispara o Purchase sozinho, ligado ao clique que originou a compra.

Por que server side importa: o navegador perde evento o tempo todo, por bloqueador de anúncio, por iOS, por aba fechada cedo. Pelo servidor, essa conversão não se perde. O Meta recebe dado mais completo e otimiza melhor.

Dica.O Sonar não substitui a sua ferramenta de análise, ele complementa. A sua análise segue onde está; o Sonar é o motor que alimenta o Meta com dado melhor.

Instalar é uma linha só

Você cola um único script no site. A partir daí, pixel, domínio e regras de evento ficam no painel, sem mexer no código outra vez.

<!-- Sonar -->
<script>
  (function () {
    var host = location.hostname.replace(/^www\./, "");
    var s = document.createElement("script");
    s.src = "https://sonar." + host + "/t.js";
    document.head.appendChild(s);
  })();
</script>
Atenção.Você não preenche domínio nenhum: o código detecta o domínio do site sozinho e monta o endereço sonar.seudominio a partir dele. Justamente por isso, a Fase 2 tem que estar concluída antes: enquanto o rastreamento do domínio não estiver No ar, esse endereço não existe, o navegador não consegue baixar o script e nada é rastreado. Não é rastreamento parcial: é zero.
Voltar e concluir a Fase 2 · Cadastrar seu domínio

Passo a passo

  1. 1Confira antes: na seção Domínios, o seu domínio precisa estar No ar. Se ainda não estiver, volte pra Fase 2 — sem isso o passo abaixo não rastreia nada.
  2. 2No painel, abra o seu projeto e vá em Código de rastreamento (a Fase 3).
  3. 3Copie o snippet. É uma linha só.
  4. 4Cole no seu site, dentro do head, de preferência antes de qualquer outro script de rastreamento.
  5. 5Publique o site e abra uma página sua. A primeira visita já deve aparecer no projeto.

Deixe só o código do Sonar na página

Depois de colar o código, tire da página, do checkout e do gerenciador de tags todo o resto de rastreamento. O Sonar tem que ser o único: se sobrar outro pixel disparando ao mesmo tempo, o Meta conta a mesma venda duas vezes e a otimização vira lixo.

O que remover:

  1. 1O pixel antigo do Meta, colado na mão na página ou no checkout.
  2. 2O script da sua ferramenta de análise.
  3. 3Outros pixels de conversão colados antes.
  4. 4As tags que estiverem no seu gerenciador de tags.
Dica.Você não perde nada removendo esses scripts. A sua ferramenta de análise continua recebendo as vendas, porque quem alimenta ela é o checkout, não o script da página. E as UTMs também não se perdem: o Sonar captura na entrada, guarda junto ao identificador do visitante e leva até o checkout, então a origem da venda fica salva.
Atenção.Ordem importa: só remova o rastreamento antigo depois de ver o primeiro evento chegar no Sonar (a seção abaixo mostra como). Se você tirar o antigo antes de confirmar o novo, e o novo ainda não estiver de pé, você fica sem nenhum dos dois — com verba rodando e o Meta cego, sem nenhum aviso na tela.
Atenção.Depois de confirmado, remover é obrigatório, não opcional. Dois rastreamentos na mesma página brigam entre si e sujam o dado que vai pro Meta. O Sonar assume tudo sozinho.

Conferir que está no ar

São duas conferências, e você precisa das duas. A primeira é rápida: no campo Testar uma landing, cole a URL de uma página do seu site e clique em Testar. Se aparecer Landing verificada, o código está no HTML da página.

Atenção.Landing verificada quer dizer só uma coisa: o código está colado na página. Não quer dizer que ele carregou, nem que chegou evento. Se a Fase 2 não estiver No ar, você recebe esse selo verde e mesmo assim está rastreando zero. Por isso existe a segunda conferência.

A segunda é a que vale: veja um evento de verdade chegando.

  1. 1Abra uma página do seu site, no seu próprio navegador.
  2. 2Volte ao painel, abra o projeto e escolha a lente Eventos.
  3. 3Procure a sua visita: um PageView com o horário de agora.
  4. 4Abra a linha e olhe o trilho: Recebido, Enviado e Meta 200.
Pronto.Chegou PageView com o horário de agora? Aí sim a Fase 3 está concluída de verdade. Se não chegou nada, o problema quase sempre é a Fase 2: volte na seção Domínios e confirme que o domínio está No ar.

Próximo passo

Código no ar e página limpa: Fase 3 concluída. Falta ligar a venda ao clique.

Próximo passo: Fase 4 · Conectar seu gateway

Tutoriais relacionados

Este guia foi útil?