Documentation Primeiros passos

Instale o Loader

O Supreme Loader é servido pelo seu próprio Node. Ele cria a bridge window.supremeSend no navegador, coleta contexto de primeira parte da página e entrega eventos ao caminho de ingestão do Node.

Antes de começar

A URL do Loader exige o id numérico de uma Property ativa:

  • Crie a Property no Console primeiro, e registre na lista de domínios dela cada domínio que vai enviar eventos. Um Node recém-instalado não tem nenhuma Property até você criar uma.
  • Anote o id numérico da Property — a primeira costuma ser 1.

Sem um id de Property válido e ativo na URL, o Node serve um stub de segurança que descarta todo evento. O stub ainda define window.supremeSend como função, então uma página pode parecer conectada enquanto não envia nada.

Copie o snippet

Use o domínio exato do Node que foi implantado para tracking, mais o id de Property em ?pid=:

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

O parâmetro ?pid= é obrigatório. Não use o domínio do Console nem o domínio do Supreme System nessa URL. O script pertence ao seu Node.

Coloque no head da página

Adicione o snippet dentro do <head> em toda página que deve enviar eventos. Carregue-o antes das tags de evento do GTM, dos listeners do WooCommerce, das bridges do Shopify, ou de código customizado que chama window.supremeSend.

Para uma instalação direta no site:

  1. Adicione o snippet ao head ou layout compartilhado do site.
  2. Publique a mudança no site.
  3. Abra uma página pública em uma janela anônima do navegador.
  4. Nas ferramentas de desenvolvedor, confirme que a requisição para /lib/supreme.js?pid=<property-id> completa com status HTTP 200. Um 400 ou 404 nessa requisição significa que o id de Property está ausente, desconhecido ou inativo.
  5. No console do navegador, confirme que window.SupremeTracking.propertyId retorna o id da sua Property. Um null aqui significa que a página recebeu o stub de rejeição — corrija o ?pid= antes de qualquer outra coisa. Checar apenas typeof window.supremeSend não basta, porque o stub também o define.

Outras superfícies de instalação

  • Google Tag Manager: se o GTM for sua única superfície de injeção de script, use uma tag Custom HTML para o Loader e dispare-a em um trigger de Initialization. As tags de evento precisam rodar depois dela. O template de evento oficial ainda depende de window.supremeSend.
  • WooCommerce: o plugin Supreme para WooCommerce pode enfileirar sua URL de Loader configurada antes do próprio listener de eventos. Confirme a URL do Node e o Ingest Token nas configurações do plugin.
  • Shopify: instale o Loader na superfície de tema top-frame da storefront quando o transporte de evento do Shopify escolhido exigir a bridge de navegador. Um Custom Pixel em sandbox não pode presumir acesso direto ao window.supremeSend do top-frame.

Escolha uma instalação intencional do Loader por página. Cópias múltiplas geram ruído e tornam problemas de ordem mais difíceis de diagnosticar.

Verifique pelo Console

Faça login no Console e abra Loader Configuration. Em Verify Installation:

  1. Informe o host de Node/Uplink que serve o Loader, sem caminho de página.
  2. Selecione Check Installation.
  3. Procure por Installation verified successfully!

O resultado verde só 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. Confirme o site renderizado e a resposta real do script separadamente, depois envie um evento e verifique seu primeiro evento para provar a ingestão.

Se a verificação falhar

Confira, nesta ordem:

  • O hostname do Node está correto e usa HTTPS.
  • https://<seu-dominio-node>/lib/supreme.js?pid=<property-id> abre com HTTP 200 e sem erro de certificado. Um 400 ou 404 significa que o valor de ?pid= está ausente, desconhecido ou inativo — confirme o id de Property e seu estado ativo no Console.
  • O domínio da página — incluindo a variante exata www. ou de subdomínio — está registrado na lista de domínios daquela Property.
  • O snippet está presente na página renderizada, não só em um tema não publicado ou workspace do GTM.
  • Uma regra de consentimento, política de segurança de conteúdo, bloqueador de anúncios ou regra de sequenciamento de tags não está impedindo o carregamento do script.
  • O valor informado em Verify Installation é o host do Node, não a URL de uma página do site ou uma URL com caminho.

Com o Loader presente, continue com Connect Google Tag Manager (em inglês) ou outra fonte de evento suportada.