Wizard admin de 4 pasos para lanzar campañas: partners, comisiones, presupuestos, CIDs, notificaciones por email y reglas de segmento.

Guia de Admin

Asistente de Lanzamiento de Campanas

Lanza campanas desde el dashboard de admin en 4 pasos. Configura partners, comisiones, presupuestos y envia emails de notificacion — todo sin tocar la base de datos.

Resumen

El Asistente de Lanzamiento de Campanas es un flujo de 4 pasos disponible en el dashboard de admin en /c/:clientSlug/campaigns. Haz clic en el boton "Launch" de cualquier campana existente o "New Campaign" para comenzar.

Anteriormente, lanzar una campana requeria cambios manuales en la base de datos: insertar patrones de campana, vincular partners, crear registros de comisiones y configurar limites de presupuesto individualmente. El asistente reemplaza todo eso con una interfaz guiada que guarda todo en una sola llamada API.

Que hace En un solo flujo: crea patrones de campana, vincula partners, habilita segmentos objetivo, configura tasas de comision, crea limites de presupuesto, genera CIDs, previsualiza emails y envia notificaciones. 4 clics en lugar de 20 operaciones de base de datos.

Los 4 Pasos

Detalles

Nombre, fechas, presupuesto, segmento

Partners

Seleccionar, comisiones y presupuestos

Revisar

Previsualizar CIDs, emails, WhatsApp

Lanzar

Configurar DB y enviar notificaciones

Detalles de Campana

Define lo que vas a lanzar

Configura los parametros principales de la campana. El slug de campana se auto-sanitiza del nombre y se convierte en parte de cada CID generado para esta campana.

Nombre y slug de campana

Segmento objetivo

Rango de fechas (inicio/fin)

Presupuesto total Marca (MXN)

URL de OneLink

URL de producto

Descripcion (para emails)

Formato del slug El slug se sanitiza automaticamente: minusculas, espacios reemplazados por guiones, caracteres especiales eliminados. Ejemplo: "ATB Tablets" se convierte en atb-tabs.

Seleccionar Partners

Elige quien ejecuta la campana y cuanto ganan

Se muestran todos los partners activos del cliente con sus identificadores sub (ej: sub1, sub2). Los partners sin identificador sub se muestran pero deshabilitados — no pueden seleccionarse hasta que se configuren los valores de atribucion.

Tasa de Comision Global

Tipo de comision: $/unidad (fijo por unidad) o % de revenue
"Aplicar a Todos" copia la tasa global a cada partner seleccionado
"Sugerir Division Igual" divide el presupuesto Marca equitativamente entre los partners seleccionados

Edicion por Partner

Cada fila de partner seleccionado permite la edicion en linea de: tasa de comision, tipo de comision (fijo/porcentaje) y limite de presupuesto individual. Una fila al pie muestra presupuesto total asignado vs. presupuesto Marca con indicadores de exceso/faltante.

Revisar y Previsualizar

Verifica todo antes de lanzar

Este paso muestra un resumen de solo lectura de toda la configuracion de campana:

Tarjeta de resumen de campana — nombre, fechas, segmento, presupuesto Marca
Tabla de asignacion de partners — cada partner con su CID auto-generado, tasa de comision y limite de presupuesto
Botones de copiar CID — copia con un clic el CID completo de cada partner
Preview de email — cambia entre partners para previsualizar los emails de notificacion personalizados
Preview de WhatsApp — mensaje pre-formateado con boton de copiar para cada partner

Lanzar

Configura la base de datos y notifica a los partners

El paso final tiene tres acciones que se ejecutan en secuencia:

1. Configurar Campana

Una sola llamada API guarda todo en la base de datos:

Operacion

Descripcion

campaign_updated

Patrones de campana, slug, fechas y segmento guardados

partners_linked

Partners seleccionados vinculados a la campana

segments_enabled

Segmento objetivo habilitado para cada partner en partner_clients.enabled_segments

commissions_set

Tasas de comision creadas en partner_segment_commissions

budgets_created

Limites de presupuesto creados en partner_segment_budgets

