Reglas de Comisión y Presupuestos (A Fondo)

Cómo RELO decide cuánto gana cada partner: la cadena de prioridad de tasas, los topes de presupuesto, los escalones por volumen, las excepciones por campaña y cómo probar cambios sin riesgo.

Cadena de prioridad de tasas y presupuestos

El motor de Reglas

Encontrarás Reglas dentro de un cliente, en /v2/c/:slug/rules. Es el único lugar donde controlas cuánto gana cada partner y cómo se clasifican los productos.

Un selector de superficie en la parte superior cambia entre los distintos tipos de regla:

• Clasificación de segmentos — cómo se asignan los productos a segmentos como MX, VD o DA.
• Ajustes — overrides de tasa y de presupuesto. Es la parte que más usarás.
• Atribución — las reglas que acreditan cada conversión a un partner.
• Campaña → Producto — cómo se mapean las campañas a productos.
• Auditoría — un historial de la actividad de las reglas.

Prioridad de tasas

Cuando RELO calcula la tasa de un partner para un segmento, recorre una cadena de prioridad fija y usa la primera coincidencia que encuentra. De mayor a menor prioridad:

1. Tasas de pago congeladas — una vez que un mes se paga, sus tasas quedan bloqueadas y ya no cambian.
2. Override de tasa por escalones — una escalera por volumen (por ejemplo 0–74 unidades al 3%, 75+ al 3.5%, 150+ al 4%) aplicada de forma retroactiva al cruzar un umbral.
3. Override de tasa plana — una tasa fija. Un override específico de un CID gana sobre uno que aplica a todo el partner.
4. La comisión por segmento del partner — la tasa definida para ese partner y segmento.
5. El default del cliente — la tasa de respaldo para el segmento.

Cómo se calcula la comisión

Una vez que RELO tiene la tasa, el cálculo es uno de dos modos:

• Porcentaje — comisión = revenue × tasa%.
• Fija — comisión = unidades × tasa.

Cada tasa está marcada como una o la otra, así que un mismo segmento siempre se calcula de forma consistente.

Topes de presupuesto

La comisión de un segmento nunca puede exceder su tope mensual. Los topes se aplican en orden de prioridad, igual que las tasas:

1. Override de presupuesto por CID — separa las filas de la campaña que coincide del tope del segmento, y cada excepción se topa por su cuenta.
2. Override para todo el partner — un solo tope que aplica a todo el segmento para ese partner.
3. Presupuesto del segmento — el tope mensual estándar del segmento.

Esto significa que una sola campaña puede tener su propio techo, totalmente separado del presupuesto normal del partner para ese segmento.

También existe el reinicio de presupuesto a mitad de mes. Puedes fijar lo que un partner ya ganó y abrir un nuevo margen a partir de una fecha elegida — así las ventas anteriores no se comen el presupuesto nuevo. El partner conserva lo que ganó y la nueva asignación solo empieza a contar desde la fecha de corte.

Rule Builder (/v2/c/:slug/rules/new)

El Rule Builder es el editor visual unificado de reglas. Desde aqui creas reglas nuevas o editas existentes agregando ?edit=<id> al URL.

Tipos de regla

Condiciones

Las condiciones soportan grupos anidados con AND / OR. Cada condicion tiene:

• Source: de donde viene el dato (event, partner, client, *).
• Field: nombre del campo. Puede ser una propiedad del evento ($.product_name) o un campo predefinido.
• Operator: equals, contains, starts_with, ends_with, regex, gt, gte, lt, lte, in, not_in, is_empty, is_not_empty.
• Value: el valor a comparar.
• Negate: invertir la condicion.

Extractores

Cuando necesitas transformar el campo antes de compararlo, agregas extractores:

Acciones

Simulacion

Antes de guardar, simula la regla contra los ultimos 7 dias de eventos reales. El resultado muestra:

• Cuantos eventos se evaluaron.
• Cuantos hicieron match.
• Hit rate (%).
• Muestras de eventos que hicieron match.

Si la simulacion no cuadra, ajusta las condiciones y vuelve a probar.

Guardar

• Draft: la regla se guarda pero no se ejecuta.
• Active: la regla entra inmediatamente en vigor.

Editar reglas legacy

Las reglas creadas con el editor anterior no se pueden abrir en el Rule Builder visual porque su estructura no se guardo en el nuevo formato. Puedes:

1. Editarlas como JSON raw en la pagina de Rules.
2. Borrarlas y recrearlas en el Rule Builder.

Retroactive backfill

Cuando editas una regla existente, puedes re-evaluarla contra eventos historicos en ClickHouse:

1. Elige From y To.
2. Presiona Dry run para ver cuantos eventos harian match sin insertar nada.
3. Si todo bien, presiona Run backfill para insertar las filas actualizadas con _version incrementado.

Prueba cambios sin riesgo (Test mode)

Ademas de la simulacion del Rule Builder, tambien existe Test mode para preparar ediciones de reglas existentes como borradores y simular su impacto a lo largo de un mes completo antes de aplicarlas.

La simulación te muestra exactamente cómo un cambio de tasa o de presupuesto movería las ganancias de cada partner, así no hay sorpresas. Cuando estés conforme, aplica (commit); si no, descarta y todo vuelve atrás.

¿Necesitas ayuda?

Las reglas y los presupuestos afectan directamente lo que se les paga a los partners, así que ante la duda, prepara tu cambio en Test mode y revisa la simulación antes de aplicarlo. Contacta al equipo de RELO si una tasa o un tope no se comporta como esperabas.