Guia de Instalação & SDK de Eventos

📊 Acessar Dashboard 360

Sua Chave de Site (Type-Prefixed ID: hn_site_...)

Altere o campo abaixo para atualizar automaticamente todos os códigos de exemplo desta página com sua chave padronizada:

1

Etapa 1: Subdomínio Próprio & DNS First-Party (CNAME)

🛡️ Máxima Resiliência • Cookies de 13 meses • Proteção contra Adblockers e Safari ITP

Antes de publicar o script, crie um subdomínio no DNS do seu cliente (ex: track.seudominio.com.br) apontando como CNAME para nosso coletor. Isso garante que o tráfego seja 100% First-Party, prevenindo que o Safari ou o Chrome eliminem cookies de navegação e garantindo atribuição contínua de até 13 meses.

Tipo de Registro
CNAME
Nome / Entrada
track (ou coletor)
Destino / Valor
trackeamento.hnperformancedigital.com.br
2

Etapa 2: Instalação Básica da Tag no Site

Adicione a tag do script preferencialmente dentro da tag <head> ou logo antes do fechamento de </body> do site cliente. O script é ultraleve (< 4KB) e assíncrono (async), sem nenhum impacto no tempo de carregamento da página.

HTML 
<!-- HN Performance Server-Side Tracking SDK -->
<script 
  src="https://trackeamento.hnperformancedigital.com.br/sdk/tracker.js" 
  data-site-key="hn_site_9k8m2x7v1b3n4p6q8r0s" 
  async>
</script>
Como instalar no Google Tag Manager:
  1. No painel do GTM, vá em Tags → Nova.
  2. Em Configuração da Tag, selecione HTML Personalizado.
  3. Cole o código abaixo no campo HTML.
  4. Em Acionamento, selecione Initialization - All Pages (ou All Pages).
  5. Clique em Salvar e depois em Publicar.
HTML Personalizado no GTM 
<script 
  src="https://trackeamento.hnperformancedigital.com.br/sdk/tracker.js" 
  data-site-key="hn_site_9k8m2x7v1b3n4p6q8r0s" 
  async>
</script>
Opções de instalação no WordPress:
  • Elementor Pro: Vá em Elementor → Custom Code → Adicionar Novo → Localização: <head> → Cole o script.
  • Via Plugin Gratuito: Instale o plugin "WPCode (Insert Headers and Footers)" e cole no bloco Header.
Código para o Header 
<script 
  src="https://trackeamento.hnperformancedigital.com.br/sdk/tracker.js" 
  data-site-key="hn_site_9k8m2x7v1b3n4p6q8r0s" 
  async>
</script>
2

Eventos Automáticos (Zero Código Adicional)

Assim que a tag é carregada, o SDK ativa 3 ouvintes globais para capturar os principais momentos da jornada do usuário sem que você precise escrever código JavaScript:

page_view

Visualização de Página

Disparado no carregamento da URL. Salva e preserva no localStorage todos os parâmetros de anúncio da URL (utm_source, utm_medium, utm_campaign, gclid, fbclid, etc.) em modelo First-Touch resiliente.

whatsapp_click

Cliques de WhatsApp

