Documentation Carregando eventos

Rastreie uma página específica a partir do HTML ou da URL

Com a skill Web Events instalada, seu agente de IA consegue transformar uma página — uma landing page, um checkout, uma etapa de funil — em um snippet de tracking pronto para colar. Você entrega a página a ele e diz quais ações importam; ele mapeia essas ações para eventos canônicos Supreme vinculados aos elementos reais da página.

Antes de começar

O snippet só funciona em uma página que já está conectada:

  • O Loader está instalado na página com um id de Property válido em ?pid=.
  • O domínio da página está registrado na lista de domínios dessa Property.

A skill verifica a tag do Loader durante a aquisição da página e vai te direcionar para corrigir a instalação primeiro se ela estiver ausente — um snippet em uma página não conectada falha silenciosamente, por design.

Entregue a página ao agente

Duas formas, em ordem de confiabilidade:

Cole o HTML renderizado. No navegador, abra a página, pressione F12 para as ferramentas de desenvolvedor, clique com o botão direito no elemento <html> no painel Elements e escolha Copy > Copy outerHTML. Cole isso no chat. Esse é o caminho mais confiável e o único que funciona para páginas montadas por JavaScript (a maioria dos page builders e SPAs).

Informe a URL. O próprio agente busca a página e faz um inventário dos formulários, campos e elementos clicáveis reais dela. Isso funciona para páginas renderizadas no servidor. Se a URL retornar um shell de JavaScript vazio, o agente vai parar e pedir o HTML renderizado em vez de chutar — essa recusa é deliberada. Um snippet vinculado a um seletor que não existe na página é JavaScript válido que não dispara nada.

Diga o que rastrear

Seja concreto sobre gatilhos e resultados, um por linha:

Nesta página, rastreie:
- o envio do formulário #contact como lead
- o clique no botão do plano "Start free" como initiate_checkout, com o nome do plano como param
- chegar à seção de agradecimento como um evento customizado

Duas regras que o agente vai exigir de você, porque o Node as impõe:

  • Um lead precisa carregar o e-mail ou telefone que a página realmente coleta. Se a página não coleta nenhum dos dois, o agente emite contact em vez disso — ele não vai inventar identidade.
  • Um purchase ou refund precisa carregar um value numérico e uma currency.

O que você recebe

Um snippet de JavaScript autocontido que espera pelo window.supremeSend do Loader, vincula só os elementos observados na sua página, deduplica gatilhos repetidos e envia eventos canônicos com seus params e diagnósticos de entrega. Snippets de produção não têm comentários, não carregam segredos e não carregam property_id — a Property vem do ?pid= do Loader, não do snippet.

Cole-o depois da tag do Loader: no próprio código da página, no slot de JavaScript customizado do site, ou no footer do seu tema. Ele não muda o comportamento da página — os envios falham silenciosamente em vez de bloquear um submit ou um checkout.

Verifique

  1. Dispare uma das ações mapeadas na página publicada.
  2. Nas ferramentas de desenvolvedor, confirme que a requisição para /ingest.php no domínio do seu Node completa com HTTP 2xx. Um 403 significa que o domínio da página não está registrado na Property; um 422 significa um problema de Property.
  3. Confirme o nome e o timestamp do evento no Console. Verifique seu primeiro evento cobre essa checagem e seus modos de falha.

Um evento que viola uma regra de campo obrigatório — um lead sem identidade, um purchase sem value — é rejeitado pelo Node sem nenhum erro no navegador. Se um evento mapeado nunca aparecer no Console, peça ao agente para checar de novo os campos obrigatórios desse evento contra o payload canônico de evento.

Limites que vale saber

  • Só a partir da URL, o agente não consegue ver conteúdo que só existe depois que o JavaScript roda — nesse caso, entregue a ele o HTML renderizado.
  • Uma página emite para uma Property: aquela para a qual o Loader dela foi servido. Rastrear uma página sob uma Property diferente significa servir o Loader dessa Property nela, não editar o snippet.
  • Edições na página que renomeiam ou removem elementos podem desconectar os gatilhos do snippet. Depois de um redesign, entregue o novo HTML ao agente e peça para ele revalidar os vínculos.