Saltar al contenido principal
Antes del lanzamiento. El snippet de instalación, con el host real y tu token, está en tu panel en cuanto tienes cuenta: si elegimos la tuya para la beta, o cuando Vero abra a todo el mundo. Los ejemplos de abajo usan placeholders.

Inicio rápido

Coloca el script donde quieras, head o body. defer recomendado. Sustituye YOUR_TOKEN por el token de tu sitio, en Panel → Ajustes → Instalación. Si usas un editor de IA como Cursor o Claude Code, copia el prompt de la guía de tu framework en el panel: añade el script y pasa la visita a tu checkout.

HTML
<script defer src="https://[tu-endpoint-vero]/t.js?s=YOUR_TOKEN"></script>

Y listo: las páginas vistas se registran solas. UTMs, referrer, idioma, zona horaria y ancho de pantalla se capturan automáticamente. Sin cookies y sin localStorage.

¿Prefieres atributos explícitos? Usa data-site-id y data-endpoint en vez del query param:

HTML
<script defer src="https://[tu-endpoint-vero]/t.js" data-site-id="YOUR_TOKEN"></script>

Módulos del tracker

El core pesa ~1,2 KB gz. Los módulos se activan por sitio desde Panel → Ajustes → Instalación. El bundle completo (los 9) pesa 2,7 KB gz, dentro del presupuesto de 2,8 KB. leave es el único módulo con dependencias: auto-activa scroll + engagement.

MóduloPesoQué hace
spa222 BParchea la History API para detectar pushState, replaceState y popstate. Navegación SPA automática en Next.js, React Router, Vue Router y SvelteKit.
scroll254 BMide la profundidad máxima de scroll (0–100%) por página.
engagement242 BCuenta el tiempo solo mientras la pestaña está visible. Alimenta "tiempo en página".
outbound403 BDetecta solo externos + mailto: + tel:. Sin etiquetar a mano.
downloads357 BPDF, zip, documentos y multimedia. Por extensión del href o atributo download.
leave270 BEvento final al abandonar la página con duración + profundidad de scroll. Auto-activa scroll + engagement.
vitals587 BCaptura LCP, CLS, INP, FCP y TTFB vía las APIs de Web Vitals y Performance.
experiments248 BRegistra exposiciones A/B de variantes aplicadas en el edge, para medir cada variante contra su evento objetivo: exposiciones, conversiones, tasa de conversión, mejora y significación estadística. Las exposiciones se registran en Pro.
checkout319 BAl hacer clic en un Payment Link de Stripe (buy.stripe.com) añade client_reference_id con el id de sesión; en un enlace de checkout de Lemon Squeezy, checkout[custom][vero]. El resto del enlace queda como estaba, nunca sustituye un valor que la página ya puso y no envía ningún evento. Un checkout en tu propio dominio no se reconoce: añade tú el parámetro con window.vero.session().

Eventos personalizados

La API pública son dos funciones: window.vero.track(name, props?) y window.vero.session(), que devuelve el id de sesión que acompaña a una venta. Las propiedades deben ser JSON-serializables y pesar menos de 4 KB. Vero descarta cualquier propiedad cuyo valor contenga un email (el evento se guarda igual) y lo indica en la cabecera X-Vero-Props-Dropped de la respuesta; aun así, no envíes emails ni ids de usuario.

JavaScript
window.vero.track('signup')

window.vero.track('upgrade_click', {
plan: 'pro',
trigger: 'banner',
})

window.vero.track('video_play', {
video_id: 'demo',
position_pct: 0,
})

Guía paso a paso: cómo medir eventos propios

El tracker encola los eventos y los envía con navigator.sendBeacon (con fetch keepalive de reserva). Los eventos de bots, DNT y Global Privacy Control se descartan en el cliente.

Los eventos alimentan los objetivos: apunta un objetivo a un nombre de evento en Panel → Objetivos y obtienes su tasa de conversión y los ingresos que hay detrás, por fuente de tráfico.

Navegación SPA

Activa el módulo spa en Panel → Ajustes → Instalación. Parchea la History API al cargar y emite un pageview en cada pushState, replaceState y popstate. No en cambios de hash: un ancla dentro de la página no es una página vista nueva. Sin tocar código de tu app.

Funciona con Next.js App / Pages Router, React Router, Vue Router, SvelteKit, view transitions de Astro y cualquier otro framework que use la History API.

Atribución de ingresos

Conecta tu proveedor de pagos pegando una sola URL y cada venta llega con la visita que la trajo, y por tanto con su fuente, UTM y referrer. Stripe, Lemon Squeezy y Paddle envían las ventas directamente a Vero. Si montas tu propio checkout, el endpoint de ingesta de más abajo es la alternativa. En Paddle, el id de la visita lo pasas tú como customData.vero al abrir el checkout: la receta está en Webhooks de ingresos.