Intercepta automaticamente qualquer clique em links wa.me/*, api.whatsapp.com/* e whatsapp.com/*, gravando a URL do WhatsApp e o texto do botão clicado.

lead (Auto-Form)

Submissão de Formulários

Monitora envios de <form> na página, extrai e normaliza automaticamente campos de e-mail, telefone/celular e nome do lead, enviando via navigator.sendBeacon sem atrasar a navegação.

3

Disparos Manuais via JavaScript (window.hnTrack)

Para funis com modais JS, popups, botões customizados ou checkout de e-commerce, use a função global window.hnTrack(eventName, options):

Ideal para formulários via AJAX/Fetch, modais de captura, popups e formulários multi-etapas.

JavaScript 
window.hnTrack('lead', {
  user_data: {
    email: 'carlos.oliveira@empresa.com.br',
    phone: '5511998887766',
    name: 'Carlos Oliveira'
  },
  custom_data: {
    form_name: 'Modal Proposta Rápida',
    produto_interesse: 'Gerador Diesel 50kVA',
    cidade: 'São Paulo'
  }
});

Para botões flutuantes ou criados via JavaScript dinâmico onde o ouvinte nativo não esteja presente.

JavaScript 
window.hnTrack('whatsapp_click', {
  user_data: {
    phone: '5521999998888' // se disponível
  },
  custom_data: {
    button_name: 'Botão Flutuante Inferior Direito',
    vendedor_responsavel: 'Equipe Comercial SP',
    link_url: 'https://wa.me/5511999999999'
  }
});

Para páginas de "Obrigado pela Compra" / Confirmação de Pedido em e-commerces, plataformas Hotmart, Eduzz, Kiwify ou checkout próprio.

JavaScript 
window.hnTrack('purchase', {
  user_data: {
    email: 'cliente@gmail.com',
    phone: '5511987654321',
    name: 'Mariana Costa'
  },
  custom_data: {
    value: 1290.00,
    currency: 'BRL',
    order_id: 'PED-998822',
    contents: [
      { id: 'GER-50KVA', name: 'Manutenção Preventiva', price: 1290.00, quantity: 1 }
    ]
  }
});

Disparado quando o visitante clica no botão para ir para a tela de pagamento / checkout.

JavaScript 
window.hnTrack('initiate_checkout', {
  custom_data: {
    value: 497.00,
    currency: 'BRL',
    num_items: 1,
    content_name: 'Plano Semestral Performance'
  }
});

Para lojas virtuais ou catálogos no clique em "Adicionar ao Orçamento" ou "Adicionar ao Carrinho".

JavaScript 
window.hnTrack('add_to_cart', {
  custom_data: {
    content_name: 'Gerador Portátil Silenciado 7kVA',
    content_id: 'GER-SIL-7',
    value: 4500.00,
    currency: 'BRL'
  }
});

Para rastrear quando o visitante visualiza um produto específico, artigo de blog ou proposta comercial.

JavaScript 
window.hnTrack('view_content', {
  custom_data: {
    content_name: 'Geradores Industriais Cummins 150kVA',
    content_category: 'Linha Industrial',
    content_id: 'CUMMINS-150'
  }
});

Para cliques em links telefônicos (tel:+5511...), links de e-mail (mailto:contato@...) ou clique em agendamento de ligação.

JavaScript 
window.hnTrack('contact', {}, {
  channel: 'telefone_fixo',
  numero_discado: '0800 123 4567',
  origem_clique: 'Cabecalho Principal'
});
4

Deduplicação 100% Perfeita com Meta Pixel & CAPI

Para garantir que o Meta Ads não duplique conversões quando o cliente tiver o Meta Pixel do navegador e o nosso Tracking Server-side rodando juntos, a função window.hnTrack retorna automaticamente o event_id (UUID v4) gerado no navegador:

Exemplo de Deduplicação (Browser Pixel + HN Engine) 
// 1. Dispara no HN Tracker Engine e obtém o eventId único
var eventId = window.hnTrack('lead', {
  user_data: { email: 'lead@exemplo.com.br', phone: '5511999998888' }
});

// 2. Se o Meta Pixel tradicional estiver ativo na página, passe o mesmo eventID:
if (typeof fbq === 'function' && eventId) {
  fbq('track', 'Lead', {}, { eventID: eventId });
}
in

Passo 5: Envios Server-Side para LinkedIn Conversions API (Direct API)

O Trackeamento HN possui conector nativo para a LinkedIn Conversions API (Direct API), permitindo o encaminhamento de conversões qualificadas (como lead, purchase e contact) diretamente aos servidores do LinkedIn Marketing Solutions com sanitização e hashing SHA-256 em conformidade com as diretrizes oficiais (Help LMS #a1711116).

1. Gerar Access Token

No Campaign Manager, acesse Mensurar > Gerenciador de Sinais > Direct API e clique em Gerar token de acesso. Guarde o token com segurança pois ele não é exibido novamente.

2. Criar Regra de Conversão

Em Mensurar > Rastreamento de conversões, crie uma conversão via Conversions API, selecione o método Direct API, vincule aos Ad Sets desejados e copie o Conversion Rule ID.

3. Ativar e Testar no Dashboard

Abra o menu Envios & CAPI (Wizard) no dashboard do Trackeamento HN, selecione LinkedIn CAPI, preencha as credenciais e clique em Disparar Teste de Envio para validar a conexão.

Payload Exemplo Despachado para o LinkedIn REST API 
// Endpoint: POST https://api.linkedin.com/rest/conversionEvents
// Headers: LinkedIn-Version: YYYYMM (dinâmico mês corrente ou LINKEDIN_API_VERSION) | X-Restli-Protocol-Version: 2.0.0
{
  "conversion": "urn:lla:llaPartnerConversion:1234567",
  "conversionHappenedAt": 1711116000000,
  "conversionValue": {
    "currencyCode": "BRL",
    "amount": "150.00"
  },
  "user": {
    "userIds": [
      {
        "idType": "SHA256_EMAIL",
        "idValue": "2c624232cdd221771294dfbb310aca000a0df6ac8b66b696d90ef9f8b1bdd63b"
      }
    ]
  },
  "eventId": "evt_9876543210"
}
🧪

Passo 6: Console de Teste Interativo (Playground)

Envie um evento em tempo real a partir desta tela para testar a comunicação imediata com o coletor em produção: