Configurar fingerprinting

Configure cside fingerprinting cargando el script del navegador temprano, recopilando telemetría con sendClientTelemetry y enviando el token de sesión devuelto a su backend.

Elija una opción de implementación

Método	Mejor para	Guía de producción
Cloudflare Workers	Sitios ya enrutados por Cloudflare	Bueno para inyección en edge y despliegue por rutas limitadas
Inyección directa de script	La mayoría de sitios de producción	Recomendado cuando controla el HTML o app shell
Paquete NPM	Apps con frameworks compatibles	Recomendado cuando el paquete coloca el script temprano
Google Tag Manager	Validación rápida sin cambios de código	Úselo solo para pruebas cuando el orden de carga importa

Recomendación de dominio del cliente

Use la configuración DNS para usar su propio dominio siempre que sea posible. cside ofrece esto para evitar inquietudes de privacidad relacionadas con dominios de terceros, hacer que el script parezca first-party para el navegador y evitar que los bloqueadores de anuncios del navegador o el bloqueo client-side interfieran con el script o afecten la precisión de las detecciones.

Si cside le proporciona una URL de script dedicada, use esa URL exacta en cada método de instalación. Los ejemplos siguientes usan placeholders.

Servir el script desde su propio dominio

Esta opción le permite servir el script de fingerprinting desde un subdominio que usted controla, como fingerprint.example.com. Está pensada para cuentas de producción que quieren entrega first-party del script y control más estricto de CSP.

Setup habilitado por cuenta

Los dominios personalizados de fingerprint requieren que cside aprovisione un hostname de destino para su cuenta. Contacte a cside antes de agregar registros DNS.

Configuración DNS

Elija un subdominio, por ejemplo fingerprint.example.com
Pida a cside su hostname de destino de fingerprinting
Agregue un registro CNAME desde su subdominio al destino de cside
Espere la propagación DNS y la validación del hostname por cside
Use su subdominio como origen del script

Ejemplo de registro DNS:

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

Después de la validación, use la URL del script en el dominio del cliente:

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

Actualice su CSP para permitir el subdominio del cliente en script-src y connect-src.

Inyección directa de script

Agregue el script en el <head> de la página antes de llamar funciones de fingerprinting.

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

Luego llame a sendClientTelemetry después de que cargue el script. Puede llamarla sin argumentos o pasar un objeto externalIds opcional.

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

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

Envíe el token de sesión a su backend e intercámbielo con la API de cside. Consulte la Events API para el flujo completo.

Paquete NPM

Para frameworks compatibles, use el paquete de cside que agrega el script del navegador al app shell. Esto es útil cuando su framework controla el renderizado del documento.

El paquete debe cargar el mismo script de cside antes de que su app llame a sendClientTelemetry.

Contacte al equipo de cside para recibir ayuda si le interesa usar el método de instalación NPM.

Google Tag Manager

GTM sirve para pruebas rápidas, pero no garantiza que cside cargue antes que otros scripts. Use una tag Custom HTML con un trigger All Pages para validar el flujo.

Use GTM para validación

Para enforcement en producción o recopilación de datos de alta confianza, use inyección directa, un paquete NPM o Cloudflare Workers.

Cloudflare Workers

Use Cloudflare Workers cuando el tráfico ya pasa por Cloudflare y quiera controlar la inyección del script en edge. Consulte la guía de Cloudflare Workers.