Una línea de código, y todo lo demás cuando lo necesites
El código de seguimiento ocupa unos 5 KB comprimido y funciona en cualquier web. Para eventos, login, e-commerce y datos del servidor hay una API JavaScript ligera y una API de servidor.
<script defer src="https://visualclicks.de/t/fwa.js" data-site="vc_…"></script>Eventos, propiedades y login
Envía tus propios eventos, como búsquedas, descargas o clics, con fwa.track(), e información adicional con fwa.set(): para el evento, la página, la sesión o de forma permanente para el usuario. Tras el login, fwa.identify() vincula la sesión con tu número de cliente.
Cada propiedad nueva aparece automáticamente en el registro de propiedades y queda disponible en filtros, tarjetas y segmentos.
// evento con propiedades
fwa.track('search', { query: 'tienda', results: 12 });
// propiedad para toda la sesión
fwa.set('customer_type', 'vip', { scope: 'session' });
// vincular el login, cerrar sesión
fwa.identify('cust_4711');
fwa.reset();
// consentimiento desde tu banner de cookies
fwa.consent.grant(['analytics', 'recording']);El proceso de compra en eventos
La API de e-commerce sigue la estructura de Google Analytics 4: vista de producto, carrito, caja, envío, pago, compra y reembolso, cada uno con artículos, marca, categorías, precio y cantidad.
Si tu tienda ya tiene un modelo de datos de GA4, trasladarlo requiere poco esfuerzo.
fwa.ecommerce.viewItem({ item_id: 'ZT-100', item_name: 'Tienda de trekking',
item_brand: 'NordCamp', item_category: 'Tiendas', price: 249 });
fwa.ecommerce.addToCart({ item_id: 'ZT-100', price: 249, quantity: 1 });
fwa.ecommerce.beginCheckout(items, { value: 249 });
fwa.ecommerce.purchase(items, { transaction_id: 'A-1001',
value: 249, tax: 39.76, shipping: 0, currency: 'EUR' });Pedidos y crawlers de IA directamente desde el servidor
Con una clave de servidor de los ajustes, tu backend envía eventos directamente a VisualClicks, sin depender del navegador, los bloqueadores de anuncios ni el consentimiento. Los pedidos se combinan con los datos del navegador mediante el número de pedido.
Los accesos de crawlers de IA se comunican de la misma forma, o subes un log de accesos en formato «combined».
- Varias claves por web, revocables una a una
- La clave se muestra una sola vez y solo se guarda su hash
- Exclusión de IPs para el tráfico interno
curl -X POST https://visualclicks.de/api/s/v1/events \
-H "Authorization: Bearer vcsk_…" \
-H "Content-Type: application/json" \
-d '{"source":"server","e":[{"t":"ecommerce","n":"purchase",
"u":"https://shop.example/gracias",
"x":{"transaction_id":"A-1001","value":249}}]}'Asíncrono
Se carga con defer y nunca bloquea la página
Aplicaciones de una página
Cambios de página vía History API, automáticos
Sin programar
Mide clics con data-fwa-event
Varias webs
Código y ajustes propios por web
Preguntas frecuentes
¿Dónde pongo el código de seguimiento?
En el <head> de cada página; en la mayoría de CMS y tiendas online, a través de la plantilla o de un campo para scripts propios. El código se carga de forma asíncrona y no bloquea la página.
¿Funciona con aplicaciones de una sola página (React, Vue, Next.js)?
Sí. Los cambios de página a través de la History API se registran automáticamente como vistas de página.
¿Cómo mido clics en botones sin programar?
Con el atributo data-fwa-event en el elemento, por ejemplo data-fwa-event="newsletter_click". Las propiedades adicionales se añaden con data-fwa-prop-….
¿Para qué sirve una clave de servidor?
Para que tu servidor envíe eventos directamente: pedidos, reembolsos o accesos de crawlers de IA. Las claves de servidor nunca deben estar en el código fuente de la web y se pueden revocar una a una.
¿Listo para la primera línea de código?
Solicita tu acceso. Después basta con una línea de código: las primeras visitas aparecen en tiempo real.