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#
-
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.
-
Confirme que a tag carregou
DevTools → Network, filtro
moclick. A requisição da tag deve retornar200ou304. -
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. -
Verifique os cookies
DevTools → Application → Cookies. Confira nome, domínio e validade. Ver cookies gravados.
-
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.
-
Verifique o registro da conversão
No Network deve aparecer a requisição de conversão. Em
POSTos parâmetros vão no corpo, não na URL — abra a aba Payload. -
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âmetro | Deve conter |
|---|---|
slug | O identificador da campanha |
click_id | Valor não vazio, igual ao cookie de identificação |
txid | O identificador do pedido |
value | O 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#
// 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();
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.MoclickConversionexiste 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_idnã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#
| Sintoma | Causa provável |
|---|---|
| Valor 100× maior | Plataforma envia centavos. Divida por 100 — caso clássico do Shopify |
| Valor zerado ou nulo | Vírgula como separador decimal, símbolo de moeda, ou variável de camada de dados vazia |
| Valor com frete e imposto | Campo de total escolhido inclui acessórios. Use o subtotal se o contrato for sobre mercadoria |
| Valor truncado | Mais 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
txidnos 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.