Web Pixel — referencia técnica

Referencia del script r.js que corre en los sitios de clientes pixel. Para el alta paso a paso de un cliente nuevo (wizard, snippet, verificación, troubleshooting) usa la guía Pixel Setup.

Qué es

El Relo Pixel es un snippet de JS (~50 KB, async, todo en try/catch) que corre en cualquier sitio web. Captura page views, formularios, compras, leads, engagement, scroll, clics y ~50 señales más. Los eventos van a p.relo.mx/e (sendBeacon con fallback XHR, cola con re-queue, batch de 10), el worker de pixel los enriquece con geo/UA y los reenvía al ingest Go, que resuelve identidad (cookie + fingerprint + hashes de PII), atribuye por click_id y escribe en ClickHouse en segundos.

API relo() — comandos

El snippet crea una cola (relo.q) hasta que r.js termina de cargar; después las llamadas se procesan directo. Comandos soportados:

Opciones de init

Consent bitmask

Señales del browser que fuerzan bits off: navigator.doNotTrack apaga DSP (0x04); navigator.globalPrivacyControl apaga analytics + DSP (0x05).

Catálogo de eventos

API de Leads — relo('lead', {...})

Para clientes lead-gen (seguros, créditos, trials SaaS), usa la API explícita relo('lead', payload) en tu handler de submit. Distinta del evento automático form_submit: relo('lead', ...) te deja decidir qué submits califican como leads y adjuntar metadata (product, form_id, stage, lead_value) que aparece en el tab de Leads del partner. Incluye dedup client-side (30 min por email+form_id en localStorage) para no duplicar al refrescar la thank-you page.

// On form submit:
relo('lead', {
  email: 'user@example.com',    // hashed SHA-256 client-side
  phone: '+525555551234',       // hashed SHA-256 client-side
  name: 'Juan Perez',           // identity graph only
  product: 'Auto Insurance',    // shown in Leads tab
  form_id: 'quote-home-v2',
  stage: 'raw',                 // raw / qualified / rejected
  lead_value: 50,
  currency: 'USD',
  utm_source: 'facebook',
  utm_campaign: 'spring-2026',
  extra: {                      // namespaced to x_* in Relo
    coverage: 'full',
    vehicle_year: 2023
  }
});

Campos planos permitidos: product, form_id, lead_source, stage, lead_value, currency, utm_campaign, utm_source, notes, quote_id, product_type. Lo que pase en extra: {...} se copia con prefijo x_ (strings/numbers/booleans, máx 500 chars).

Atribución: el click wrapper t.relo.mx/c/:code pone la cookie _relo_cid en .relo.mx (visible server-side por p.relo.mx) y agrega &relo_click_id=<ulid> a la URL de destino; el pixel adopta ese valor y lo fija como cookie first-party en el dominio del cliente. Cada evento lleva el click_id y el ingest lo resuelve contra Redis para atribuir al partner y campaña. TTL: 30 días.

Session Replay (rrweb)

Para clientes pixel que opten, Relo graba sesiones DOM completas con rrweb y las reproduce en admin. Útil para depurar abandono de formulario y UX confuso. Apagado por default.

Playback: Pixel Analytics → tab Replays (/v2/c/:slug/pixel-analytics, solo admin). Click a session → lazy-loads rrweb-player → stitches chunks from R2.

Tracking Types: MMP vs Pixel vs Hybrid

Cada cliente tiene un tracking_type que controla qué dashboards ven los partners. Las campañas pueden sobrescribir el default.

Se define al crear el cliente: wizard /v2/clients/new paso 1 (Identity). Se cambia después en Edit basics (/v2/c/:slug/setup-edit). Por campaña: Campaign Detail → Settings → Tracking Type o paso 1 del Campaign Launch Wizard.