Documentation Primeiros passos

Node instalado, e agora?

Seu Node está online, mas só se torna útil quando recebe um evento. O caminho mais curto entre uma instalação recém-feita e uma configuração funcionando é criar sua primeira Property, carregar a biblioteca de navegador, ver um evento no Console e então encaminhar uma conversão para um destino como Meta ou GA4.

A linha de chegada tem duas partes:

  1. O evento está visível no seu Console.
  2. Essa mesma conversão chega a uma integração de destino habilitada.

Antes de começar

Tenha em mãos:

  • O domínio do seu Node, como tracking.exemplo.com.
  • O domínio de Uplink e a Master Key criados durante a instalação do Node.
  • O Ingest Token salvo durante a instalação do Node, se o GTM fizer parte do seu caminho.
  • A lista de domínios do site que vão enviar eventos, para a Property que você cria no Passo 2.
  • Acesso ao <head> do seu site, a um contêiner web do Google Tag Manager, ou à superfície de instalação suportada do WooCommerce ou Shopify que você usa.

Seus eventos de marketing e os dados de clientes são processados pelo seu Node e não passam pelo Supreme System. O Console lê dados operacionais diretamente do seu Node, no seu navegador. Quando você habilita um módulo de destino, esse módulo encaminha os campos mapeados do Node para o destino escolhido.

Saiba mais: What a Node is (control vs data plane) (em inglês).

Passo 1 - Abra o Console e faça login

Abra app.supremetracking.io/console. Digite seu domínio de Uplink e a Master Key, depois inicie a conexão.

O Console roda no seu navegador e fala diretamente com o Node. Mantenha a Master Key privada: não a coloque em código de página, variáveis do GTM, tickets de suporte ou capturas de tela.

Saiba mais: Faça login no Console.

Passo 2 - Crie sua primeira Property

Um Node recém-instalado não tem nenhuma Property, e um Node sem uma Property ativa não aceita eventos. No Console, crie a primeira Property e registre na lista de domínios dela cada domínio que vai enviar eventos — incluindo a variante exata www. ou de subdomínio que suas páginas usam. Anote o id numérico da Property; a URL do Loader no próximo passo precisa dele.

Eventos vindos de um domínio que não está registrado na Property são recusados pelo Node.

Passo 3 - Instale a tag do Loader

Adicione o Loader ao <head> de toda página que deve emitir eventos de navegador. Substitua os placeholders pelo domínio do seu Node e pelo id de Property do Passo 2:

<script src="https://<seu-dominio-node>/lib/supreme.js?pid=<property-id>"></script>

O parâmetro ?pid= é obrigatório — sem um id de Property válido e ativo, o Node serve um stub que descarta todo evento. O Loader expõe window.supremeSend, adiciona contexto de primeira parte e entrega eventos de navegador ao seu Node. Um plugin do WooCommerce ou uma configuração suportada de Shopify/GTM pode carregar essa mesma biblioteca para você, mas a página precisa ter o Loader antes que uma tag de evento tente chamá-lo.

Saiba mais: Instale o Loader.

Passo 4 - Verifique a instalação

Abra a página publicada e confirme duas coisas nas ferramentas de desenvolvedor do navegador: a requisição para /lib/supreme.js?pid=<property-id> completa com HTTP 200, e window.SupremeTracking.propertyId retorna o id de Property do Passo 2 (null significa que a página recebeu o stub de rejeição).

O Console também oferece Verify Installation em Loader Configuration. Um resultado verde de Installation verified successfully! ali significa que o navegador completou a sondagem de rede do modal até a URL construída https://<host-informado>/lib/supreme.js. Como a sondagem usa uma requisição HEAD no-cors, não inspeciona status ou corpo da resposta, e não carrega ?pid=, ela não prova JavaScript do Loader válido, um id de Property funcionando, posicionamento do snippet ou ingestão — a checagem nas ferramentas de desenvolvedor acima é a evidência que conta.

Saiba mais: Verifique seu primeiro evento.

Passo 5 - Conecte o GTM e configure os triggers

Na view Integrations do Console, abra DEPLOY NEW MODULE e selecione Google Tag Manager. Salve o ID correto do contêiner web, depois instale o template Supreme Tracking Event Core nesse contêiner web do GTM.

Crie uma tag para o evento que você quer testar, informe o Ingest Token do Node e anexe um trigger deliberado. Use o Preview do GTM antes de publicar. O template atual envia através de window.supremeSend; ele não substitui o Loader.

Saiba mais: Connect Google Tag Manager (em inglês).

Passo 6 - Confirme seu primeiro evento

Dispare o page view, lead, purchase ou outro evento na página de teste. Volte ao Console e confira a view Live Feed ou Events em busca do nome e do timestamp do evento.

Ver o evento aqui confirma que ele passou pela ingestão e chegou à observabilidade local no seu Node. Ainda não prova que uma plataforma de destino o aceitou.

Saiba mais: Verifique seu primeiro evento.

Passo 7 - Conecte sua primeira integração

Abra Integrations, escolha DEPLOY NEW MODULE e selecione um destino como Meta ou GA4. Instale o módulo quando necessário, informe as credenciais dessa plataforma, habilite-o e salve.

Dispare uma nova conversão de teste. Primeiro confirme no Console, depois use a própria view de teste ou diagnóstico da plataforma de destino para confirmar a chegada. Um evento visível no Console e um recebimento confirmado na plataforma, juntos, completam a checagem de ponta a ponta.

Saiba mais: Visão geral de integrações.

E agora?

Com o primeiro caminho funcionando, adicione só os eventos e destinos que você consegue verificar. Mapeie fontes server-side ou de webhook para o mesmo modelo canônico, expanda as integrações uma de cada vez, e revise o plano vinculado à sua License antes de depender de recursos específicos de plano.

O formato comum de evento é o contrato que mantém essas fontes e destinos consistentes. Saiba mais: O payload canônico de evento.