Stripe con una sola URL

  1. En Vero, en la pantalla Conecta tus ventas: copia la URL de Stripe. Lleva el token de tu sitio, así que conecta cada cuenta de Stripe a un solo sitio: Stripe envía todas las ventas de la cuenta a cada destino, y cada sitio que la conecte las contaría todas.
  2. En Stripe, Desarrolladores → Webhooks: añade un destino con la última versión de la API, esa URL y los cuatro eventos de abajo. checkout.session.async_payment_succeeded solo llega con métodos de pago diferido, como el adeudo SEPA: sin él, esas ventas no cuentan.
  3. Pega en Vero el secreto de firma del destino (whsec_…).
  4. Activa el módulo checkout del tracker. Al hacer clic en un Payment Link añade client_reference_id con el id de sesión, así la venta llega con su visita.
URL para Stripe
https://[tu-endpoint-vero]/api/revenue/stripe/YOUR_SITE_TOKEN
Eventos de Stripe
checkout.session.completed
checkout.session.async_payment_succeeded
invoice.paid
charge.refunded

Qué se guarda: lo cobrado sin impuestos, en unidades menores y en la moneda del pago. En una Checkout Session, amount_total menos total_details.amount_tax; en una factura, amount_paid en proporción a total_excluding_tax. Una venta se identifica por su factura, o por su PaymentIntent si no la tiene, así que una Checkout Session y su primera factura son una sola venta y un evento reenviado cuenta una vez.

Atribución: la sesión sale de client_reference_id, de metadata.vero en la Checkout Session o de vero en los metadatos de la suscripción (subscription_data.metadata.vero), que lleva cada factura de esa suscripción: es la receta para las pruebas gratuitas. Una prueba gratuita que empieza en un Payment Link (un checkout con no_payment_required) se recuerda con su cliente, así que la primera factura pagada hereda su visita aunque no lleve subscription_data.metadata.vero; aun así, esa clave es la receta que cubre todos los casos. Un client_reference_id que no corresponde a ninguna visita del sitio se ignora. Una factura sin sesión hereda la fuente del primer pago atribuido del cliente, así que las renovaciones conservan su fuente; si el checkout de una suscripción nueva nombra una visita, esa visita manda, sea cual sea el evento que llegue primero. ¿Creas tú la Checkout Session? Envía window.vero.session() desde la página y ponlo como client_reference_id.

Reembolsos: charge.refunded resta de la venta que devuelve, encontrada por PaymentIntent, por factura o, si la factura se guardó sin su PaymentIntent, por el cliente, el importe y la fecha del cobro, y en la misma proporción sin impuestos, así que un reembolso parcial resta solo su parte. Un reembolso que llega antes que su venta se confirma con held: unknown_sale, se guarda y se resta en cuanto llega la venta; si la venta nunca llega, no cuenta.

Seguridad y pruebas: Vero comprueba la cabecera Stripe-Signature con HMAC-SHA256 sobre timestamp.payload, acepta cualquiera de las firmas v1 (Stripe envía dos mientras rota un secreto) y rechaza una marca de tiempo con más de 5 minutos de diferencia. Un evento con livemode: false se confirma con ignored: test_mode y no cuenta; el reembolso de prueba de una venta que Vero guardó sí cuenta. Un destino en modo de prueba tiene su propio secreto de firma: cuando acabes, pega el del modo live.

Tu propio checkout: el endpoint de ingesta

Envía cada venta desde tu servidor al endpoint de ingesta, con el id de sesión de la visita. Con el webhook de Stripe conectado, no envíes aquí también las mismas ventas de Stripe: contarían dos veces.

Desde tu servidor, en bash
curl -X POST https://[tu-endpoint-vero]/api/revenue \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_INGEST_SECRET' \
-d '{
  "session_id": "ses_abc123",
  "amount": 2900,
  "currency": "eur",
  "provider_event_id": "pi_3OxAbc...",
  "customer_id": "cus_xyz",
  "livemode": true,
  "metadata": { "plan": "pro_1m" }
}'

Campos: amount en unidades menores (céntimos), un número entero y sin impuestos, como lo guardan los webhooks: 29.99 o un importe negativo se rechazan con un 400, y 0 se ignora sin guardarse. provider_event_id (el id de tu cargo o factura) es obligatorio: hace la ingesta idempotente para que un reintento nunca cuente doble. session_id es opcional pero necesario para atribuir; tómalo de window.vero.session() en el navegador y llévalo por tu checkout. provider es opcional: una venta que llega sin él se guarda como de tu propio checkout.

