Como funciona
O caminho de um visitante, do clique no anúncio ao registro da conversão.
Visão geral do fluxo#
-
Clique no anúncio
O visitante chega ao site do anunciante por um link de tracking, que traz na URL os parâmetros de identificação do clique.
-
A tag global carrega
A tag identifica a campanha pela própria URL do script e busca a configuração correspondente, com timeout de 5 segundos.
-
Identificadores são persistidos em cookie
Os parâmetros da URL vão para cookies de primeira parte, com validade definida na campanha. É isso que faz o clique sobreviver até a conversão, mesmo dias depois e em outra sessão.
-
A visita é registrada
Quando a campanha usa medição própria da Moclick, o acesso é registrado uma vez por página, com guarda contra disparo duplicado.
-
A tag observa a conversão
Três mecanismos em paralelo aguardam
window.MoclickConversion: verificação imediata, detecção da atribuição e verificação periódica. Detalhado abaixo. -
A conversão é registrada e encaminhada
A conversão é gravada na plataforma Moclick e, conforme a configuração da campanha, encaminhada às plataformas de mídia contratadas para aquela veiculação. Cada encaminhamento tem deduplicação própria: a falha de um não impede os outros.
Campanhas veiculadas em plataformas externas podem exigir que a conversão seja notificada também a elas, para otimização e para conciliação de pagamento. Isso é configurado por campanha no painel Moclick e não exige nenhuma alteração no site do anunciante — a mesma tag e o mesmo objeto de conversão atendem todos os casos.
A relação das plataformas envolvidas em cada campanha e os respectivos acordos de tratamento de dados são fornecidos ao contratante. Ver Privacidade e LGPD.
Como a conversão é detectada#
O objeto window.MoclickConversion pode ser definido antes ou depois do
carregamento da tag — a tag cobre os dois casos com três mecanismos simultâneos:
| Mecanismo | Quando atua |
|---|---|
| Verificação imediata | No carregamento, se o objeto já existir na página |
| Detecção da atribuição | Qualquer atribuição posterior a window.MoclickConversion é detectada na hora |
| Verificação periódica | A cada 500 ms, por até 120 segundos |
Depois de dois minutos a observação é encerrada. Em single-page application onde o checkout leve mais que isso entre o carregamento da tag e a confirmação, defina o objeto de conversão antes de o usuário entrar no fluxo lento, ou recarregue a tag na rota de confirmação. Ver aplicações single-page.
Se a página já tiver um getter/setter próprio em
window.MoclickConversion, a tag não o sobrescreve —
respeita a implementação existente.
Falha silenciosa por contrato#
Toda a operação da tag é envolvida em tratamento de erro. As situações abaixo resultam em nenhuma ação — nunca em exceção visível, erro no console ou quebra de renderização:
- Servidor de configuração indisponível ou lento (timeout de 5 s)
- Campanha inexistente ou despublicada
localStorageousessionStoragebloqueado pelo navegador- Cookies rejeitados pelo domínio
window.MoclickConversionmalformado ou incompleto
Do lado do servidor a mesma política se aplica: requisição sem identificador de clique, com campanha inexistente ou de origem identificada como robô recebe resposta normal e não grava nada. Detalhes em Arquitetura e segurança.