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.

Go-live de cliente — pixel o red externa (Admitad)

Runbook end-to-end para sacar live a un cliente nuevo: desde crear el cliente hasta que sus partners reciben postbacks de conversión. Cubre los dos caminos de tracking (pixel de Relo o red externa S2S como Admitad/Mitgo) y el outbound hacia sub-partners, que es el mismo en ambos.

Para quién es

Admins de Relo. Caso de referencia: BanCoppel (client 23, tracking_type: pixel) — el cliente puede o no permitir inyectar el pixel en su sitio; si no, las conversiones llegan vía postback S2S de Admitad/Mitgo. Esta guía te lleva por cualquiera de los dos desenlaces.

El mapa completo

Diagrama interactivo

Cargando diagrama…

Paso 1 — Crear el cliente

Corre el wizard de onboarding en /v2/clients/new (paso a paso en Pixel Setup § Paso 1 y Admin Onboarding):

Identity: nombre, slug, moneda, timezone (America/Mexico_City para clientes MX) y tracking type PIXEL (o HYBRID si también hay app con MMP). Nota: para clientes cuyas conversiones llegan por red externa, el tracking type sigue siendo pixel — el "pixel" vs "MMP" define qué dashboards ve el partner, no el transporte.
Segments + Pixel setup: dominios permitidos y eventos trackeados (default page_view, purchase, lead_submit).
Partners: puedes agregarlos aquí o después (Paso 3).
Review → Create everything (POST /api/clients/onboard, transacción atómica).

"Done": el cliente existe, tiene slug y aparece en el selector de clientes del portal.

Paso 2 — Decisión de tracking

Una sola pregunta: ¿el cliente permite inyectar JavaScript en su sitio?

Camino A: pixel de Relo

Sigue la guía Pixel Setup de principio a fin: snippet en el <head>, verify installation, evento de prueba y troubleshooting.

"Done" del camino A:

Verify installation responde ✓ Pixel live — N event(s) in the last hour.
El tab Live events (/v2/c/:slug/pixel-analytics) muestra page_views en tiempo real.
Un relo('lead', ...) o relo('event','purchase', ...) de prueba llega y, si entraste con un tracking link, queda atribuido al partner.

Después salta al Paso 3 de esta guía.

Camino B: postback S2S de Admitad/Mitgo

En este modelo el sitio del cliente no carga nada de Relo. La red de afiliados (Mitgo/Admitad) le avisa a Relo de cada conversión con un postback server-to-server. Relo entra a Mitgo como un solo publisher; cada partner de Relo se distingue por su subid (= su CID en Relo).

B.1 — Conecta el source en el portal

Abre Tracking sources

Ve a /v2/c/:slug/tracking-sources (o Integrations → tab Tracking sources) y haz clic en Connect source.

Elige "Admitad / Mitgo"

El wizard (4 pasos: tool → credenciales → test → done) ya trae los defaults Admitad preconfigurados: type / order_sum / subid / action_id / subid4 y una key compartida generada automáticamente (auth_token, 48 hex chars).

Pega el Affiliate base URL

Campo opcional pero necesario para generar links por partner después: la URL de afiliado del programa en Mitgo, con forma https://ad.admitad.com/g/<hash>/. La consigues del contacto de Mitgo.

Crea el source y copia la URL del postback

Al crear, el wizard muestra el endpoint completo con la key:

https://ingest.relo.mx/admitad/<sourceId>?key=<auth_token>

Cópiala completa — es la que va en Mitgo.

Manda el evento de prueba

El botón Send test event del wizard dispara POST /api/data-sources/:id/test-event (evento marcado a través del backbone real) y hace polling hasta verlo llegar. Verde = el pipeline inbound funciona.

B.2 — Configura los dos postbacks en Mitgo

En Mitgo: Tools → Postback URL → Add. Necesitas dos postbacks:

Postback	Config en Mitgo	URL de Relo
Conversiones	Event type Action, method GET, action status Created (solo Created ⚠️), Simple mode	`https://ingest.relo.mx/admitad/<sourceId>?key=<key>`
Status	Event type Action, action statuses Confirmed + Declined (+ On hold si aplica)	`https://ingest.relo.mx/admitad/<sourceId>/status?key=<key>`

El de conversiones crea eventos en relo.events (dedup por action_id, así que re-disparos son seguros).
El de status escribe en network_action_statuses (una fila por acción, último status gana) y nunca crea eventos — se usa en el cierre para no pagar acciones declined.

B.3 — El contrato de parámetros (inbound)

Mitgo manda los parámetros estándar de Admitad; el mapping vive en client_data_sources.extra_config (editable en el drawer del source, toggle Advanced):

Parámetro Admitad	Campo Relo (`extra_config`)	Valor
`type` (`sale`/`lead`)	`event_name_key` + `event_map`	`sale → purchase`, `lead → lead_submit`
`order_sum`	`value_field`	Monto de la conversión
`currency`	`currency_field`	Moneda ISO
`subid`	`partner_param`	CID del partner en Relo — así se atribuye
`subid4`	`click_id_field`	`click_id` (ULID) de Relo para el join click↔conversión
`action_id`	`dedup_field`	Dedup exacto por acción

Autenticación: ?key= validado contra auth_token del source. Sin key o con key vieja → 401.

"Done" del camino B: el test de Mitgo (botón Test del postback) devuelve {"status":"ok"} y el evento aparece en el source con contadores vivos en Tracking sources.

