Admin Playbook
Guía completa para administrar clientes en Relo — desde el onboarding hasta el go-live.
Este playbook es el recorrido completo para dar de alta y operar un cliente en Relo. Cubre el wizard de onboarding, segmentos, partners, atribución, comisiones, presupuestos, campañas, fraude, pixel y AppsFlyer. Si solo lees una guía, lee esta.
Mapa del flujo de admin
El panorama general
Relo conecta clientes (marcas que pagan por performance) con partners (afiliados que generan tráfico). El flujo de dinero es simple:
Cliente paga a Relo → Relo paga al partner → Relo se queda el margenCada cliente elige un tipo de tracking. Esa decisión define todo el setup posterior.
MMP
Mobile measurement partner (AppsFlyer). Installs y compras in-app. Ideal para apps móviles y e-commerce con app nativa.
Pixel
Snippet web en el sitio del cliente. Page views, forms, leads y compras. Ideal para lead-gen, funnels y compras web.
Hybrid
Ambos: feed MMP + pixel web para el mismo cliente. Para marcas con app y sitio web activos.
¿Quieres el tour conceptual primero? Lee Cómo funciona Relo. Si no, sigue los pasos de abajo en orden.
Onboarding paso a paso
Crear el cliente
Ve a /v2/clients/new y corre el wizard de onboarding. Captura identidad (nombre, slug, tipo de tracking, moneda, zona horaria), segmentos, partners, atribución, comisiones, presupuestos, campañas y reglas de fraude. Todo se crea en una sola transacción atómica via POST /api/clients/onboard. Si algo falla, no se crea nada.
Definir segmentos
Los segmentos son grupos de producto sobre los que se paga, por ejemplo MX, VD, DA, WR, etc. Cada uno trae comisión default y color. Puedes empezar vacío, definir los tuyos o copiar los defaults de un cliente de referencia.
Agregar partners
Crea partners nuevos o vincula existentes. Para cada uno define sus valores de atribución (tokens que etiquetan su tráfico, ej. sub2 = qapartner) y los segmentos en los que está habilitado.
Configurar atribución
Elige el campo de atribución (campaign, media_source, sub2, etc.) y asigna valores a cada partner. El primer match gana. Las conversiones ya atribuidas nunca se reasignan.
Poner comisiones y presupuestos
Define tarifas por segmento, overrides planos o escalonados, y topes mensuales. El wizard pre-crea 12 meses de presupuestos.
Lanzar campañas
Usa el wizard de Campaign Launch para generar links y CIDs de tracking. Cada campaña puede heredar reglas del cliente o bifurcar las suyas.
Activar fraude y pixel
Elige un template de reglas de fraude y, si aplica, pega el snippet de pixel en el sitio del cliente.
Reglas de comisión
Lo que gana un partner se resuelve en esta cadena de prioridad:
| Prioridad | Regla | Qué hace |
|---|---|---|
| 1 | Pago congelado | Fila en partner_payments. Es inmutable. |
| 2 | Override escalonado | rate_override con tiers[]. Segment-wide, retroactivo. |
| 3 | Override plano | Tarifa especial por CID o partner-wide, con ventana de fechas. |
| 4 | Comisión por segmento | partner_segment_commissions con effective_from/to. |
| 5 | Cliente default | client_segments.commission_default. |
El motor de comisiones corre en Go y está reflejado por una función SQL mantenida en paridad. Tú nunca tocas ninguno — editas reglas en el UI y ambos las toman.
Presupuestos: tres estados
Un presupuesto topa cuánta comisión puede ganar un partner en un segmento por mes. Ten claro que es dinero real:
| Valor | Significado | Cuándo usarlo |
|---|---|---|
> 0 | Tope en ese monto. | Presupuesto mensual normal. |
0 | Tope en cero: el partner no cobra nada. | Para pausar, no para "ilimitado". |
∞ | Sin tope. | Cuando realmente no hay límite. |
El Monthly Planner también soporta reset a media-mes: congela lo ya pagado y abre presupuesto nuevo desde un día elegido.
Go-live checklist
Antes de dar un cliente por vivo, revisa esta lista. Es exactamente lo que un dry-run completo verifica de punta a punta.
- Cliente creado: el wizard terminó y los contadores del resumen coinciden.
- Atribución + partners: cada partner tiene valores; el chequeo de conflictos está limpio.
- Comisiones + presupuestos: tarifas puestas; presupuestos son número, 0 o ∞ a propósito.
- Campañas + fraude: campañas lanzadas; reglas de fraude presentes o template elegido.
- Pixel (web/hybrid): snippet instalado; Verify installation muestra eventos en vivo.
- Funnel + conversiones: pasos definidos y eventos facturables marcados.
- MMP (si aplica): fuente de datos de AppsFlyer agregada y primer pull llegó.
Guías relacionadas
Onboarding de clientes
Wizard, campos y validaciones paso a paso.
Atribución y partners
Cómo matchear ventas con partners.
Reglas y overrides
Comisiones escalonadas, reclasificación y más.
Fraude y calidad
Reglas hot-reloaded y cola de revisión.
AppsFlyer
Pull API, S2S postbacks y mapeo de campos.
Pixel web
Snippet, eventos y funnels.