El endpoint es idempotente sobre provider_event_id: los reintentos son seguros. Rellena livemode con el modo del pago. Una venta con livemode: false se confirma con ignored: test_mode y no cuenta. Un reembolso con livemode: false tampoco, salvo que su original_event_id sea una venta que Vero ya tiene guardada. Desde un handler de Lemon Squeezy, envía livemode: !meta.test_mode.

Los reembolsos van a POST /api/refund, con el mismo secreto de ingesta.

Un reembolso, en bash
curl -X POST https://[tu-endpoint-vero]/api/refund \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_INGEST_SECRET' \
-d '{
  "amount": 2900,
  "currency": "eur",
  "provider_event_id": "re_3OxAbc...",
  "original_event_id": "pi_3OxAbc...",
  "customer_id": "cus_xyz"
}'

amount es lo reembolsado, positivo y en unidades menores; Vero lo guarda como ingreso negativo, así que los ingresos bajan. provider_event_id es obligatorio y hace la llamada idempotente. Es el id del propio reembolso, nunca el de la venta: un reembolso enviado con el id de su venta se rechaza con un 400. Para restarlo en la fuente de la venta, Vero busca esa venta por session_id; si no lo envías, por original_event_id (el provider_event_id que mandaste con la venta); y si tampoco, por la última venta de ese customer_id.

Webhooks de ingresos

Stripe, Lemon Squeezy y Paddle envían las ventas directamente a Vero, sin código por tu parte. Todos los caminos deduplican por provider_event_id: un reintento del proveedor nunca cuenta doble.

ProveedorEndpointCabecera de firma
StripePOST /api/revenue/stripe/SITE_TOKENstripe-signature
Lemon SqueezyPOST /api/revenue/lemonsqueezy?s=SITE_TOKENx-signature
PaddlePOST /api/revenue/paddle?s=SITE_TOKENpaddle-signature

Cada sitio tiene su propio secreto de firma por proveedor (Panel → Ajustes → Conectar ingresos), guardado cifrado. Pega la URL del endpoint y ese secreto en los ajustes de webhook del proveedor; Vero verifica cada petición con HMAC SHA-256 antes de tocar la base de datos. Las firmas de Stripe y Paddle caducan a los 300 segundos, así que una petición capturada no se puede repetir más tarde.

URLs de webhook
https://[tu-endpoint-vero]/api/revenue/stripe/YOUR_SITE_TOKEN
https://[tu-endpoint-vero]/api/revenue/lemonsqueezy?s=YOUR_SITE_TOKEN
https://[tu-endpoint-vero]/api/revenue/paddle?s=YOUR_SITE_TOKEN

Eventos gestionados: los de Stripe de la sección anterior; order_created, order_refunded, subscription_payment_success y subscription_payment_refunded (Lemon Squeezy); transaction.completed, adjustment.created y adjustment.updated (Paddle). Suscríbete a esos en el proveedor. La renovación de una suscripción de Lemon Squeezy es una venta; su primer pago no cuenta dos veces, porque order_created ya lo guardó. Todo lo demás se confirma y se ignora.

Una sola definición de ingresos: lo cobrado, sin impuestos, menos reembolsos y antes de comisiones, igual en los tres proveedores. En Lemon Squeezy, total menos tax; en Paddle, grand_total menos grand_total_tax. Un reembolso se guarda como importe negativo por lo realmente devuelto, en la misma proporción sin impuestos, así que uno parcial resta solo su parte; el de Paddle cuenta cuando Paddle lo aprueba. Una venta cobrada gratis no se guarda.

Atribución: la visita viaja en los datos personalizados del checkout. El módulo checkout añade checkout[custom][vero] a los enlaces de checkout de Lemon Squeezy y Vero lo lee de meta.custom_data.vero. Con Paddle.js, pasa customData: { vero: window.vero.session() } al abrir el checkout y Vero lo lee de data.custom_data.vero. Una venta sin sesión hereda la fuente del primer pago atribuido del cliente, y un reembolso resta de la fuente de la venta que devuelve.

Un pago en modo de prueba (Stripe con livemode: false, Lemon Squeezy con test_mode o una transacción del sandbox de Paddle) se confirma con ignored: test_mode y no cuenta, así que una compra de prueba te sirve para comprobar la conexión sin sumar a tus ingresos. Vero distingue un webhook del sandbox de Paddle por las IP desde las que Paddle lo envía. Si la ingesta falla, Vero responde 5xx para que el proveedor reintente en vez de perder la venta. Los webhooks de ingresos funcionan en todos los planes: Hobby guarda cada venta y ve el total, y el desglose por fuente es de Pro.