Playbook específico con capturas, rotación de key, curls de prueba y limpieza de datos de test: Go-live con red S2S (Mitgo/BanCoppel).

Paso 3 — Asociar partners al cliente

Cada partner que correrá el cliente necesita dos cosas: el vínculo (partner_clients) y su CID (attribution_values).

Vincula el partner

Si el partner no existe: /v2/partners → Add partner (wizard completo) o Invite partner (company name, email, selecciona el cliente — le llega invitación).
Si ya existe y solo falta el vínculo, agrégalo desde el wizard de onboarding del cliente o pídele a plataforma el alta en partner_clients.

Asigna su CID

Ve a /v2/c/:slug/partners, abre el menú del partner → icono de Attribution (link). Se abre el editor de reglas de atribución (el mismo de /v2/c/:slug/attribution). Agrega el valor con match type exact — convención sugerida: cp-<slug-del-partner>.

Camino A (pixel): el CID viaja como parámetro de atribución en el tráfico del partner (ver guía de tracking params).
Camino B (Admitad): el primer CID de la lista se usa como subid en el link del partner. Un typo aquí = conversiones sin atribuir, así que cópialo del portal, no a mano.

Define su tarifa

PartnerProfile → tab Tracking & deals → card Lead rates: evento (purchase y/o lead_submit), rate fijo o %, moneda, cap mensual opcional. Sin fila en partner_lead_rates, las conversiones llegan pero no generan comisión. Detalles en Alta de partner lead-gen y Lead Rate Planner.

Paso 4 — Links de tracking para cada partner

El partner genera sus propios links en su portal (Links & creatives → builder) con forma https://t.relo.mx/c/CODE. El wrapper sella partner_id + campaign_id server-side, deja la cookie _relo_cid y redirige con &relo_click_id=<ULID>. El admin también puede generar links en /v2/link-generator.

Referencia completa: Clicks (click wrapper) y Partner Tracking Params.

El link del partner apunta a Mitgo, no al sitio del cliente, y lo compone el portal para evitar typos:

Abre el PartnerProfile

/v2/partners/:id → tab Tracking & deals, con el cliente activo seleccionado.

Card "Network tracking link"

Aparece solo si el cliente tiene un source Admitad activo con Affiliate base URL y el partner tiene al menos un CID. Si falta algo, la card te dice exactamente qué.

Generate t.relo.mx link

El destino compuesto es:

https://ad.admitad.com/g/<hash>/?subid=<CID-del-partner>&subid4={click_id}

El click wrapper sustituye {click_id} por el ULID del click en cada redirect → join click↔conversión a prueba de manipulación. Copia el short link t.relo.mx/... y entrégaselo al partner.

Paso 5 — Postbacks a sub-partners (outbound)

Igual en ambos caminos. Cuando Relo le acredita una conversión a un partner (venga del pixel o de Admitad), Relo dispara un GET server-to-server a la URL del partner con macros reemplazados. Así el tracker/CRM del partner (Voluum, Binom, RedTrack…) se entera en tiempo real.

Quién lo configura: el partner, en su portal → Links & creatives → Postbacks (S2S): elige evento (lead_submit, purchase, signup aparecen primero), pega su URL https con macros, Agregar. Hay templates de un clic para Voluum, Binom, RedTrack y CRM genérico, y botón Probar que dispara un ejemplo.
Macros disponibles: {click_id}, {event_name}, {event_time}, {payout}, {lead_value}, {sub1}/{sub2}, {city}/{country}, {product}/{stage}, {email_hash}/{phone_hash} (nunca PII crudo).
Como admin puedes revisarlo/ayudar vía impersonation (/v2/partner-portal/:id).

Guía completa (macros, templates, pruebas): Partner Postbacks.

Para que {click_id} tenga valor, el tráfico del partner debe pasar por el link t.relo.mx del Paso 4 — es quien sella el click id. En camino B además fluye de regreso en subid4.

Paso 6 — Verificación final (checklist de go-live)

No declares el cliente live hasta palomitar todo lo que aplique:

Cliente creado con tracking type correcto; aparece en el selector de clientes.
Camino A: Verify installation en verde + eventos en Live events. Camino B: postback de conversiones configurado en Mitgo (Action/Created) + test {"status":"ok"} + postback de status (Confirmed+Declined) apuntando a /admitad/:id/status.
Evento entrante visible en el portal (Live events / contadores del source) y atribuido al partner correcto — no "unattributed".
Partner vinculado con CID (exact) y tarifa en partner_lead_rates.
Link de tracking generado por el portal y entregado al partner.
Postback de prueba recibido por el tracker del partner (botón Probar en Postbacks S2S).
Comisión calculada: la conversión de prueba muestra payout en el dashboard del partner / PartnerProfile.
Camino B: al cierre, las acciones declined en network_action_statuses no se pagan.

Timezone

Dashboards, comisiones y cierres se computan en America/Mexico_City. Un evento de las 11 PM UTC cae en otro día de calendario en CDMX — tenlo en cuenta al verificar "el evento de hoy" y al cerrar mes.

Guías relacionadas

Pixel Setup — camino A completo (snippet, verify, troubleshooting).
Pixel (referencia) — catálogo de eventos y API relo().
Go-live S2S Mitgo/BanCoppel — playbook específico con curls y limpieza de tests.
Alta de partner lead-gen — rates, links y primera comisión.
Partner Postbacks — outbound S2S a trackers.
External sources — Everflow, GA4 y webhooks genéricos.

Go-live de cliente — pixel o red externa (Admitad)

On this page