Moclick Bridge
Integração

Debug e validação

Roteiro para validar a integração de ponta a ponta e diagnosticar conversão que não chega.

Validação de ponta a ponta#

  1. Abra a landing pela URL da campanha

    Use o link de tracking fornecido pela Moclick, ou a URL de destino com o parâmetro de marcação, para que o teste chegue como tráfego rastreado. Ver marcação da URL de destino.

  2. Confirme que a tag carregou

    DevTools → Network, filtro moclick. A requisição da tag deve retornar 200 ou 304.

  3. Confirme a configuração da campanha

    A chamada de configuração deve retornar 200, com a campanha identificada. Campanha inexistente ou despublicada retorna resposta neutra e a tag encerra sem agir.

  4. Verifique os cookies

    DevTools → Application → Cookies. Confira nome, domínio e validade. Ver cookies gravados.

  5. Complete o fluxo até a confirmação

    Faça um pedido de teste real. Não simule a página de confirmação — o objetivo é validar que a plataforma preenche corretamente valor e identificador.

  6. Verifique o registro da conversão

    No Network deve aparecer a requisição de conversão. Em POST os parâmetros vão no corpo, não na URL — abra a aba Payload.

  7. Confirme no painel

    Em Campanhas → Resultados, a conversão de teste deve aparecer em Últimas conversões. Este é o único critério definitivo — resposta de sucesso no Network não garante gravação.

Parâmetros a conferir na conversão#

ParâmetroDeve conter
slugO identificador da campanha
click_idValor não vazio, igual ao cookie de identificação
txidO identificador do pedido
valueO valor com ponto decimal e duas casas

Quando a campanha também encaminha a conversão para plataformas de mídia externas, pode haver requisições adicionais no Network. A confirmação nessas plataformas é feita pelo time Moclick, e pode levar algumas horas dependendo da plataforma.

Inspeção no console#

JavaScriptconsole do DevTools
// A configuração foi carregada?
window.MoclickConfig

// O objeto de conversão está presente e bem formado?
window.MoclickConversion

// Quais cookies da Moclick existem?
document.cookie.split("; ").filter(c => c.indexOf("moclick") === 0)

// Limpar as marcas locais para repetir um teste
Object.keys(localStorage)
  .filter(k => k.indexOf("moclick_") === 0)
  .forEach(k => localStorage.removeItem(k));
sessionStorage.clear();
Repetindo um teste de conversão

A deduplicação impede o segundo registro com o mesmo transaction_id. Para testar de novo, use um transaction_id diferente — é o método recomendado — ou limpe o armazenamento local com o comando acima. Note que a deduplicação do servidor continua valendo: mesmo limpando o navegador, o mesmo par clique + transação não é gravado duas vezes.

Diagnóstico#

Nenhuma requisição de conversão aparece#

  • A tag global carregou nesta página — não apenas nas anteriores
  • window.MoclickConversion existe e é um objeto
  • O objeto foi definido dentro de 120 segundos após o carregamento da tag
  • A campanha foi identificada na chamada de configuração
  • O cookie de identificação de clique existe
  • Não há conversão já registrada com o mesmo transaction_id

A requisição sai, mas o painel não mostra#

  • A campanha usa medição própria — confirme com o time Moclick
  • click_id não está vazio na requisição
  • O agente do teste não é identificado como robô — ferramentas de linha de comando são filtradas
  • O período do filtro inclui o momento do teste
  • O filtro de campanha ou de origem não está excluindo o evento
  • Não é duplicata de um evento já registrado

Valor da conversão errado#

SintomaCausa provável
Valor 100× maiorPlataforma envia centavos. Divida por 100 — caso clássico do Shopify
Valor zerado ou nuloVírgula como separador decimal, símbolo de moeda, ou variável de camada de dados vazia
Valor com frete e impostoCampo de total escolhido inclui acessórios. Use o subtotal se o contrato for sobre mercadoria
Valor truncadoMais de duas casas decimais. É esperado: o formato armazenado tem duas casas

Conversões duplicadas#

  • Verifique se o transaction_id é realmente único por pedido
  • Timestamp ou número aleatório como identificador gera duplicata a cada recarga
  • Confirme se a tag de conversão não está disparando em mais de um acionador do gerenciador de tags
  • Se usa Postback S2S e objeto de conversão, garanta o mesmo txid nos dois — assim a dedup reconhece como o mesmo evento

Checklist de go-live#

  • Tag global instalada em todas as páginas, incluindo a de confirmação
  • Identificador da campanha conferido e correspondente ao da tag
  • Objeto de conversão na página de confirmação
  • transaction_id único e estável por pedido
  • Valor com ponto decimal, sem símbolo de moeda, na escala correta
  • Conversão de teste concluída em ambiente real
  • Conversão de teste confirmada no painel de resultados
  • Cookies verificados no domínio e subdomínio corretos
  • Nenhum erro de JavaScript no console
  • Se houver Postback S2S: token guardado no servidor e fila de reenvio implementada
  • Política de privacidade do anunciante atualizada com os cookies utilizados

Concluído o checklist, envie ao time Moclick o domínio e o identificador da campanha para validação final antes de subir o investimento de mídia.

Atualizado em agosto 5, 2026