Tracking edge / sin script

Mide pageviews sin una línea de JavaScript en cliente, desde edge middleware (Vercel/Next, Cloudflare, Netlify) o tu servidor. Los bloqueadores no pueden pararlo y funciona con JS desactivado. Se autentica con tu ingest secret y reenvía la IP, el UA y el país del visitante para calcular su hash real (la IP se hashea y se descarta, nunca se almacena).

middleware.ts (Vercel / Next)
import { NextResponse, type NextRequest, type NextFetchEvent } from 'next/server';

const UTM_KEYS = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content'];

export function middleware(req: NextRequest, event: NextFetchEvent) {
const url = req.nextUrl;
if (req.method === 'GET' && (req.headers.get('accept') || '').includes('text/html')) {
  event.waitUntil(fetch('https://[tu-endpoint-vero]/api/collect', {
    method: 'POST',
    headers: {
      'content-type': 'application/json',
      authorization: `Bearer ${process.env.VERO_INGEST_SECRET}`,
      'x-vero-ip': (req.headers.get('x-forwarded-for') || '').split(',')[0].trim(),
      'x-vero-ua': req.headers.get('user-agent') || '',
      'x-vero-country': req.headers.get('x-vercel-ip-country') || '',
    },
    body: JSON.stringify({
      type: 'pageview', site_id: process.env.VERO_SITE_TOKEN, path: url.pathname,
      referrer: req.headers.get('referer') || '',
      ...Object.fromEntries(UTM_KEYS.map((k) => [k, url.searchParams.get(k) || undefined])),
    }),
  }).catch(() => {}));
}
return NextResponse.next();
}

export const config = { matcher: ['/((?!_next|api|.*\\..*).*)'] };

Define VERO_SITE_TOKEN y VERO_INGEST_SECRET (Panel → Ajustes: el token en el fragmento de instalación, el secreto en Conecta tus ventas). Los snippets de Cloudflare Worker y Netlify Edge están en la página de setup. Desde un backend normal no hay que instalar nada: haz el mismo POST con fetch. POST /api/revenue y POST /api/refund usan ese mismo secreto de ingesta; POST /api/events usa una clave de API con escritura (más abajo).

Cuál usar. El script aporta las señales ricas del navegador (scroll, engagement, Web Vitals, SPA). El edge middleware da pageviews automáticos de todo el sitio, que los bloqueadores no pueden parar, sin dependencias. La API de servidor cubre eventos custom, revenue y reembolsos desde cualquier backend, el camino más fiable para el dinero. Para los pageviews, elige uno por sitio: el script siempre envía su propio pageview y Vero no deduplica, así que con los dos en las mismas páginas cada carga cuenta doble. Edge si quieres conteos que un bloqueador no puede parar; el script si quieres las señales del navegador y la sesión que une una venta a su visita. La API de servidor complementa a cualquiera de los dos.

Webhook saliente de ingresos

Vero también puede enviarte cada venta. Con un webhook saliente, cada venta o reembolso que Vero guarda en un sitio llega por POST a una URL tuya (tu CRM, Zapier, Make o tu propio servidor), con la visita de la que viene. Hay un webhook por sitio, en todos los planes.

Dónde se configura: Panel → Ajustes del sitio → Ventas → Webhook de ingresos. Pega la URL del endpoint y pulsa Guardar webhook. La URL debe ser https y un nombre de dominio público, no una IP ni un host local. Vero genera el secreto de firma la primera vez que guardas y lo muestra ahí mismo, solo a propietarios y administradores. Cambiar la URL conserva el secreto. No hay botón para rotarlo: quita el webhook y añádelo de nuevo para obtener uno nuevo.

La petición. Vero hace un POST a tu URL con Content-Type: application/json y la cabecera X-Vero-Signature, y el cuerpo es JSON. type es revenue.recorded para una venta y revenue.refunded cuando el importe es negativo.

JSON
{
  "type": "revenue.recorded",
  "data": {
    "site_id": "site_id",
    "amount": 4900,
    "currency": "USD",
    "provider": "stripe",
    "customer_id": "cus_123",
    "session_id": "visit id",
    "timestamp": 1760000000000
  }
}
CampoTipoQué hace
typestringrevenue.recorded para una venta, revenue.refunded para un reembolso.
data.site_idstringEl sitio al que pertenece la venta.
data.amountintegerEn la unidad menor de la moneda (céntimos), sin impuestos. Negativo en un reembolso.
data.currencystringLa moneda del pago.
data.providerstringDe dónde vino la venta, por ejemplo el proveedor que la envió.
data.customer_idstring | nullEl id del cliente, cuando el proveedor o tu llamada lo dio.
data.session_idstring | nullLa visita a la que se atribuye la venta, null si no tiene.
data.timestampintegerCuándo ocurrió la venta, en milisegundos desde el epoch.

