Inicio rápido: en marcha en 5 pasos

Esta guía recoge los pasos mínimos para pasar de una cuenta de Scanova a un seguimiento de eventos en marcha. Para afinar la configuración, sigue los enlaces de cada paso.

Paso 1: crea un sitio de seguimiento

Un sitio de seguimiento representa el dominio de una web. Necesitas uno antes de instalar el SDK o enviar eventos de servidor.

Inicia sesión en el panel de Scanova
Ve a Análisis → Seguimiento de conversiones
Haz clic en Create Site
Escribe un nombre para el sitio y añade tus dominios permitidos (por ejemplo yoursite.com)
Guarda

Al guardar, Scanova genera un site_id único para este sitio. Lo usarás en el fragmento y en todas las llamadas a la API.

Añade todos los nombres de host donde vaya a ejecutarse el fragmento de seguimiento: tanto la variante con www como la que no lleva www, además de los dominios de staging en los que quieras probar.

Paso 2: instala el SDK del navegador

En Análisis → Seguimiento de conversiones → Configurar el seguimiento de conversiones, selecciona Configuración de seguimiento en el sitio que acabas de crear y quédate en la pestaña Insertar script
Ajusta los interruptores de captura automática (páginas vistas, clics, envíos de formularios) y el modo de depuración
Copia el fragmento generado
Pégalo antes de </head> en la plantilla HTML de tu sitio

<head>
  <!-- other tags -->
  <script>
  (function(w,d,s,o,f,js,fjs){
    w['ScanovaTrackingObject']=o;w[o]=w[o]||function(){(w[o].q=w[o].q||[]).push(arguments)};
    js=d.createElement(s),fjs=d.getElementsByTagName(s)[0];
    js.id=o;js.src=f;js.async=1;fjs.parentNode.insertBefore(js,fjs);
  })(window,document,'script','scanova','https://cdn.scanova.io/ct/js/qcg.min.js');

  scanova('init', 'YOUR_SITE_ID', {
    autoPageview: true,
    autoClicks: true,
    autoForms: true,
    autoScroll: true
  });
  </script>
</head>

¿Usas Google Tag Manager? Consulta Instalación con GTM.

Paso 3: enlaza tus códigos QR con el sitio de seguimiento

Para que los eventos se atribuyan a un código QR concreto, el dominio de destino de ese código debe coincidir con uno de los Allowed Domains de tu sitio de seguimiento.

Abre un código QR en el panel de Scanova
Ve a su configuración de Settings o Redirect
Comprueba que la URL de destino está en un dominio de los que añadiste en el paso 1 (por ejemplo yoursite.com)

Si el código QR redirige a un dominio que no está en los Allowed Domains del sitio de seguimiento, los eventos del navegador procedentes de ese dominio se rechazan con 403. La atribución solo funciona cuando el dominio de destino coincide.

Paso 4: comprueba que el SDK funciona

Abre tu web en un navegador
Abre las DevTools y ve a la pestaña Network
Filtra por /ct
Recarga la página: deberías ver una petición POST a https://t.scanova.io/ct con respuesta 200

Si ves la petición, el SDK funciona. Si no, consulta Resolución de problemas del SDK del navegador.

Paso 5: (opcional) envía conversiones desde el servidor

Para confirmaciones de compra, registros u otros eventos del backend, genera una clave de API y envía los eventos desde tu servidor.

Abre Configuración de seguimiento en ese mismo sitio y luego la pestaña Rastrear vía API
Selecciona Add New Key, ponle un nombre, cópiala y guárdala en un sitio seguro
Envía una petición POST a https://track.scanova.io/server-events:

curl -X POST "https://track.scanova.io/server-events" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "site_id": "YOUR_SITE_ID",
    "event_name": "purchase",
    "scan_session_id": "SCAN_SESSION_ID_FROM_BROWSER",
    "conversion_value": { "amount": 49.99, "currency": "USD" }
  }'

Nunca expongas tu X-API-Key en código que se ejecute en el navegador. Es solo para uso en el servidor.

Guía completa: Enviar eventos de servidor

Paso 6: consulta tus datos

Abre Análisis → Seguimiento de conversiones en el panel, selecciona tu sitio y abre la pestaña Analytics. Tus primeros eventos deberían aparecer entre 30 y 60 segundos después de comprobar el SDK en el paso 3.

Por dónde seguir

Configuración del SDK del navegador

Todas las opciones del SDK: interruptores de captura automática, modo de depuración y más.

Eventos propios

Registra acciones concretas, como clics en botones o formularios completados.

Eventos de servidor

Envía conversiones del backend de forma segura y con atribución.

Guía de SPA y frameworks

Instrucciones de instalación para React, Next.js y Vue.

Visión general

SDK del navegador

En el servidor

Referencia de API

Recursos

Paso 1: crea un sitio de seguimiento

Paso 2: instala el SDK del navegador

Paso 3: enlaza tus códigos QR con el sitio de seguimiento

Paso 4: comprueba que el SDK funciona

Paso 5: (opcional) envía conversiones desde el servidor

Paso 6: consulta tus datos

Por dónde seguir

Configuración del SDK del navegador

Eventos propios

Eventos de servidor

Guía de SPA y frameworks

​Paso 1: crea un sitio de seguimiento

​Paso 2: instala el SDK del navegador

​Paso 3: enlaza tus códigos QR con el sitio de seguimiento

​Paso 4: comprueba que el SDK funciona

​Paso 5: (opcional) envía conversiones desde el servidor

​Paso 6: consulta tus datos

​Por dónde seguir

Configuración del SDK del navegador

Eventos propios

Eventos de servidor

Guía de SPA y frameworks

Paso 1: crea un sitio de seguimiento

Paso 2: instala el SDK del navegador

Paso 3: enlaza tus códigos QR con el sitio de seguimiento

Paso 4: comprueba que el SDK funciona

Paso 5: (opcional) envía conversiones desde el servidor

Paso 6: consulta tus datos

Por dónde seguir