Events, Funnels & Conversions Eventos, Funnels & Conversiones

The RELO web pixel auto-captures user behavior on any website with zero per-site code. Funnels and what counts as a lead/conversion are configurable per client (and optionally per campaign) — no code change required. 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.

1. The pixel, in one line 1. El pixel, en una línea

Drop the snippet on any page. It works on any domain — capture is generic, there is no per-site backend code. Full install + verification lives in the Web Pixel guide; the essentials: 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)
</script>

After it is live, use Verify installation in the admin (or GET /api/clients/:id/pixel/activity) to confirm events are arriving in real time. 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. Events & the event catalog 2. Eventos & el catálogo de eventos

The pixel auto-captures a rich behavioral catalog with no extra code: page_view, click, scroll, section_view, engagement, cta_click, form_start, web_vitals and more. On top of that you can fire custom events: 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'
});

Everything lands in one event store keyed by event_name — analytics never needs per-source or per-site code (the same “zero per-source” model used for external sources). The event catalog auto-discovers whatever a client actually fires (last 90 days), so you can build funnels and conversion rules from real event names. 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.

Standard conversion event names Nombres estándar de eventos de conversión

Use these and it “just works” with no config: lead_submit, purchase, form_submit, signup, subscription, checkout_open. For a lead, send stage and a value (lead_value or revenue); add any x_* fields you want to pass through (zip, locale, A/B variant, etc.). Ú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 (configurable per client) 3. Funnels (configurables por cliente)

A funnel is an ordered list of named steps, each keyed by an event_name. RELO computes step→step conversion automatically. Define steps per client, and optionally override them per campaign (same scoping model as commission rules). 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: a client with no configured steps gets the legacy volume funnel (events ranked by count). Configure steps and the response switches to funnel_mode: "configured" with your labels and conversion %. 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)

Each step returns count, unique_users, conv_from_prev and conv_from_first. Admin endpoints (admin-only): 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=]

In the admin UI this lives on the “Funnels & Conversions” page per client (the Config tab, pixel/hybrid clients only): En el admin UI esto vive en la página “Funnels & Conversions” por cliente (la pestaña Config, solo clientes pixel/hybrid):

Build a funnel in the UI — click by click Arma un funnel en el UI — clic por clic

Mark your lead / conversion events Marca tus eventos de lead / conversión

4. Defining leads & conversions 4. Definir leads & conversiones

Each client can declare which events count as a billable lead/conversion in the leads catalog & analytics. With no config, the default list applies: lead_submit, purchase, form_submit, signup, subscription, checkout_open. Configure to override per client: 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 picks where the value comes from (lead_value or revenue); stage (raw / qualified / sold) rides on each event's properties. 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. Behavioral signals (rage / dead / double click) 5. Señales conductuales (rage / dead / double click)

The pixel infers a few UX-friction signals. They are heuristics and can have edge cases: El pixel infiere algunas señales de fricción de UX. Son heurísticas y pueden tener casos borde:

• dead_click & double_click are analytics-only — nothing downstream consumes them, so a false positive is harmless.dead_click y double_click son solo analytics — nada los consume aguas abajo, un falso positivo es inofensivo.
• rage_click feeds the lead quality score, so it is calibrated to avoid penalizing real users: it ignores clicks on disabled / loading buttons (a slow “Sending…” button is not rage), and the dead-click check whitelists intentionally-interactive elements (accordions, tabs, custom widgets).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. Per-website setup checklist 6. Checklist de setup por website

Rule of thumb: use the standard event names and it works out of the box; customize the funnel and conversion events per site only when you need to. 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.