Solo se envía una venta nueva. Un evento repetido del proveedor no se guarda otra vez y no dispara nada, y un pago de prueba o de importe cero tampoco, porque no se guarda. El cuerpo no lleva id de evento: si tu endpoint tiene que ser idempotente, construye la clave con los campos de arriba.

Verifica la firma. X-Vero-Signature es el HMAC SHA-256, en hexadecimal, del cuerpo tal como llegó, con tu secreto de firma completo (el que empieza por whsec_) como clave. Calcúlalo sobre el cuerpo en bruto, antes de parsear el JSON, y compáralo en tiempo constante.

Node.js
import { createHmac, timingSafeEqual } from 'node:crypto';

export const isFromVero = (rawBody, signature, secret) => {
  const expected = createHmac('sha256', secret).update(rawBody).digest('hex');
  const a = Buffer.from(expected);
  const b = Buffer.from(signature ?? '');
  return a.length === b.length && timingSafeEqual(a, b);
};

La firma no lleva marca de tiempo, así que no protege contra una repetición de la misma petición.

Si falla. Vero espera hasta 5 segundos y da la entrega por buena solo con una respuesta 2xx. No sigue redirecciones, así que una 3xx cuenta como fallo, igual que un error, un tiempo agotado o una URL que ya no pasa la comprobación de https y dominio público. Una entrega fallida entra en una cola y se reintenta en la pasada horaria: la primera vez una hora después, y tras cada nuevo fallo esperando una hora más que la anterior (2, 3, 4, 5). Cada reintento envía el mismo cuerpo, firmado con el secreto que tengas en ese momento. En total son 6 intentos. Tras el sexto fallo la entrega se descarta y no se reenvía sola. Un fallo de tu endpoint nunca retrasa ni afecta a cómo se guarda la venta.

Lo que no existe: un botón de prueba y un registro de entregas en el panel. Para comprobar tu endpoint, haz una compra real y mira si llega (un pago que el proveedor marca como de prueba no se guarda, así que no se envía nada). Las entregas no tienen orden garantizado.

API de servidor

Envía eventos personalizados desde tu backend con una clave de API con escritura (Cuenta → API keys: al crearla, elige Lectura y envío de eventos). Sirve para lo que pasa en tu servidor: cron jobs, workers o un webhook que recibes. El hash de visitante del evento sale de la IP y el UA de tu servidor, no de los de un visitante: aparece en los eventos principales, pero no pertenece a ninguna visita, así que no tiene fuente de tráfico ni cuenta como conversión de un objetivo. Para vincularlo al visitante, dispáralo en el navegador con window.vero.track()o envíalo por la ingesta edge de arriba (type: "custom" con event_name) reenviando su IP y su UA.

Bash
curl -X POST https://[tu-endpoint-vero]/api/events \
-H 'Authorization: Bearer vk_...' \
-H 'Content-Type: application/json' \
-d '{
  "type": "custom",
  "path": "/checkout/complete",
  "event_name": "purchase_completed",
  "props": { "plan": "pro_1m", "trial": false }
}'

El sitio se infiere de la clave de API. type normalmente es custom; usa pageview solo si tienes un motivo real. Una clave de solo lectura recibe 403 con insufficient_scope y el evento no se guarda.

Despliegues desde CI

Marca cada despliegue en tus gráficas para que una subida o una caída cuadre con la versión que la causó. Envía una petición desde tu pipeline cuando termine el despliegue, con el mismo secreto de ingesta que la ingesta edge. Es una función de Pro: en Hobby la petición responde 403.

Bash
curl -fsS -X POST https://[tu-endpoint-vero]/api/annotations \
-H "Authorization: Bearer $VERO_INGEST_SECRET" \
-H 'Content-Type: application/json' \
-d '{"label": "Deploy v1.4.2", "source": "manual", "url": "https://github.com/acme/web/releases/tag/v1.4.2"}' || true
.github/workflows/deploy.yml
- name: Mark the deploy in Vero
  if: success()
  run: |
    curl -fsS -X POST https://[tu-endpoint-vero]/api/annotations \
      -H "Authorization: Bearer ${{ secrets.VERO_INGEST_SECRET }}" \
      -H 'Content-Type: application/json' \
      -d '{"label": "Deploy ${{ github.sha }}", "source": "github"}' || true

