Configurar fingerprinting

Configure cside fingerprinting carregando o script do navegador cedo, coletando telemetria com sendClientTelemetry e enviando o token de sessão retornado ao seu backend.

Escolha uma opção de implementação

Método	Melhor para	Orientação de produção
Cloudflare Workers	Sites já roteados pela Cloudflare	Bom para injeção no edge e rollout em rotas limitadas
Injeção direta de script	A maioria dos sites em produção	Recomendado quando você controla o HTML ou app shell
Pacote NPM	Apps com frameworks compatíveis	Recomendado quando o pacote posiciona o script cedo
Google Tag Manager	Validação rápida sem mudar código	Use apenas para teste quando a ordem dos scripts importa

Recomendação de domínio do cliente

Use a configuração de DNS para usar o seu próprio domínio sempre que possível. A cside oferece isso para evitar preocupações de privacidade relacionadas a domínios de terceiros, fazer o script parecer first-party para o navegador e impedir que bloqueadores de anúncios do navegador ou bloqueios client-side interfiram no script ou afetem a precisão das detecções.

Se o cside fornecer uma URL de script dedicada, use essa URL exata em todos os métodos de instalação. Os exemplos abaixo usam placeholders.

Servir o script pelo seu próprio domínio

Esta opção permite servir o script de fingerprinting por um subdomínio que você controla, como fingerprint.example.com. Ela é destinada a contas de produção que querem entrega first-party do script e controle mais rígido de CSP.

Setup habilitado por conta

Domínios personalizados de fingerprint exigem que o cside provisione um hostname de destino para a sua conta. Fale com o cside antes de adicionar registros DNS.

Configuração DNS

Escolha um subdomínio, por exemplo fingerprint.example.com
Peça ao cside o seu hostname de destino de fingerprinting
Adicione um registro CNAME do seu subdomínio para o destino do cside
Aguarde a propagação DNS e a validação do hostname pelo cside
Use o seu subdomínio como origem do script

Exemplo de registro DNS:

Tipo	Nome	Valor
`CNAME`	`fingerprint.example.com`	`<YOUR_TEAM>.csidefd.com`

Depois da validação, use a URL do script no domínio do cliente:

<script
  src="https://fingerprint.example.com/client.js"
  referrerpolicy="origin"
  data-src="6">
</script>

Atualize sua CSP para permitir o subdomínio do cliente em script-src e connect-src.

Injeção direta de script

Adicione o script no <head> da página antes de chamar funções de fingerprinting.

<script
  src="https://<YOUR_SUBDOMAIN>.csidefd.com/client.js"
  referrerpolicy="origin"
  data-src="6">
</script>

Depois chame sendClientTelemetry após o script carregar. Você pode chamar a função sem argumentos ou passar um objeto externalIds opcional.

const response = await sendClientTelemetry({
  accountId: "customer-123",
  orderId: "order-456",
});

const { token: sessionToken } = await response.json();

Envie o token de sessão ao seu backend e troque-o com a API do cside. Consulte a Events API para o fluxo completo.

Pacote NPM

Para frameworks compatíveis, use o pacote do cside que adiciona o script do navegador ao app shell. Isso é útil quando o seu framework controla a renderização do documento.

O pacote ainda deve carregar o mesmo script do cside antes que a sua app chame sendClientTelemetry.

Fale com a equipe da cside para receber ajuda se tiver interesse em usar o método de instalação NPM.

Google Tag Manager

GTM é útil para testes rápidos, mas não garante que o cside carregue antes de outros scripts. Use uma tag Custom HTML com trigger All Pages para validar o fluxo.

Use GTM para validação

Para enforcement em produção ou coleta de dados de alta confiança, use injeção direta, um pacote NPM ou Cloudflare Workers.

Cloudflare Workers

Use Cloudflare Workers quando o tráfego já passa pela Cloudflare e você quer controlar a injeção do script no edge. Consulte o guia de Cloudflare Workers.