Integração

Objeto de conversão

Como informar valor e identificador da transação na página de confirmação, e o que acontece em cada caso.

Declaração#

Na página de confirmação de pedido, defina window.MoclickConversion:

HTMLpágina de confirmação

<script>
  window.MoclickConversion = {
    value: 150.00,
    transaction_id: "PEDIDO-12345"
  };
</script>

A posição no documento não importa: pode vir antes ou depois da tag global. Ver como a conversão é detectada.

Parâmetros#

Parâmetro	Tipo	Obrigatório	Descrição
`value`	number \| string numérica	Recomendado	Valor monetário da conversão. Enviado com duas casas decimais.
`transaction_id`	string	Recomendado	Identificador único do pedido, lead ou evento. É a chave de deduplicação.

Tecnicamente opcionais, operacionalmente obrigatórios

A tag aceita window.MoclickConversion = {} e tenta registrar de qualquer forma. As consequências de omitir:

Sem value: a conversão é registrada sem valor. Relatórios de receita e CPA ficam incompletos.
Sem transaction_id: a deduplicação passa a usar apenas o identificador de clique. O visitante registra uma única conversão por clique — a segunda compra do mesmo usuário é descartada em silêncio como duplicata.

Formato do valor#

Aceita número (150.5) ou string numérica ("150.50")
Use ponto como separador decimal. Vírgula não é interpretada
Não inclua símbolo de moeda nem separador de milhar
Enviado sempre com duas casas decimais; armazenado com duas casas

JavaScriptexemplos

// Correto
{ value: 1499.9,     transaction_id: "A-1001" }   // → 1499.90
{ value: "1499.90",  transaction_id: "A-1001" }
{ value: 0,          transaction_id: "LEAD-77" }  // lead sem receita

// Incorreto
{ value: "1.499,90", transaction_id: "A-1001" }   // vírgula decimal → ignorado
{ value: "R$ 1499,90", transaction_id: "A-1001" } // símbolo → ignorado

Escolhendo o transaction_id#

Precisa ser único por conversão e estável — o mesmo pedido deve produzir sempre o mesmo identificador, mesmo se a página for recarregada.

Fonte	Adequado
Número do pedido do e-commerce	Sim — é a escolha padrão
ID da transação do meio de pagamento	Sim
ID do lead no CRM	Sim, para campanha de geração de lead
Timestamp ou número aleatório	Não — recarregar a página gera conversão duplicada
ID ou e-mail do cliente	Não — a segunda compra do mesmo cliente é descartada
Sempre o mesmo valor fixo	Não — só a primeira conversão é registrada

Não use dado pessoal como transaction_id. E-mail, CPF ou telefone nesse campo seriam armazenados como identificador da transação, o que amplia sem necessidade o escopo de dados pessoais tratados. Use o número do pedido.

Deduplicação#

Acontece em duas camadas independentes. Recarregar a página de confirmação, voltar a ela pelo histórico ou receber um postback repetido não gera conversão dupla.

No navegador#

A tag marca localmente que a conversão já foi enviada, o que evita reenvio ao recarregar a página. Se o armazenamento local estiver bloqueado, a deduplicação do servidor assume o papel.

No servidor#

Chave única sobre o tipo do evento, o identificador de clique e o transaction_id:

Um registro de clique por identificador de clique
Uma conversão por par identificador de clique + transaction_id
Conversão sem transaction_id deduplica apenas pelo identificador de clique

Requisição duplicada é tratada como sucesso: a resposta é normal e nada é gravado duas vezes. Isso torna o reenvio seguro — ver reenvio e idempotência.

Múltiplas conversões na mesma página#

Para registrar mais de uma conversão sem recarregar — carrinho com pedidos separados, fluxo de assinatura em etapas — reatribua o objeto. Cada atribuição é detectada e processada, e o transaction_id distinto garante que não seja tratada como duplicata:

JavaScript

window.MoclickConversion = { value: 150, transaction_id: "A-1" };
// mais tarde, no mesmo carregamento
window.MoclickConversion = { value: 89.9, transaction_id: "A-2" };