> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Resumen del SDK de navegador

> Registra el comportamiento en tu sitio tras un escaneo de código QR: vistas de página, clics, profundidad de desplazamiento, envíos de formulario y eventos.

El SDK de navegador de Scanova es un snippet de JavaScript ligero (\~10 KB) que añades a tu sitio una sola vez. Después registra automáticamente vistas de página, clics en enlaces, profundidad de desplazamiento y envíos de formulario, todo ello atribuido al escaneo del código QR que llevó a esa persona a tu sitio.

## Qué hace el SDK

Cuando alguien llega a tu sitio mediante un escaneo de código QR, la URL incluye un parámetro `scnv`:

```
https://yoursite.com/?scnv=7ad26d4f-3181-4ef8-b6ca-b8f59499dd43
```

El SDK:

1. **Lee el parámetro `scnv`** y lo guarda en `localStorage` (caducidad de 60 días)
2. **Registra los eventos integrados** automáticamente (vistas de página, clics, desplazamiento, formularios) según tu configuración
3. **Adjunta la atribución**: cada evento lleva el `scan_session_id`, que lo vincula con el código QR de origen
4. **Persiste entre páginas**: si la persona navega a otra página de tu sitio, la atribución la acompaña

## Eventos registrados automáticamente

Se activan con un solo interruptor en las opciones de init:

| Opción         | Qué registra                                             | Tipo de evento enviado |
| -------------- | -------------------------------------------------------- | ---------------------- |
| `autoPageview` | Cada carga de página                                     | `pageview`             |
| `autoClicks`   | Clics en enlaces, botones y elementos `[role="button"]`  | `click`                |
| `autoForms`    | Envíos de formulario                                     | `form_submit`          |
| `autoScroll`   | Profundidad de desplazamiento al 25 %, 50 %, 75 % y 90 % | `scroll`               |

Todos los detalles: [Eventos automáticos](/es/conversion-tracking/browser/auto-tracking)

## Eventos personalizados

Más allá del registro automático, puedes enviar cualquier evento desde tu código JavaScript:

```javascript theme={null}
scanova('track', 'cta_click', { button: 'Start Free Trial' });
```

Todos los detalles: [Eventos personalizados](/es/conversion-tracking/browser/custom-events)

## Requisitos

* Un sitio web donde puedas editar la sección `<head>` del HTML o añadir una etiqueta mediante Google Tag Manager
* Un sitio de seguimiento creado en **Análisis → Seguimiento de conversiones**, con tu dominio añadido en **Allowed Domains**
* El `site_id` del panel

## Antes de instalar

Comprueba que:

* [ ] Tu sitio de seguimiento está creado en el panel
* [ ] El dominio de tu sitio figura en **Allowed Domains** para ese sitio
* [ ] Sabes dónde añadir una etiqueta `<script>` (plantilla HTML, sección de encabezado del CMS o GTM)
* [ ] Los códigos QR están vinculados a este sitio de seguimiento en el panel de Scanova

## Siguientes pasos

<CardGroup cols={2}>
  <Card title="Instalar el SDK" icon="download" href="/es/conversion-tracking/browser/install">
    Añadir el snippet directamente o mediante Google Tag Manager.
  </Card>

  <Card title="Configuración del SDK" icon="sliders" href="/es/conversion-tracking/browser/sdk-configuration">
    Todas las opciones de init con valores por defecto y ejemplos.
  </Card>

  <Card title="Eventos automáticos" icon="bolt" href="/es/conversion-tracking/browser/auto-tracking">
    Qué datos captura cada función de registro automático.
  </Card>

  <Card title="Eventos personalizados" icon="sparkles" href="/es/conversion-tracking/browser/custom-events">
    Registrar acciones concretas desde tu código JavaScript.
  </Card>
</CardGroup>
