Moclick Bridge
Integração

Instalação da tag

Onde colocar a tag, como marcar as URLs de destino e como resolver os casos de subdomínio e domínio cruzado.

Esta página é para quem vai colocar a tag no site. São dois passos, e nenhum deles exige conhecimento da plataforma Moclick — só acesso ao site do anunciante.
O que você recebe da Moclick Um trecho de código, específico da sua campanha, no formato <script src="…"></script>. Ele já vem com a campanha identificada — não há chave, senha ou painel para configurar. Se ainda não recebeu, peça ao seu contato comercial ou ao suporte.

Antes de começar#

Você precisa de Para quê
Acesso ao <head> do site Direto no tema, ou por um gerenciador de tags. Qualquer um dos dois serve.
Acesso à página de confirmação de pedido É onde a conversão é informada.
Saber como obter, em JavaScript, o valor e o número do pedido São os dois únicos dados que a integração precisa. Na maioria das plataformas já existem prontos.
Site em HTTPS Recomendado. Em HTTP funciona, mas com menos garantias no navegador.

Passo 1 · Instalar a tag em todas as páginas#

Cole o código no <head> de todas as páginas do site — home, categorias, produto, carrinho, checkout e, principalmente, a página de confirmação de pedido.
HTMLdentro do <head>
<script src="https://bridge.moclick.com.br/moclick-SUA-CAMPANHA.js" defer></script>
Use o código exatamente como recebeu, sem alterar nada — inclusive o defer, que é o que garante que a tag não atrase o carregamento da página.
O erro que mais acontece Instalar a tag somente na página de confirmação. Parece suficiente, porque é ali que a conversão acontece — mas não é. A informação que liga a venda ao anúncio chega na primeira página que o visitante abre, e sem a tag ali ela se perde. O resultado é uma integração que não acusa erro nenhum e não registra nada. Instale globalmente, no template que vale para o site inteiro.

Passo 2 · Informar a conversão#

Na página de confirmação de pedido, declare o valor e o número do pedido:
HTMLpágina de confirmação
<script>
  window.MoclickConversion = {
    value: 150.00,
    transaction_id: "PEDIDO-12345"
  };
</script>
Os dois valores devem vir da sua plataforma, não fixos no código. Em objeto de conversão há o detalhe de formato, e em plataformas há o código pronto para WooCommerce, Shopify, VTEX, Nuvemshop e gerenciador de tags.
Use ponto como separador decimal e não inclua símbolo de moeda: 150.00, nunca R$ 150,00 ou 150,00. Valor com vírgula é descartado e a conversão entra sem receita.

Passo 3 · Verificar que ficou certo#

Dá para conferir sozinho, em dois minutos, antes de avisar a Moclick:

  1. Abra qualquer página do site

    Pressione F12 para abrir as ferramentas do desenvolvedor e vá até a aba Network (ou Rede). Recarregue a página.

  2. Filtre por moclick

    Deve aparecer uma requisição do arquivo da tag, com status 200 ou 304. Se não aparecer nada, a tag não está na página.

  3. Repita na página de confirmação

    Faça um pedido de teste real e chegue até a confirmação. A tag precisa aparecer ali também, e não pode haver erro em vermelho na aba Console.
A confirmação definitiva é feita pelo time Moclick, que verifica no painel se a conversão de teste chegou. Esses três passos servem para você identificar sozinho os problemas mais comuns antes disso.

Se a loja fica em outro endereço#

Só leia esta seção se o visitante muda de endereço entre a página de entrada e a finalização da compra. Se tudo acontece no mesmo domínio, pode pular.

Outro subdomínio do mesmo domínio#

Por exemplo, entrada em www.marca.com.br e checkout em loja.marca.com.br. Normalmente funciona sem nada extra. Se as conversões não aparecerem, use esta versão do código — nos dois endereços:
HTMLsubstitui o código do Passo 1
<script>
  window.MoclickConfig = {
    campaign_slug: "SUA-CAMPANHA",
    cookie_domain: ".marca.com.br"
  };
</script>
<script src="https://bridge.moclick.com.br/moclick.js" defer></script>
Troque SUA-CAMPANHA pelo identificador que está no código que você recebeu, e .marca.com.br pelo seu domínio — com o ponto no início, que é o que faz valer para todos os subdomínios. O mesmo valor precisa ser usado em todos os endereços envolvidos.

Domínio completamente diferente#

Por exemplo, entrada em marca.com.br e pagamento em um serviço externo, em outro domínio. Nesse caso a instalação padrão não cobre o percurso.
Avise o time Moclick antes de instalar. Existem duas soluções possíveis, e qual usar depende de como o seu checkout funciona. Uma delas é feita pelo seu backend e não depende de nada no navegador — ver Postback S2S. Escolher errado significa descobrir o problema só depois da campanha no ar.

Checklist antes de avisar que terminou#

  • A tag está no <head> de todas as páginas
  • A tag está também na página de confirmação de pedido
  • O código foi colado sem alterações, incluindo o defer
  • O objeto de conversão está na página de confirmação
  • O valor usa ponto decimal e não tem símbolo de moeda
  • O número do pedido vem da plataforma e é diferente a cada compra
  • Um pedido de teste real foi concluído até a confirmação
  • A tag aparece no Network nas duas páginas, com status 200 ou 304
  • Não há erro de JavaScript no console

O que enviar à Moclick#

Concluído o checklist, envie ao seu contato:
  • O domínio onde a tag foi instalada
  • O endereço da página de confirmação, se for possível acessá-la
  • O número do pedido de teste que você concluiu
  • Se a compra passa por mais de um endereço, quais são eles
Com isso o time confirma no painel que a conversão chegou e libera a campanha. A validação costuma sair no mesmo dia.
Depois de instalado, não há manutenção A tag é atualizada pela própria plataforma: correções e melhorias chegam sozinhas, sem pedir nada ao seu time e sem trocar o código do site. Você só precisa mexer de novo se o site mudar de domínio ou se a estrutura da página de confirmação for refeita.
Se em algum momento as conversões pararem de aparecer sem que nada tenha mudado no site, fale com o time Moclick antes de mexer no código — pode ser configuração do lado da plataforma, e não da instalação.
Atualizado em agosto 12, 2026