2. Enviar Emails

Envia emails de notificacion de campana personalizados al email de contacto de cada partner. Soporta un campo CC opcional (ej: claudia@relo.mx).

3. Mensajes de WhatsApp

Se generan mensajes de WhatsApp pre-formateados para cada partner. Haz clic en el boton de copiar junto a cada partner para copiar el mensaje y compartirlo directamente.

Importante El boton "Configurar Campana" debe pulsarse antes de "Enviar Emails". Los emails hacen referencia a los CIDs y la configuracion que se guardan en la base de datos durante el paso de configuracion.

Referencia de API

Lanzar Campana

POST /api/campaigns/

/launch

Guarda toda la configuracion de la campana en una sola transaccion. Requiere autenticacion de admin.

Cuerpo de la solicitud:

{
  "campaign_slug": "atb-tabs",
  "start_date": "2026-03-18",
  "end_date": "2026-03-30",
  "budget_total": 304353.88,
  "target_segment": "TAB",
  "partners": [
    {
      "partner_id": 9,
      "commission_value": 200,
      "commission_is_percentage": false,
      "budget_amount": 20000
    },
    {
      "partner_id": 13,
      "commission_value": 200,
      "commission_is_percentage": false,
      "budget_amount": 20000
    }
  ]
}

Respuesta:

{
  "success": true,
  "campaign_id": 4,
  "results": [
    { "step": "campaign_updated", "status": "ok" },
    { "step": "partners_linked", "status": "ok" },
    { "step": "segments_enabled", "status": "ok" },
    { "step": "commissions_set", "status": "ok" },
    { "step": "budgets_created", "status": "ok" }
  ]
}

Enviar Notificacion de Campana

POST /api/admin/send-campaign-notification

Envia notificaciones por email personalizadas a los partners seleccionados con detalles de la campana, CIDs e instrucciones.

Cuerpo de la solicitud:

{
  "partners": [
    {
      "name": "PartnerA",
      "contact": "John",
      "email": "john@mobupps.com",
      "full_cid": "mx_pd_affiliate_relo_none_atb-tabs_sub1_banner_none_conversion",
      "budget": 20000,
      "commission_rate": "$200 MXN per unit"
    }
  ],
  "campaign": {
    "name": "ATB Tablets",
    "dates": "Mar 18 - Mar 30, 2026",
    "product": "Galaxy Tab S11 Ultra",
    "product_url": "https://samsung.com/mx/tablets/...",
    "onelink": "https://samsungshop.onelink.me/...",
    "description": "Marca Tablets campaign for Q1 2026",
    "goal": "Drive Galaxy Tab S11 Ultra purchases"
  },
  "cc": "claudia@relo.mx"
}

Sistema de Patrones CID

Cada partner en una campana recibe un Campaign ID (CID) unico que se usa para el seguimiento de atribucion. Los CIDs se auto-generan en el asistente — no se necesita entrada manual.

Plantilla

TEMPLATE: mx_pd_affiliate_relo_none_{campaign}_{sub}_banner_none_conversion

Variable

Fuente

Ejemplo

{campaign}

Slug de campana del Paso 1

atb-tabs

{sub}

Identificador sub del partner de attribution_values

sub1

CIDs de Ejemplo

Partner

Sub

CID Generado

PartnerA

sub1

mx_pd_affiliate_relo_none_atb-tabs_sub1_banner_none_conversion

BEdigitech

sub4

mx_pd_affiliate_relo_none_atb-tabs_sub4_banner_none_conversion

PartnerB

sub2

mx_pd_affiliate_relo_none_atb-tabs_sub2_banner_none_conversion

AnyMind

sub11

mx_pd_affiliate_relo_none_atb-tabs_sub11_banner_none_conversion

Atribucion El CID se coloca en el campo campaign de AppsFlyer. El importador usa el attribution_field del cliente (tipicamente campaign) y los attribution_values de cada partner para vincular ventas al partner correcto usando el tipo de match contains en el identificador sub.

Ejemplo: Campana ATB Tablets