label es obligatorio (una línea, hasta 200 caracteres). source es manual, github, vercel, netlify o cloudflare; url es opcional y debe ser https. En Vercel, añádelo al final del Build Command con $VERCEL_GIT_COMMIT_SHA en la etiqueta y solo cuando $VERCEL_ENV sea production. El || true evita que un fallo de red pare tu despliegue.

API de lectura

Lleva los agregados a tus propios paneles, herramientas de BI o informes semanales. Vale cualquier clave de API, de solo lectura o con escritura; requiere plan Pro.

Bash
curl https://[tu-endpoint-vero]/api/v1/stats?period=7d \
-H 'Authorization: Bearer vk_...'

Devuelve totals (visitas / visitantes / sesiones), top_pages, top_referrers y top_countries. Cada referente trae referrer, el valor guardado, y label, cómo se lee: android-app://com.linkedin.android/ llega como LinkedIn (Android). Periodos: today, 7d, 30d, 90d o from / to a medida.

Una venta sin visita registrada, como la de un checkout que no llevaba sesión, suma al total sin fuente: /api/v1/revenue y /api/v1/attribution la devuelven una sola vez en unattributed_cents, nunca como (direct). (direct) es una visita sin etiqueta UTM ni referrer de otro sitio. Cada plataforma es una sola fuente: facebook.com, l.facebook.com y m.facebook.com llegan como facebook; x.com, twitter.com y t.co, como x. Cada fila trae también label, cómo se lee: Direct, X, Facebook.

Cada campaña llega como { campaign, label, revenue_cents }, en by_campaign en /api/v1/revenue y en campaigns en /api/v1/attribution. La campaña es el utm_campaign del primer toque de la visita que trajo la venta, como la fuente; las devoluciones se restan. Una visita sin utm_campaign es (none). Diez campañas como máximo. Hasta el 18 de octubre de 2026 estos nombres eran direct, none y other, sin paréntesis, y chocaban con etiquetas reales con ese nombre.

Todos los endpoints de lectura aceptan los mismos parámetros de auth y periodo:

EndpointDevuelve
GET /api/v1/statsVisitantes, visitas, sesiones, top de páginas / referentes / países.
GET /api/v1/revenueIngresos, ingresos por fuente de tráfico (by_source) e ingresos por campaña UTM (by_campaign), en la moneda principal del sitio (no se suman importes entre monedas). Las ventas sin visita registrada suman al total sin fuente ni campaña, en unattributed_cents.
GET /api/v1/attributionIngresos por fuente UTM (sources) y por campaña UTM (campaigns) de la visita que los generó, con total_cents, currency y unattributed_cents. Cada lista muestra las diez primeras; el resto se suma en una última fila llamada (other), así que cualquiera de las dos listas más unattributed_cents suma el total.
GET /api/v1/goalsObjetivos de conversión y sus tasas.
GET /api/v1/vanityFuentes de tráfico que trajeron visitantes pero ningún ingreso en el periodo, con sus visitantes.
GET /api/v1/cohortsCohortes de ingresos: clientes de pago agrupados por la semana de su primer pago, con lo que pagó cada cohorte en cada semana posterior, con los reembolsos restados. Por defecto, 30d.
GET /api/v1/realtimeVisitantes en el sitio ahora mismo y sus páginas principales; window_seconds indica cuántos segundos hacia atrás abarca esa lectura.
GET /api/v1/anomaliesPicos y caídas de tráfico e ingresos detectados.

La auth es Authorization: Bearer con una clave de API Pro. Límite: 60 peticiones por minuto por IP; el contrato de errores completo está en Límites y errores.

Límites y errores

Los endpoints públicos se limitan por IP en ventanas fijas de 60 segundos:

