Eventos, Funnels & Conversiones

El pixel web de RELO captura el comportamiento del usuario en cualquier sitio sin código por sitio. Los funnels y qué cuenta como lead/conversión son configurables por cliente (y opcionalmente por campaña) — sin cambiar código.

Flujo de eventos a funnel y conversión

1. El pixel, en una línea

Pega el snippet en cualquier página. Funciona en cualquier dominio — la captura es genérica, sin código de backend por sitio. La instalación + verificación completas están en la guía del Web Pixel; lo esencial:

<!-- one snippet, any website -->
<script>
(function(r,e,l,o){r.relo=r.relo||function(){(r.relo.q=r.relo.q||[]).push(arguments)};
o=e.createElement('script');o.async=1;o.src=l;e.head.appendChild(o);
})(window,document,'https://p.relo.mx/r.js');
relo('init', { client_id: 5 });   // your client id
relo('page');                     // page_view (auto on each load)
&lt;/script>

Una vez en vivo, usa Verify installation en el admin (o GET /api/clients/:id/pixel/activity) para confirmar que los eventos llegan en tiempo real.

2. Eventos & el catálogo de eventos

El pixel captura solo un catálogo conductual rico sin código extra: page_view, click, scroll, section_view, engagement, cta_click, form_start, web_vitals y más. Además puedes disparar eventos custom:

relo('event', 'lead_submit', {
  stage: 'raw',           // raw | qualified | sold
  lead_value: 1,          // or revenue: 1299.00
  x_zip: '33101',         // x_* fields pass through verbatim
  x_locale: 'es-MX'
});

Todo cae en un solo almacén de eventos indexado por event_name — analytics nunca necesita código por fuente ni por sitio (el mismo modelo “zero per-source” de las fuentes externas). El catálogo de eventos auto-descubre lo que un cliente realmente dispara (últimos 90 días), para que armes funnels y reglas de conversión con nombres de evento reales.

Nombres estándar de eventos de conversión

Úsalos y “jala” sin configurar nada: lead_submit, purchase, form_submit, signup, subscription, checkout_open. Para un lead, manda stage y un valor (lead_value o revenue); agrega los campos x_* que quieras pasar (zip, locale, variante A/B, etc.).

3. Funnels (configurables por cliente)

Un funnel es una lista ordenada de pasos nombrados, cada uno indexado por un event_name. RELO calcula la conversión paso→paso automáticamente. Define pasos por cliente y, si quieres, sobrescríbelos por campaña (mismo modelo de alcance que las reglas de comisión).

Fallback: un cliente sin pasos configurados usa el funnel por volumen (eventos ordenados por conteo). Configura pasos y la respuesta cambia a funnel_mode: "configured" con tus labels y % de conversión.

// Worked example — define a 3-step funnel
PUT /api/clients/5/funnel-steps
[
  { "step_order": 1, "event_name": "page_view",   "label": "Visita" },
  { "step_order": 2, "event_name": "form_start",  "label": "Empezó form" },
  { "step_order": 3, "event_name": "lead_submit", "label": "Lead" }
]

// Result (funnel endpoint)
funnel_mode: "configured"
 Visita        64   100%
 Empezó form   12   18.8%   // conv_from_prev
 Lead          17   141.7%  // more leads than form_starts (some skip the step)

Cada paso devuelve count, unique_users, conv_from_prev y conv_from_first. Endpoints admin (solo admin):

GET    /api/clients/:id/funnel-steps[?campaign_id=]
PUT    /api/clients/:id/funnel-steps[?campaign_id=]   // replace the ordered set
DELETE /api/clients/:id/funnel-steps[?campaign_id=]

En el admin UI esto vive en la página “Funnels & Conversions” por cliente (la pestaña Config, solo clientes pixel/hybrid):

Arma un funnel en el UI — clic por clic

1

Abre la página

Elige el cliente → pestaña Config → subpestaña Funnels.

2

Elige el alcance

Selector Scope arriba a la derecha: déjalo en Client default, o elige una campaña para darle su propio funnel.

3

Agrega pasos del catálogo

Usa el dropdown “Add an event as a step…” (solo eventos que el pixel ya disparó, menos los ya usados) → Add step.

4

Ordena & nombra

Reordena con los botones ↑/↓ y escribe un label claro para cada uno (ej. “Visita”, “Lead”).

5

Guarda

Save funnel (se habilita solo cuando hay cambios sin guardar). El % de conversión paso→paso aparece luego en Pixel Analytics → Funnel.

Marca tus eventos de lead / conversión

1

Encuentra el evento

En la tarjeta Conversion / lead events, los eventos de negocio (lead_submit, purchase, signup…) salen ordenados arriba; usa el buscador para filtrar el resto.

2

Marca & configura

Marca el evento como lead facturable, luego define su label y value field (lead_value o revenue).

3

Guarda

Save conversion events. Deja todo sin marcar para usar los defaults de la plataforma.

4. Definir leads & conversiones

Cada cliente puede declarar qué eventos cuentan como lead/conversión facturable en el catálogo de leads & analytics. Sin config, aplica la lista default: lead_submit, purchase, form_submit, signup, subscription, checkout_open. Configura para sobrescribir por cliente:

POST /api/clients/:id/conversion-events
{ "event_name": "lead_submit", "label": "Cotización",
  "is_billable": true, "value_field": "lead_value" }

GET    /api/clients/:id/conversion-events
DELETE /api/clients/:id/conversion-events/:eventName

value_field elige de dónde sale el valor (lead_value o revenue); el stage (raw / qualified / sold) viaja en las propiedades de cada evento.

5. Señales conductuales (rage / dead / double click)

El pixel infiere algunas señales de fricción de UX. Son heurísticas y pueden tener casos borde:

• dead_click y double_click son solo analytics — nada los consume aguas abajo, un falso positivo es inofensivo.
• rage_click alimenta el score de calidad del lead, por eso está calibrado para no castigar usuarios reales: ignora clicks en botones disabled / loading (un botón lento “Enviando…” no es rage), y el dead-click hace whitelist de elementos intencionalmente interactivos (accordions, tabs, widgets custom).

6. Checklist de setup por website

1

Crea el cliente (pixel)

Da de alta un cliente con tracking_type: pixel, define sus allowed_domains y eventos habilitados.

2

Instala el snippet & verifica

Pega el snippet (sección 1), luego usa Verify installation para confirmar que llegan eventos.

3

Confirma eventos en el catálogo

Navega el sitio; verifica que el catálogo muestre los nombres esperados (page_view, form_start, lead_submit…).

4

Define los pasos del funnel

Elige los pasos ordenados de este sitio (opcional — si lo omites usas el funnel por volumen).

5

Marca eventos de conversión / lead

Confirma qué eventos son leads/conversiones facturables (los defaults sirven para nombres estándar).

6

Asigna partners + tarifas de lead

Define las tarifas de lead por partner (por evento × stage, opcionalmente por campaña). Aquí se define el pago.

Regla práctica: usa los nombres de evento estándar y funciona de inmediato; personaliza el funnel y los eventos de conversión por sitio solo cuando lo necesites.