Crie sua primeira Propriedade

Um Node recém-instalado não tem nenhuma Propriedade. Enquanto não existir uma, ele não aceita nenhum evento vindo do navegador — o Loader carrega, mas nada é gravado. Criar a primeira Propriedade é o primeiro passo real da configuração, e a lista de verificação do Console bloqueia nele.

Isso é uma mudança deliberada. Antes, todo Node ganhava uma "Propriedade padrão" criada sozinha, a partir de um valor que o Node não controlava, e essa lista de domínios era reescrita a cada nova compilação de configuração — o que você digitava não sobrevivia. Agora não existe nada implícito: cada Propriedade é criada por você e a lista de domínios que você digita é a única autoridade sobre quais origens podem enviar eventos.

Crie a Propriedade

1. Abra o Console e vá em Propriedades.
2. Clique em Nova Propriedade.
3. Dê um Nome — é só para você distinguir clientes e sites dentro do mesmo Node.
4. Preencha Domínios: digite um domínio e pressione Enter, um por vez.
5. Salve.

Crie uma Propriedade para cada cliente ou site que você opera neste Node. Cada Propriedade tem o próprio id numérico, e é esse id que a tag do Loader carrega em ?pid=.

Informe os domínios que você é dono

O Node nunca deduz seus domínios. Não há derivação a partir do endereço do Node, do DNS ou de qualquer valor vindo de fora — o que você digita é o que é aceito.

Registre cada host que realmente envia eventos, na forma exata em que ele aparece no navegador:

exemplo.com
www.exemplo.com
loja.exemplo.com

Um evento vindo de um domínio que não está nessa lista é recusado. E a recusa é local: um domínio errado em uma Propriedade afeta apenas aquela Propriedade — as outras continuam recebendo normalmente, e o Node continua no ar.

O que significa TRUE FIRST PARTY

Ao lado de um domínio, o Console pode exibir o selo TRUE FIRST PARTY. Ele indica que o host do próprio Node está dentro do domínio que a Propriedade reivindica — por exemplo, o Node em track.exemplo.com servindo a Propriedade que reivindica exemplo.com.

Quando isso acontece, o navegador trata o cookie de identidade como genuinamente primário: ele vale para todas as páginas daquele domínio e sobrevive à navegação entre elas.

Quando o domínio não é primário

Se o host do Node não estiver dentro do domínio reivindicado — um Node em track.suaagencia.com servindo a Propriedade de lojadocliente.com —, o navegador não aceita um cookie com escopo de um domínio ao qual o host emissor não pertence. O cookie é reduzido a um cookie limitado ao host, e a identidade do visitante se fragmenta entre as páginas.

O Console mostra isso explicitamente no bloco Por que estes domínios não são primários, nomeando o host do Node e os domínios afetados.

O remédio é de infraestrutura, não de configuração: aponte um subdomínio de um domínio que você é dono para este Node (por exemplo, track.lojadocliente.com) e informe esse domínio na Propriedade. Não existe correção automática — enquanto o host do Node estiver fora do domínio, o cookie continua degradado.

Duas Propriedades reivindicando o mesmo domínio

Reivindicar o mesmo domínio em mais de uma Propriedade é suportado, não é erro. É assim que um site e um painel no mesmo domínio compartilham uma identidade de visitante.

Quando isso acontece, o Console avisa:

O domínio exemplo.com também é reivindicado pela Propriedade Nome. Eventos sem property_id explícito serão atribuídos à Propriedade de menor id.

Leia o aviso como a regra que ele descreve: um evento que nomeia a Propriedade vai para ela; um evento que não nomeia nenhuma é atribuído à Propriedade de menor id entre as que reivindicam aquele domínio. Se o resultado não for o que você quer, ou nomeie a Propriedade na tag, ou não repita o domínio.

Uma Propriedade sem nenhum domínio

Uma Propriedade sem domínios é válida e não quebra nada. Ela simplesmente não recebe nada do navegador — o Console avisa com "Nenhum domínio informado — esta Propriedade não recebe eventos do navegador". Nenhuma outra Propriedade e nenhuma outra parte do Node é afetada.

Próximo passo

Com a Propriedade criada e os domínios informados, instale a tag do Loader usando o id dessa Propriedade.

Saiba mais: Instale o Loader · Node instalado, e agora?