EndpointLímite
GET /t.js600 / min
POST /api/collect200 / min
POST /api/events200 / min
POST /api/revenue, /api/refund240 / min
POST /api/revenue/lemonsqueezy, /paddle, /stripe/…240 / min
GET /api/v1/*60 / min

Superado el límite recibes 429 con una cabecera Retry-After (segundos hasta el reset). Todos los errores, en todos los endpoints, comparten la misma forma JSON de un solo campo:

JSON
{ "error": "Rate limit exceeded" }

Los códigos de estado son aburridos a propósito: 400 payload inválido, 401 clave o firma incorrecta, 403 el plan no incluye la función (o insufficient_scope: la clave no tiene el permiso que pide el endpoint), 404 token desconocido, 413 body de más de 64 KB (webhooks), 429 límite superado. Un 5xx merece reintento; un 4xx no.

Servidor MCP

El servidor MCP de Vero deja que Claude, Cursor y cualquier cliente del Model Context Protocol lean tu analítica (ChatGPT también, según tu plan de ChatGPT), para que preguntes a tu agente de IA por tu tráfico y tus ingresos mientras trabajas. Está alojado, sin servidor que mantener, y es de Pro. Solo lee: no puede enviar eventos ni cambiar nada.

Tools
  • vero_list_sites(): los sitios que puede leer la conexión, y cuál es el de por defecto.
  • vero_get_stats(period?, site?): visitantes, visitas, top de páginas, referentes, países.
  • vero_get_revenue(period?, site?): ingresos totales e ingresos por fuente.
  • vero_get_attribution(period?, site?): ingresos por fuente, más los ingresos sin visita registrada.
  • vero_get_goals(period?, site?): objetivos de conversión y sus tasas.
  • vero_get_cohorts(period?, site?): cohortes de ingresos por semana del primer pago.
  • vero_get_realtime(site?): quién está en el sitio ahora mismo.
  • vero_get_anomalies(site?): picos y caídas recientes de tráfico e ingresos.

Dale a tu cliente la URL del servidor. Abre Vero en tu navegador: inicias sesión (con tu código de dos pasos si lo usas), eliges un sitio y permites el acceso de solo lectura. Si marcas la casilla, también lee el resto de sitios que ves, en todos tus espacios de trabajo. No hay clave que copiar. La conexión dura mientras la uses y caduca tras 90 días sin uso; la revocas desde «Conecta tu IA» en el panel. Si tu cliente no inicia sesión con OAuth, usa una clave de API de solo lectura como header bearer en la misma URL; al crearla en «Conecta tu IA» puedes darle también acceso a todos tus sitios.

Claude Code

Ejecuta esto en tu terminal.

Claude Code
claude mcp add --transport http vero https://mcp.getvero.dev/mcp

Después escribe /mcp en Claude Code, elige vero e inicia sesión.

Tu cliente abre Vero en el navegador. Inicia sesión, elige un sitio y permite el acceso de solo lectura. También puedes dejar que lea el resto de sitios que ves. No hay clave que copiar.

Usar una clave de API

Ejecuta esto en tu terminal.

Claude Code
claude mcp add --transport http vero https://mcp.getvero.dev/mcp \
  --header "Authorization: Bearer vk_your_key"

Sustituye vk_your_key por la clave de solo lectura que creas en el panel.

Claude

Pega esta URL en tu cliente.

Claude
https://mcp.getvero.dev/mcp

En Claude, abre Conectores en los ajustes, añade un conector personalizado y pega esta URL. Funciona en claude.ai y en Claude Desktop.

Tu cliente abre Vero en el navegador. Inicia sesión, elige un sitio y permite el acceso de solo lectura. También puedes dejar que lea el resto de sitios que ves. No hay clave que copiar.

Usar una clave de API

Añade esto a claude_desktop_config.json.

claude_desktop_config.json
{
  "mcpServers": {
    "vero": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.getvero.dev/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer vk_your_key"
      }
    }
  }
}

Con clave, Claude Desktop se conecta mediante el puente mcp-remote, que necesita Node.js.

Sustituye vk_your_key por la clave de solo lectura que creas en el panel.

ChatGPT

Pega esta URL en tu cliente.

ChatGPT
https://mcp.getvero.dev/mcp

En ChatGPT, añade un servidor MCP personalizado y pega esta URL. Que puedas hacerlo depende de tu plan de ChatGPT y de los ajustes de tu espacio de trabajo.

Tu cliente abre Vero en el navegador. Inicia sesión, elige un sitio y permite el acceso de solo lectura. También puedes dejar que lea el resto de sitios que ves. No hay clave que copiar.

Cursor

Añade esto a ~/.cursor/mcp.json.

~/.cursor/mcp.json
{
  "mcpServers": {
    "vero": {
      "url": "https://mcp.getvero.dev/mcp"
    }
  }
}

Tu cliente abre Vero en el navegador. Inicia sesión, elige un sitio y permite el acceso de solo lectura. También puedes dejar que lea el resto de sitios que ves. No hay clave que copiar.

Usar una clave de API

Añade esto a ~/.cursor/mcp.json.

~/.cursor/mcp.json
{
  "mcpServers": {
    "vero": {
      "url": "https://mcp.getvero.dev/mcp",
      "headers": {
        "Authorization": "Bearer vk_your_key"
      }
    }
  }
}

Sustituye vk_your_key por la clave de solo lectura que creas en el panel.

VS Code

Añade esto a .vscode/mcp.json.

.vscode/mcp.json
{
  "servers": {
    "vero": {
      "type": "http",
      "url": "https://mcp.getvero.dev/mcp"
    }
  }
}

Tu cliente abre Vero en el navegador. Inicia sesión, elige un sitio y permite el acceso de solo lectura. También puedes dejar que lea el resto de sitios que ves. No hay clave que copiar.

Usar una clave de API

Añade esto a .vscode/mcp.json.

.vscode/mcp.json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "vero-key",
      "description": "Vero API key",
      "password": true
    }
  ],
  "servers": {
    "vero": {
      "type": "http",
      "url": "https://mcp.getvero.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${input:vero-key}"
      }
    }
  }
}

VS Code te pide la clave la primera vez y la guarda por ti, así que nunca se escribe en el archivo.

Codex

Ejecuta esto en tu terminal.

Codex
codex mcp add vero --url https://mcp.getvero.dev/mcp
codex mcp login vero

Tu cliente abre Vero en el navegador. Inicia sesión, elige un sitio y permite el acceso de solo lectura. También puedes dejar que lea el resto de sitios que ves. No hay clave que copiar.

Usar una clave de API

Añade esto a ~/.codex/config.toml.

~/.codex/config.toml
[mcp_servers.vero]
url = "https://mcp.getvero.dev/mcp"
bearer_token_env_var = "VERO_API_KEY"

Codex lee la clave de una variable de entorno. Defínela con la línea de abajo.

export VERO_API_KEY="vk_your_key"

Sustituye vk_your_key por la clave de solo lectura que creas en el panel.

Windsurf

Añade esto a mcp_config.json.

mcp_config.json
{
  "mcpServers": {
    "vero": {
      "serverUrl": "https://mcp.getvero.dev/mcp",
      "headers": {
        "Authorization": "Bearer vk_your_key"
      }
    }
  }
}

Abre el archivo desde Cascade, con su acción «Open MCP config file».

Sustituye vk_your_key por la clave de solo lectura que creas en el panel.

Este cliente se conecta con una clave de API de solo lectura.

Otro cliente

Añade esto a la configuración MCP de tu cliente.

Otro cliente
{
  "mcpServers": {
    "vero": {
      "url": "https://mcp.getvero.dev/mcp"
    }
  }
}

A un cliente MCP que inicia sesión con OAuth le basta esta URL. Uno que solo sabe enviar un header bearer usa la clave de API.

Tu cliente abre Vero en el navegador. Inicia sesión, elige un sitio y permite el acceso de solo lectura. También puedes dejar que lea el resto de sitios que ves. No hay clave que copiar.

Usar una clave de API

Añade esto a la configuración MCP de tu cliente.

Otro cliente
{
  "mcpServers": {
    "vero": {
      "url": "https://mcp.getvero.dev/mcp",
      "headers": {
        "Authorization": "Bearer vk_your_key"
      }
    }
  }
}

Sustituye vk_your_key por la clave de solo lectura que creas en el panel.

El fragmento de cada cliente, con lo que no hace el servidor, está en la página del servidor MCP.

period es uno de today, 7d, 30d, 90d (por defecto 7d; 30d en cohortes).

site es un dominio o un id de vero_list_sites. Sin él, cada herramienta lee el sitio con el que configuraste la conexión. La API REST sigue leyendo solo el sitio de la clave.

Privacidad y consentimiento

Vero no escribe nada en el dispositivo del visitante, no guarda nada que identifique a nadie y solo usa la IP en memoria, para un hash con sal diaria. Qué implica eso para tu gestión del consentimiento lo decide tu equipo legal; en /transparency tienes cada campo que envía el tracker.

  • Sin cookies y sin localStorage.
  • La identidad del visitante es un hash diario SHA-256(IP + UA + día + sitio + secret), propio de cada sitio. La IP nunca se almacena.
  • Respeta navigator.doNotTrack === '1' y navigator.globalPrivacyControl: esos visitantes no se registran en absoluto.
  • Los user-agents de bots (crawlers, headless, navigator.webdriver) se descartan en cliente y se reverifican al ingerir.
  • Retención Hobby 30 días, Pro 2 años. Al borrar la cuenta, sus datos se borran en el acto. Solo las copias de seguridad nocturnas guardan las filas borradas hasta que caducan, como mucho 30 días.

¿Necesitas ayuda?

¿Nuevo en Vero? Las guías te llevan paso a paso por la instalación, los eventos y los ingresos. ¿Atascado con la integración o encontraste un bug? Escríbenos a hello@getvero.dev y te respondemos.

Beta elegida a mano, lista abierta

Pide plaza en la beta.

Cualquiera puede apuntarse a la lista. Las cuentas que elegimos tienen Pro gratis durante toda la beta.

Al apuntarte aceptas recibir avisos del lanzamiento y nuestra Política de Privacidad.

Ver la demo