Directorio de clientes
Vista global de todas las marcas en Relo: buscar, filtrar y entrar al contexto de un cliente.
Directorio de clientes
El Directorio de clientes (/v2/clients) es la vista global de todas las marcas que estan dadas de alta en Relo. Desde aqui puedes buscar una marca, ver su estado de tracking y entrar a su contexto con un clic.
Que muestra la lista
Cada tarjeta representa un cliente y muestra:
| Elemento | Descripcion |
|---|---|
| Logo o iniciales | El logo configurado en el setup, o las iniciales sobre el color primario. |
| Nombre | Nombre comercial de la marca. |
| Slug | Identificador de URL (/v2/c/:slug). |
| Status | Active u Off. |
| Tracking type | MMP, Pixel o Hybrid. |
Buscar y filtrar
El buscador filtra en tiempo real por:
- Nombre del cliente (
Samsung,Coca-Cola, etc.) - Slug (
samsung,coca-cola, etc.)
No hay filtros avanzados: la lista es pequena y el buscador cubre la mayoria de los casos.
Metricas globales
Arriba a la derecha ves dos contadores:
- active: clientes con
is_active = true. - total: total de clientes en la plataforma.
Crear un cliente nuevo
Desde el directorio puedes presionar New client para ir al wizard de onboarding:
/v2/clients/new
Para el flujo completo, ve Admin Onboarding.
Entrar a un cliente
Haz clic en cualquier tarjeta. El sistema:
- Resuelve el cliente por su slug.
- Lo establece como active client en el contexto global.
- Te navega a
/v2/c/:slug(Client overview).
A partir de ahi, el sidebar y las breadcrumbs reflejan que estas dentro de ese cliente. Todas las acciones que hagas (campanas, partners, reglas, pagos) quedan scoped a esa marca.
Estados y tracking types
| Status | Significado |
|---|---|
| Active | El cliente esta operativo y aparece en dashboards y selectores. |
| Off | El cliente esta desactivado; no recibe datos nuevos ni aparece en selectores normales. |
| Tracking | Significado |
|---|---|
| MMP | Mobile measurement partner (AppsFlyer, Adjust, etc.). |
| Pixel | Web pixel con consent gate. |
| Hybrid | Combina MMP + pixel. |
Empty state
Si aun no hay clientes, la pagina muestra:
No clients yet. Create your first client to get started.
Presiona New client para abrir el wizard de onboarding.
Cliente por defecto
Si algo falla al resolver el slug, algunas rutas client-scoped caen en un DEFAULT_CLIENT para no romper la navegacion. En produccion esto no deberia pasar si el cliente existe. Si ves el cliente equivocado, revisa que el slug sea correcto.
Relacion con otras paginas
| Pagina | Relacion |
|---|---|
| Admin Onboarding | Desde el directorio se accede al wizard para crear clientes. |
| Client overview | Al hacer clic en una tarjeta aterrizas aqui. |
| Client settings | Edicion avanzada del cliente (accesible desde el overview). |
| Setup-edit wizard | Edicion basica de identidad y branding del cliente. |
Troubleshooting
| Problema | Causa | Solucion |
|---|---|---|
| No aparece un cliente nuevo | Aun no se refresca la cache de clients | Recarga la pagina o revisa que el onboarding termino sin errores. |
| Slug duplicado | Se intento crear un cliente con un slug ya usado | El onboarding te regresa al paso 1 con el error; usa un slug unico. |
| Logo no se ve | URL rota o CORS | Revisa la URL del logo en Settings → Client. |
| Cliente aparece Off | is_active es false | Edita el status desde la pestana Cuenta o Settings del cliente. |
Go-live de cliente — pixel o red externa (Admitad)
Runbook self-serve para sacar live a un cliente nuevo: decisión pixel vs postback S2S (Admitad/Mitgo), partners, links de tracking, postbacks a sub-partners y verificación final.
Admin Playbook
Guía completa para administrar clientes en Relo — desde el onboarding hasta el go-live.