Guia Técnico

Documentação técnica para integração do Moclick Bridge. Implementação via script único, rastreamento de conversões e referência técnica para desenvolvedores.

Visão Geral

A integração do Moclick Bridge é realizada em duas partes: script global instalado em todas as páginas do site e objeto de conversão na página de confirmação de pedido.

Script Global: carrega a configuração pública da campanha e habilita o rastreamento do bridge no site.
Objeto de Conversão: informa ao script o valor da conversão e o identificador único da transação.

O rastreamento do clique de mídia é tratado automaticamente pelos links de tracking da plataforma. A integração do cliente precisa apenas garantir o carregamento do script global e a definição do objeto window.MoclickConversion na página de confirmação.

Instalação

Obter Slug da Campanha

Acesse o painel, navegue até Campanhas e copie o slug identificador.

Ou o script pode ser enviado diretamente pelo nosso time de suporte.

Script Global

Adicione o seguinte código no <head> de todas as páginas do site:

O atributo defer garante carregamento assíncrono sem bloquear a renderização da página. O script foi projetado para falhar silenciosamente em caso de indisponibilidade temporária do servidor.

Rastreamento de Conversão

Na página de confirmação de pedido (thank you page), adicione o objeto window.MoclickConversion antes do fechamento do <body>:

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

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
`value`	number	Sim	Valor monetário da conversão
`transaction_id`	string	Sim	Identificador único do pedido ou evento

Deduplicação: o sistema utiliza a chave composta {campaign_slug}:{transaction_id} para deduplicar conversões. Transações com o mesmo identificador podem ser ignoradas automaticamente.

Ordem de execução: o objeto window.MoclickConversion pode ser definido antes ou depois do carregamento do script global. O script utiliza verificação automática para detectar o evento de conversão na página.

Utilize sempre um transaction_id único por pedido, lead ou conversão.

Exemplos de Integração

Google Tag Manager

Tag HTML customizada (All Pages):

Tag de conversão (Trigger: purchase):

<script>
window.MoclickConversion = {
    value: {{ecommerce.purchase.value}},
    transaction_id: "{{ecommerce.purchase.transaction_id}}"
};
</script>
                

WooCommerce

Via functions.php:

// Script global
add_action('wp_head', function() {
    echo '<script src="https://bridge.moclick.com.br/moclick-SEU-SLUG.js" defer></script>';
});

// Conversão
add_action('woocommerce_thankyou', function($order_id) {
    $order = wc_get_order($order_id);
    echo "<script>window.MoclickConversion={value:{$order->get_total()},transaction_id:'{$order->get_order_number()}'};</script>";
});
                

Shopify

Script global em theme.liquid e conversão em Order Status Page:

<script>
window.MoclickConversion = {
    value: {{ checkout.total_price | money_without_currency }},
    transaction_id: "{{ checkout.order_id }}"
};
</script>
                

Referência de API

Configuração da Campanha

Retorna as configurações públicas da campanha a partir do slug.

GET /wp-json/moclick/v1/campaign?slug={slug}

Parâmetros

Parâmetro	Tipo	Descrição
`slug`	string	Slug da campanha

As conversões são disparadas automaticamente pelo script para o endpoint de postback configurado na campanha.

Não é necessário integrar um endpoint adicional de conversão no site do cliente.

Debug e Validação

Para validar a integração de ponta a ponta:

Abra a página normalmente com o script global ativo.
Complete o fluxo até a página de confirmação.
Abra o DevTools > Network.
Verifique se o script carregou corretamente e se houve requisição para o endpoint de postback da campanha.

Validar na requisição

tid = identificador de clique presente na sessão
sale = valor correto da conversão
txid = identificador único da transação

Se não houver request

Verifique se o script global carregou corretamente.
Verifique se window.MoclickConversion está definido.
Confirme se o slug da campanha está correto no script global.
Confirme se a campanha possui postback configurado no painel.
Confirme se o valor e o identificador da transação estão válidos.

Checklist de Go-Live

Script global instalado em todas as páginas
Slug verificado no painel Moclick
Objeto de conversão na página de confirmação
transaction_id único por pedido
Teste de conversão em ambiente de staging
Validação de requests no DevTools (Network)
Sem erros no console JavaScript

Após a conclusão do checklist, envie email para raisa@moclick.com.br com o domínio para validação final.