Crear un Challenge
Ve a Gamified Campaigns → Challenges → New Challenge.
Configuration
Crear un challenge es un setup en tres partes: primero defines el dato que mide el progreso, luego creas el challenge (formato, niveles y premios) y por último pruebas la experiencia del customer.
| Phase | Owner App area | What you configure | Example |
|---|---|---|---|
| 1. Crear el Atributo calculado | Customers → Calculated Attributes | El valor numérico que sigue el progreso del customer | monthly_cart_count, monthly_spend, category_units_bought, sport_minutes |
| 2. Crear el Challenge | Gamified Campaigns → Challenges | Formato, visibilidad, enrollment, niveles/umbrales, premios por nivel, países y estado | Progresivo «Gasto mensual»: 50 € / 120 € / 200 € con premios por nivel |
| 3. Probar el flujo | Streaming API + app del customer | Verificar que el customer aparece en el catálogo, el progreso se actualiza tras el cálculo del atributo y los premios se disparan al cruzar umbrales | El progreso pasa del nivel 1 al 2; ambos premios se otorgan si un cálculo salta dos umbrales |
El challenge no calcula el progreso por sí mismo. Lee el Atributo calculado seleccionado y compara su último valor con el umbral de cada nivel. La frescura del progreso depende del calendario de ejecución de ese atributo.
Challenge format
Antes de Definition, elige el formato del Challenge:
| Format | Behavior |
|---|---|
| Hito único | Un umbral y sus premios — la meta clásica de una sola línea de llegada. |
| Progresivo | Misma métrica, 2–5 umbrales estrictamente crecientes; cada nivel puede tener sus propios premios. El progreso es acumulativo. |
| Multi-acción | Varias acciones distintas en un challenge — próximamente (aún no configurable). |
Step 1: Basic Fields
| Field | Required | Description |
|---|---|---|
| Name | Sí | Nombre visible; soporta varios idiomas |
| Description | No | Explicación orientada al customer del objetivo del challenge |
| Partner | No | Asocia el challenge a un partner concreto |
| Image | No | Asset visual mostrado a los customers |
| Type | No | Categoría configurada por Company vía Customer Success |
Select a Customer
Controla quién puede ver y participar en el challenge (audiencia), de forma independiente del enrollment y de los premios.
| Option | Description |
|---|---|
| Loyalty Club | El challenge está disponible para los miembros del club de loyalty (sujeto a países, fechas y política de enrollment). Condiciones opcionales de customer pueden acotar quién cualifica. |
| Targeted | El challenge se restringe a customers que lo reciben vía Targeted Delivery. No aparece en el catálogo ni se puede ganar hasta que un envío lo asigne (mediante voucher). Solo los challenges marcados como Targeted aparecen en el selector de challenges de Targeted Delivery. |
Targeted + enrollment: si el challenge es Targeted y requiere enrollment, el customer necesita ambas cosas: una asignación activa desde Targeted Delivery y el enrollment completado para ganar. Si no hay enrollment obligatorio, la asignación de Targeted Delivery basta para participar.
Usa Loyalty Club para challenges abiertos a todo el club. Usa Targeted cuando solo una Audience concreta deba ver y jugar el challenge — luego envíalo desde Campaign Personalization → Targeted Delivery.
Step 2: Availability Dates
| Field | Description |
|---|---|
| Available from / to | Ventana en la que el challenge está activo y se puede ganar |
| Display from / to | Ventana en la que el challenge es visible vía Streaming API — puede diferir de la disponibilidad para mostrarlo antes de que esté activo |
Targeted Delivery recurrence
Si el Challenge se envía con Targeted Delivery, las fechas de envío no sustituyen las del Challenge. Targeted Delivery controla cuándo la Audience recibe la comunicación o asignación; la disponibilidad del Challenge controla si el Customer puede ganarlo.
| Scenario | Configuration guidance |
|---|---|
| Envío puntual | Configura la disponibilidad para que el Challenge esté activo en el envío y durante toda la ventana de participación. |
| Envío recurrente semanal | Mantén el Challenge disponible todo el periodo de recurrencia. Si los Customers deben ganar una vez por semana, alinea el periodo del atributo calculado y la política de expiración con el reset semanal. |
| Envío recurrente mensual (p. ej. 6 meses) | Mantén la disponibilidad abierta los seis meses. Targeted Delivery envía una vez al mes; no amplía la disponibilidad. Para ganar una vez al mes, usa un periodo de atributo mensual y expira al final de la ventana de cálculo. Para un objetivo continuo en seis meses, usa un periodo de atributo que cubra toda la ventana. |
| Recordatorios | Mantén abiertas las fechas de display y availability durante el periodo de recordatorios; si no, los Customers pueden recibir un reminder de un Challenge que no ven o no pueden ganar. |
Una Targeted Delivery recurrente no amplía la disponibilidad del Challenge. Si la disponibilidad termina antes que la recurrencia, los envíos posteriores pueden ejecutarse, pero los Customers no podrán ganar el Challenge fuera de su ventana activa.
Consulta How Challenges Work para el ejemplo completo (Challenge de 6 meses + Targeted Delivery mensual + progreso/expiración).
Step 3: Customer Attribute
Selecciona el atributo de customer que sigue el progreso. Solo hay atributos numéricos (p. ej. gasto total del mes, número de visitas del trimestre). La plataforma deriva automáticamente:
- Period — ventana de cálculo (p. ej.
current_month,last_30_days) - Calculation frequency — cada cuánto se recalcula el valor (cadencia de actualización del progreso)
Los atributos de customer deben existir antes de configurar un challenge. Ver Atributos calculados para crear atributos numéricos.
Example calculated attributes for challenges
| Challenge goal | Calculated Attribute example | Data type | Threshold |
|---|---|---|---|
| Hacer 3 carritos de al menos 50 € este mes | Contar carritos con total >= 50 en el mes actual | Integer | 3 |
| Gastar 500 € en noviembre | Sumar totales de carrito del periodo | Number | 500 |
| Escalera de gasto mensual progresiva | Sumar totales de carrito del mes actual | Number | 50 / 120 / 200 |
| Comprar 10 unidades de una categoría | Sumar cantidades de línea cualificadas de esa categoría | Integer | 10 |
| Completar 100 minutos de deporte | Sumar minutos de eventos personalizados de una app partner | Integer | 100 |
El atributo debe representar la misma métrica que el challenge comunica al customer. Si el challenge dice «Visita 3 veces», el atributo debe contar visitas/carritos, no el gasto total.
Step 4: Enrollment Policy
| Mode | Behavior |
|---|---|
| Open to all | Todos los customers cuyo atributo se calcula participan automáticamente — sin acción del customer. |
| Enrollment required | Los customers deben suscribirse con POST /challenges/:id/enroll antes de poder ganar. Opcionalmente un tope máximo de enrollments. |
Con enrollment required puedes configurar el límite:
| Enrollment limit | Description |
|---|---|
| Unlimited | Sin tope — cualquier customer elegible puede unirse durante la ventana del challenge. |
| Max enrollments quantity | Tope duro de suscriptores (p. ej. 2.000). Al alcanzarlo no se aceptan más enrollments. |
Un customer puede enrollarse antes de la fecha de inicio, pero nunca después de la fecha de fin. Si hace falta enrollment, solo ganan quienes se suscribieron — alcanzar el objetivo sin enrollarse no otorga el premio.
El progreso sigue al Atributo calculado, no a la fecha de enrollment. Por defecto, el enrollment no filtra qué carritos o eventos cuentan: el challenge compara el valor del atributo tal como se calcula. Si la actividad anterior al enrollment (o entre enrollment e inicio del challenge) entra o no, depende de cómo definas la métrica de progresión. Para excluir actividad previa al enrollment o al inicio, configúralo en el atributo — el challenge no aplica ese corte por sí solo.
Step 5: Levels and Threshold
Configura el o los niveles — cada uno tiene nombre, umbral que el atributo del customer debe alcanzar o superar, y los premios de ese nivel.
Single milestone
Un nivel: nombre + umbral + premios para esa meta.
| Field | Description |
|---|---|
| Name | Etiqueta orientada al customer (p. ej. «Nivel oro»). Máx. 50 caracteres. |
| Threshold | Valor numérico que el atributo debe alcanzar o superar para ganar. |
| Prizes | Seleccionados en el challenge para este nivel — ver Step 7. |
Progressive
Misma métrica, varios umbrales crecientes (escalera). El progreso se comparte entre niveles; alcanzar un nivel superior no reinicia el progreso hacia el siguiente.
| Field | Description |
|---|---|
| Level | Numeración automática (1, 2, 3…). No se saltan números. |
| Name | Etiqueta del hito orientada al customer. Máx. 50 caracteres. |
| Threshold | Debe ser estrictamente mayor que el nivel anterior y estrictamente menor que el siguiente. No se pueden repetir valores. |
| Prizes | Por nivel — cada peldaño puede desbloquear recompensas distintas. |
| Add / edit / delete level | Hasta 5 niveles. Un challenge progresivo requiere al menos 2 niveles. |
Si un único recálculo del atributo ya supera varios umbrales (por ejemplo la primera compra cualificada salta el nivel 3), el customer gana todos los niveles cruzados en ese cálculo y recibe todos los premios correspondientes — no solo el nivel más alto.
Si solo necesitas un objetivo y un conjunto de premios, usa Hito único. Progresivo necesita al menos dos niveles; borrar hasta quedar en uno se bloquea con un aviso para cambiar de formato.
Expiration Policy
La política de expiración define cuándo un challenge ganado se reinicia para que el customer pueda intentarlo de nuevo. No se puede ganar una segunda vez hasta que expire.
| Option | Behavior |
|---|---|
| Months after winning | Se reinicia el mismo día del calendario N meses después de la victoria. Si la fecha resultante no es válida (p. ej. 30 de febrero), pasa al primer día del mes siguiente. |
| Days after winning | Se reinicia exactamente N días después de la victoria. |
| At the end of the calculation window | Se reinicia al final del periodo actual. Ejemplo: si la ventana del atributo es current_month y el customer gana en abril, se reinicia el 1 de mayo. |
| At the end of the next calculation window | Se reinicia al final del periodo siguiente. Con el mismo ejemplo, el 1 de junio. |
Example: elegir una política de expiración
Challenge: «Haz 3 carritos este mes» — periodo del Atributo calculado = current_month. El customer gana el 15 de abril.
| Policy | Cuándo se reinicia el challenge | Cuándo puede volver a ganar |
|---|---|---|
| Days after winning (p. ej. 30) | 15 de mayo | Después del 15 de mayo |
| Months after winning (p. ej. 1) | 15 de mayo | Después del 15 de mayo |
| At the end of the calculation window | 1 de mayo (fin de abril) | Desde mayo — alineado con el reset mensual del atributo |
| At the end of the next calculation window | 1 de junio (fin de mayo) | Desde junio — salta el resto de la ventana actual y el siguiente periodo completo |
Usa end of the calculation window cuando el objetivo debe coincidir con el periodo del atributo (p. ej. una vez al mes con current_month). Usa days/months after winning cuando quieres un cool-down desde la fecha de victoria, independientemente de los periodos de calendario. Hasta que el challenge expire, el customer no puede volver a ganarlo aunque el valor del atributo siga cumpliendo el umbral.
Step 6: Countries and Status
Opcionalmente restringe el challenge a países concretos. Pon Status en Enabled.
Los países controlan la visibilidad, no la lógica del premio. El filtro de país determina qué customers ven y se enrollan (según su país de registro). Si un customer gana depende del atributo y de los premios asociados al challenge. Alinea los países del challenge con las restricciones de las campañas de premio seleccionadas.
Status y fechas de disponibilidad son controles independientes. Si el challenge está Enabled pero fuera de fechas de disponibilidad, no se puede ganar. Si está Disabled pero dentro de fechas, tampoco estará disponible para ganar. Deben cumplirse ambas condiciones a la vez.
Step 7: Define the Prize
Los premios se seleccionan en el formulario del challenge al crear o editar niveles — no como una regla aparte con trigger «After winning a challenge». Las campañas de puntos ya no ofrecen Challenges como evento; ese vínculo solo se crea desde el challenge.
Por cada nivel puedes adjuntar premios. Como máximo un premio de cada tipo por nivel (por ejemplo uno de puntos, uno de descuento y uno de reward — nunca dos campañas de descuento distintas en el mismo nivel).
| Prize type | What you select | Delivery when the level is won |
|---|---|---|
| Points | Campaña de puntos | Con injection activado: el selector solo muestra campañas de puntos de Asignación directa; los puntos se acreditan directamente. Sin injection: campañas de puntos targeted; se entrega un voucher de puntos. |
| Discount | Cupón o campaña de descuento | Companies con Legacy Coupon Server: elige un cupón. Companies con New Engine: elige una campaña de descuento targeted; se entrega un voucher de descuento. |
| Reward / Gift | Solo reward de catálogo + targeted | Los rewards auto-redimidos no se pueden seleccionar. Al ganar, el regalo no se redime automáticamente — aparece en el catálogo personalizado del customer para que lo canjee. |
| Game | Juego targeted | Se entrega un voucher de juego para que el customer juegue. |
Los premios Reward / Gift nunca son auto-redimidos. Solo están disponibles en el selector los rewards configurados como catálogo y targeted. Cuando el customer gana el nivel, el regalo aparece en su catálogo personalizado para canjearlo. Si el regalo debe ser gratis, define su coste en 0 puntos; si no, se restan los puntos al canjearlo (no al ganar el challenge).
Configura los mismos países (y elegibilidad) en el challenge y en las campañas que elijas como premios.
Consulta Premios para el detalle de tipos de premio.
How It Works
- Defines el challenge con un atributo de customer como métrica, un formato (hito único o progresivo) y uno o más niveles con umbrales y premios.
- Los customers participan — automáticamente o con
POST /challenges/:id/enroll. - Al llegar carritos o eventos personalizados, el atributo se actualiza según su calendario de ejecución.
- Cuando el valor alcanza el umbral de un nivel, ese nivel se marca como ganado (todos los niveles cruzados en un cálculo, en progresivo).
- Se entregan automáticamente los premios configurados en cada nivel recién ganado.