Eventos de servidor

​

Cuándo usar eventos de servidor

​

Cómo funciona la atribución en el servidor

El usuario escanea el código QR
    ↓
Llega a yoursite.com/?scnv=7ad26d4f-...
    ↓
El SDK guarda scan_session_id en localStorage
    ↓
El usuario completa un formulario de compra
    ↓
El navegador envía scan_session_id a tu API de pago
    ↓
Tu servidor envía un evento purchase con ese scan_session_id
    ↓
Scanova atribuye la compra al escaneo del código QR

• Incluirlo en un campo de formulario oculto
• Enviarlo en el cuerpo de la petición a tu API desde el JavaScript del frontend
• Guardarlo en la sesión del usuario en tu servidor (leyéndolo del parámetro de la URL al cargar la página)

// Read from SDK (browser-side)
// Note: _scnv is the SDK's internal storage key — structure may change.
// Use this pattern only if no higher-level SDK method is available.
const scanSessionId = localStorage.getItem('_scnv')
  ? JSON.parse(localStorage.getItem('_scnv')).sid
  : null;

// Include in your API call to your backend
await fetch('/api/checkout', {
  method: 'POST',
  body: JSON.stringify({ ...orderData, scan_session_id: scanSessionId })
});

​

Requisitos

• Un sitio de seguimiento creado en Análisis → Seguimiento de conversiones
• Una clave de API limitada al sitio (generada en la pestaña Configuración de seguimiento → Rastrear vía API del sitio)
• Que tu servidor pueda hacer peticiones POST HTTPS salientes
• Una forma de recibir el scan_session_id desde el navegador del usuario

​

Requisitos de seguridad

• Nunca expongas tu clave de API en código del frontend ni en JavaScript del lado del cliente
• Guarda la clave en una variable de entorno o en un gestor de secretos
• Rota las claves periódicamente desde el panel

​

Siguientes pasos