Un ejemplo real de lanzamiento de la campana ATB Tablets para Marca.

Resumen de Campana

Campana

ATB Tablets

Slug

atb-tabs

Producto

Galaxy Tab S11 Ultra

Fechas

Mar 18 – Mar 30, 2026

Presupuesto Marca

$304,353.88 MXN

Segmento Objetivo

TAB (Tablets)

Comision

$200 MXN / unit

Tipo de Comision

Fijo por unidad

Asignacion de Partners

Partner

Sub

Limite de Presupuesto

Comision

Max Unidades

PartnerA

sub1

$20,000

$200/unit

100

BEdigitech

sub4

$20,000

$200/unit

100

PartnerB

sub2

$15,000

$200/unit

AnyMind

sub11

$10,000

$200/unit

CID de Ejemplo

CID COMPLETO DE MOBUPPS: mx_pd_affiliate_relo_none_atb-tabs_sub1_banner_none_conversion

Que pasa en la base de datos Cuando se hace clic en "Configurar Campana", el asistente realiza 5 operaciones en una sola llamada API: (1) actualiza los patrones de campana con el slug atb-tabs, (2) vincula los 4 partners a la campana, (3) agrega TAB a los enabled_segments de cada partner, (4) crea registros en partner_segment_commissions a $200/unidad para TAB, y (5) crea registros en partner_segment_budgets con el limite de cada partner para el mes actual.

Reglas de Segmento de Producto

Las reglas de producto determinan como se clasifican las ventas en segmentos (MX, VD, DA, TAB, etc.) para el calculo de comisiones. Configura reglas en la pestana Settings → Segments & Products.

4 Modos de Matching

Modo

Descripcion

Caso de Uso

campaign_only

Segmento determinado solo por el slug de campana. Todos los productos en esa campana obtienen el mismo segmento.

Campanas de un solo segmento (ej: atb-tabs → TAB)

campaign_and_segment

La campana determina la base, luego keywords del nombre del producto refinan a un segmento especifico.

Campanas que venden en multiples segmentos

campaign_and_product

Match de campana + categoria o nombre de producto usados juntos para clasificacion.

Cuando la misma campana tiene diferentes reglas de comision por tipo de producto

segment_only

Ignora la campana por completo. Keywords del nombre del producto determinan el segmento (ej: "Galaxy" → MX, "TV" → VD).

Modo default para campanas always-on

Configuracion

Navega a Cliente → Config → Segments & Products. Cada segmento tiene una lista de reglas de keywords. Cuando se importa una venta, el sistema verifica el nombre y categoria del producto contra estos keywords en orden de prioridad. El primer match gana.

Pestana de Ordenes

La pestana Orders en el dashboard admin muestra todas las ventas atribuidas con busqueda y paginacion. Puedes buscar por ID de orden o nombre de producto, y ver a que segmento se clasifico cada producto. Las ordenes se paginan a 20 por pagina con controles de navegacion.

Override para campanas especificas Si una campana necesita un segmento diferente al que los keywords de producto asignarian, usa el modo campaign_only. Por ejemplo, la campana atb-tabs fuerza todos los productos que califican al segmento TAB, sobreescribiendo la clasificacion MX que "Galaxy Tab" normalmente obtendria.

Reglas de Producto por Campana (4 Modos de Match)

Cada campana puede definir reglas de producto que determinan que productos cuentan para esa campana. Las reglas soportan 4 modos de match:

// 4 Match Modes for Campaign Product Rules

contains    — Product name contains the keyword
              "galaxy" matches "Galaxy S24 Ultra 256GB"

exact       — Product name matches exactly
              "Galaxy Tab S10" matches only "Galaxy Tab S10"

startswith  — Product name starts with the keyword
              "Galaxy Tab" matches "Galaxy Tab S11 Ultra"

regex       — Regular expression match
              "\\btab\\b|tablet" matches any product with "tab" or "tablet"

// Rules are checked in priority order. First match wins.
// Configure at: Client → Campaigns → [Campaign] → Product Rules

Campaigns

On this page