> ## Documentation Index
> Fetch the complete documentation index at: https://docs.komerza.com/llms.txt
> Use this file to discover all available pages before exploring further.
# SDK de Analytics
> Recupere el análisis de visitantes en su panel de Komerza con nuestro ligero script de analytics
## Descripción general
El SDK de Analytics de Komerza le permite rastrear el comportamiento de los visitantes en su sitio web personalizado y ver el análisis directamente en su panel de Komerza. Con solo una etiqueta de script, obtendrá información completa sobre los visitantes, incluyendo vistas de página, sesiones de usuario, seguimiento de conversiones y más.
Acceda a sus análisis de visitantes en el panel de Komerza
## Características
Gestión automática del consentimiento de cookies con cookies esenciales/opcionales
Solo incluya el script con su ID de tienda - no se requiere configuración
compleja
Vea datos de visitantes instantáneamente en su panel de Komerza
Respeta la privacidad del usuario con consentimiento de cookies transparente y aislamiento Shadow DOM
## Inicio rápido
### Integración con un solo script
Agregue el script de analytics a sus páginas HTML con su ID de tienda:
```html theme={null}
Mi tienda
Bienvenido a mi tienda
```
Reemplace `your-store-id` con su ID de tienda Komerza real desde su panel. El
script de analytics gestiona automáticamente el cumplimiento del GDPR
mostrando un aviso de consentimiento de cookies a los visitantes.
## Flujo de consentimiento de cookies
Cuando un visitante llega por primera vez a su sitio:
1. **Vista de página inmediata**: Se registra una vista de página solo con IP inmediatamente (compatible con GDPR)
2. **Visualización del aviso de cookies**: Aparece un aviso compatible con GDPR en la parte inferior derecha
3. **Temporizador de 20 segundos**: Sin respuesta, el seguimiento "Solo requerido" se activa automáticamente
4. **Elección del usuario**: El visitante puede elegir "Solo requerido" o "Aceptar todo" en cualquier momento
5. **Almacenamiento de preferencias**: La elección se recuerda para futuras visitas (vencimiento de cookie después de 1 hora)
* ID de visitante aleatorio (sin huella digital)
* Tipo de dispositivo y nombre del navegador
* Información de referente
* Seguimiento de sesión (vencimiento después de 1 hora)
* Sin seguimiento entre sesiones
* Huella digital del navegador para ID de visitante estable
* Seguimiento de analytics completo
* Información mejorada sobre el comportamiento del usuario
* Seguimiento de conversiones y objetivos
* Métricas de rendimiento detalladas
* Seguimiento entre sesiones
## Control manual de consentimiento
Si desea controlar el consentimiento mediante programación (p. ej., banner de cookies personalizado):
```html theme={null}
```
## Características de privacidad
* **IDs de visitantes aleatorios**: El seguimiento solo requerido usa IDs aleatorios criptográficos (sin huella digital)
* **Vencimiento corto**: Todas las cookies vencen después de 1 hora
* **Sin seguimiento entre dominios**: Las cookies son específicas del sitio
* **Anonimización de IP**: Las vistas de página esenciales son solo IP, sin ID de visitante
## Política de seguridad de contenido (CSP)
Para sitios con encabezados CSP, agregue lo siguiente a su configuración CSP:
```http theme={null}
Content-Security-Policy:
script-src 'self' https://cdn.komerza.com;
connect-src 'self' https://m-api.komerza.com;
```
El script de analytics no requiere integración de nonce CSP ya que se carga
desde un CDN de confianza. Sin embargo, asegúrese de que
`https://cdn.komerza.com` esté en su directiva `script-src`, y
`https://m-api.komerza.com` en su directiva `connect-src`.
## Ver sus analytics
Una vez que el script esté instalado y los visitantes comiencen a llegar a su sitio:
1. **Inicio de sesión en el panel**: Visite [dashboard.komerza.com](https://dashboard.komerza.com)
2. **Navegue a Analytics de visitantes**: Haga clic en la sección "Visitantes"
3. **Ver información**: Vea datos de visitantes en tiempo real e históricos
4. **Rastrear rendimiento**: Supervise las tasas de conversión y el comportamiento del usuario
## Compatibilidad con bloqueadores de anuncios
El script de analytics usa el nombre de archivo `ka.min.js` que tiene menos probabilidades de ser bloqueado por bloqueadores de anuncios en comparación con nombres de archivo que contienen "analytics" o "tracking". Sin embargo, algunos bloqueadores agresivos aún pueden bloquear las solicitudes de analytics.
## Soporte
Acceda a sus análisis de visitantes e informes