Preguntas frecuentes - Gamificación y recompensas con tokens

¿Pueden las Misiones o los Torneos tener más de un tipo de recompensa?

Sí. Los operadores pueden combinar múltiples tipos de recompensa, como Tokens, Puntos XP y Ofertas de Bonificación en la sección de recompensas por completar una Misión o un Torneo.

¿Cómo funciona la distribución de Tokens y cómo pueden los Operadores configurar la Tienda de Recompensas?

Los Tokens los ganan los jugadores a través de actividades como jugar, completar misiones y subir de nivel. Una vez ganados, los Tokens se pueden gastar en la Tienda de Recompensas, donde los jugadores pueden canjearlos por artículos digitales o físicos (p. ej., Ofertas de Bonificación, Tiradas Gratis, televisores, iPhones). Los operadores pueden configurar completamente los precios, la disponibilidad y el inventario de los artículos a través de los ajustes de la Tienda de Recompensas.

¿Pueden los Operadores configurar restablecimientos de rango estacionales manteniendo intactos los Tokens de los jugadores?

Sí. La función de Degradación de Rangos permite a los operadores configurar reinicios estacionales—como mensuales, trimestrales o anuales—seleccionando un período comparativo en los ajustes de degradación. Durante cada nuevo período, los Puntos XP y los Niveles se restablecen, pero los operadores pueden elegir si confiscan o no los Tokens de los jugadores. Para asegurar que los Tokens se conserven, los operadores deben desactivar la configuración de pérdida de Tokens o establecer el porcentaje de confiscación en 0% en los ajustes de degradación.

¿Puede la Tienda de Recompensas limitar cuánto canjea un jugador por mes?

No, no hay límite: los jugadores pueden gastar tantos Tokens como deseen en la Tienda de Recompensas.

¿Pueden los Tokens expirar después de un período específico de inactividad?

No. Los Tokens no expiran por inactividad ni después de un número fijo de días. La eliminación de Tokens solo ocurre si la función de Degradación de Rangos está explícitamente activada y configurada para incluir la pérdida de Tokens al degradar. Los operadores pueden definir si los Tokens deben ser confiscados parcial o totalmente durante un evento de degradación.

¿Pueden los eventos internos del sistema (subida de rango, canje de tokens) activar transiciones de viaje en tiempo real?

Sí. Los eventos internos del sistema, como la subida de rango y el canje de tokens, pueden activar transiciones de viaje en tiempo real. Las misiones funcionan en base a eventos en tiempo real enviados por el sistema del operador, que disparan el motor de reglas de validación de objetivos. Estos eventos incluyen diversas acciones como Depósito Completado, Retiro Completado, Apuesta, Victoria y otros.

¿PEP almacena algún dato relacionado con PCI, o todo está tokenizado?

No. La Plataforma de Compromiso del Jugador (PEP) no almacena ni procesa ningún dato relacionado con PCI. Todas las transacciones monetarias dentro de la plataforma se manejan usando Tokens virtuales, que están totalmente desvinculados de los métodos de pago reales.

La información de la tarjeta de pago no es recopilada ni almacenada por PEP: esta responsabilidad recae completamente en el operador del casino y en sus respectivos sistemas de procesamiento de pagos. Esto asegura que PEP permanezca fuera del alcance del cumplimiento PCI DSS, ya que la plataforma nunca maneja datos sensibles de pago.

¿Cómo pueden los Operadores limitar la cantidad de artículos de la Tienda de Recompensas por jugador para evitar abusos?

Para evitar que los jugadores canjeen el mismo artículo gratuito varias veces, los operadores pueden especificar límites de entrega manualmente agregando notas internas en la sección de Comentarios de cada pedido (p. ej., "Entregar solo 1 artículo").

Adicionalmente, los operadores pueden aplicar ventanas de disponibilidad, restricciones por rango o flujos de trabajo de aprobación manual para artículos de alto valor para reducir aún más el abuso y garantizar una distribución justa.

¿Pueden los Operadores tener diferentes tasas de ganancia de XP y Tokens para apuestas deportivas y casino?

Sí. La plataforma permite a los operadores configurar reglas de contribución personalizadas de XP y Tokens para diferentes verticales. Los operadores pueden definir tasas de ganancia separadas para los productos de Apuestas Deportivas y Casino configurando Reglas de Contribución distintas basadas en criterios como tipo de juego, marca o moneda.

¿Cómo deben los Operadores estructurar la progresión de XP y el diseño de rangos para el sistema de lealtad del Casino?

La plataforma ofrece plena flexibilidad para definir la progresión de XP y la estructura de rangos. Los operadores pueden crear hasta 25 Rangos con 100 Niveles cada uno, establecer rangos de XP personalizados, aplicar multiplicadores y añadir límites de XP (diarios, semanales o mensuales).

Las reglas de obtención de XP también pueden adaptarse según el tipo de apuesta y las configuraciones de contribución, lo que permite a los operadores diseñar un modelo de progresión que se ajuste al ciclo de vida del casino y a los objetivos de compromiso de los jugadores.

¿Cómo insertan los Operadores datos personalizados de gamificación (rango actual, XP para el siguiente nivel) en plantillas?

Los operadores pueden insertar datos personalizados de gamificación en plantillas usando marcadores de posición proporcionados por Gamanza Engage. Por ejemplo:

• {{Gamification.Rank}}: muestra el Rango actual del jugador

• {{Gamification.XPToNextLevel}}: muestra cuántos XP se necesitan para alcanzar el siguiente Nivel

Estos marcadores de posición extraen automáticamente los datos de cada jugador cuando la plantilla se renderiza. Los operadores también pueden aplicar filtros a los marcadores para personalizar el formato y crear marcadores de posición personalizados usando el formato _CP.ExampleName_ si es necesario.

¿Cómo se calcula la longitud de un mensaje SMS y por qué varía?**faq para otro lado

La longitud de un mensaje SMS depende de la codificación de caracteres utilizada:

• Codificación GSM-7 (por defecto): Soporta hasta 160 caracteres por mensaje. Esto incluye letras latinas estándar, números y signos de puntuación comunes.

• Codificación UCS-2: Se usa cuando el mensaje contiene caracteres Unicode (por ejemplo, emojis, letras acentuadas o escrituras no latinas). Esto reduce el límite de caracteres a 70 por mensaje.

Si un mensaje excede estos límites, se divide en múltiples partes y cada parte se factura por separado:

• GSM-7: Mensajes divididos permiten 153 caracteres por parte

• UCS-2: Mensajes divididos permiten 67 caracteres por parte

¿Por qué un producto comprado en la Tienda de Recompensas puede permanecer en estado pendiente?

Un producto canjeado en la Tienda de Recompensas puede permanecer en estado pendiente por varias razones:

1. Agotado: Si el artículo ya no está disponible en el inventario en el momento del canje, el pedido no puede cumplirse de inmediato.

2. Cumplimiento por terceros: Los productos físicos procesados por proveedores externos pueden requerir tiempo adicional para la confirmación y el envío, lo que resulta en un estado temporal pendiente.

3. Cancelación del pedido: Si la compra fue cancelada o no se completó debido a un error, el producto puede seguir apareciendo como pendiente hasta que el sistema actualice el estado final.

4. Respuesta de la API (prizeshark_status): El prizeshark_status devuelto por la API puede afectar el estado de la compra. Este valor es visible en los detalles del pedido dentro del feed de compras de la Tienda de Recompensas y puede indicar si el artículo está confirmado, enviado o aún pendiente.

¿Qué es la multi-moneda y cómo funciona?

La multi-moneda permite a los operadores gestionar y soportar varias monedas para transacciones y operaciones. Los operadores simplemente establecen una moneda predeterminada (p. ej., EUR), y cuando un jugador deposita, apuesta o gana en otra moneda, el sistema multiplica la cantidad por esa tasa, almacena el valor equivalente en la moneda predeterminada y lo aplica a todas las reglas, segmentos e informes.

Los jugadores verán todo en su moneda local, mientras que los operadores verán datos uniformes y comparables en toda la plataforma. No se requiere conversión manual.

¿Cómo se ganan los Tokens y cómo se usan para comprar artículos en la Tienda de Recompensas?

Los Tokens actúan como la moneda virtual de la plataforma. Los jugadores los ganan mediante la jugabilidad, misiones y otras actividades de compromiso, y luego los gastan en la Tienda de Recompensas. Cada artículo tiene un precio en Tokens. Cuando se realiza una compra, el sistema debita automáticamente el coste en Tokens del saldo del jugador—no entra dinero real—creando un bucle cerrado «ganar → gastar» totalmente dentro de la plataforma.

¿Qué es el filtro "Rango de Fechas de Actividad" y puedes dar un ejemplo de cómo funciona?

"Rango de Fechas de Actividad" establece las fechas de inicio y fin que la plataforma usa al evaluar la actividad del jugador (apuestas, misiones, depósitos, etc.). El sistema considera todas las transacciones registradas desde las 00:00 del día de inicio hasta las 23:59 del día de fin en la zona horaria del casino.

Ejemplo: Si estableces el rango del 1 al 31 de julio, solo la actividad registrada durante julio cuenta para informes, segmentos y reglas de gamificación; las acciones antes del 1 de julio o después del 31 de julio quedan excluidas. En la segmentación, el Rango de Fechas de Actividad puede configurarse con varias opciones como "Está entre el mes pasado" o "Es mayor o igual a la semana pasada".

¿Pueden los Operadores configurar una misión o torneo para que los ganadores reciban dos recompensas en lugar de una?

Sí. Puedes configurar una misión o torneo para otorgar múltiples recompensas. En la sección de Recompensas (o desde la tabla de clasificación en Torneos), simplemente selecciona Agregar Recompensa para incluir un premio adicional para los ganadores.

¿Las apuestas con bonos cuentan para acumular Puntos XP o Tokens?

Sí. Las apuestas con bonos pueden incluirse en la acumulación de Tokens para torneos, dependiendo de cómo estén configuradas tus opciones de Moneda Virtual.

En Ajustes > Ajustes del Sistema > Gamificación, puedes elegir un Tipo de Contribución que incluya Dinero de Bonificación:

• Importe Total de la Apuesta (Dinero Real y Dinero de Bonificación) – Tanto las apuestas con dinero real como con dinero de bonificación contribuyen a la obtención de Tokens según el porcentaje definido.

• Recuento Total de Rondas (Dinero Real y Dinero de Bonificación) – Tanto las apuestas con dinero real como con dinero de bonificación contribuyen al número de rondas contabilizadas para la obtención de Tokens

También puedes crear Reglas de Tokens para anular la configuración predeterminada, permitiéndote ajustar cómo las apuestas con bono contribuyen—por juego, categoría de juego o proveedor de juego.

¿Las apuestas deportivas generan XPs y Tokens?

Sí: las apuestas deportivas pueden generar Puntos XP y Tokens a través de Contribuciones Predeterminadas.

Las Contribuciones Predeterminadas son proporcionadas por el casino mediante un archivo CSV o Excel y configuradas por el equipo de Gamanza.

El archivo debe incluir:

• contributorID

• contributorName

• Porcentaje de Contribución de Tokens

• Porcentaje de Contribución de XP

Escenarios de ejemplo:

• Apuesta Deportiva – Fútbol – 100% de contribución: una apuesta de €10 en fútbol otorga la totalidad de los Puntos XP o Tokens según el porcentaje configurado.

• Apuesta realizada con dinero de bonificación cuando la regla solo cuenta dinero real: no se otorgan Puntos XP ni Tokens.

¿Pueden los jugadores pagar con efectivo en la Tienda de Recompensas?

No; las compras en la Tienda de Recompensas solo pueden realizarse usando la moneda virtual del casino (Tokens).

Aunque algunos artículos externos pueden mostrar un precio en moneda local, este valor es solo para fines de informe. Los jugadores no pueden pagar con efectivo o dinero real; deben usar los Tokens que han ganado mediante el juego, misiones, recompensas de rango u otras actividades configuradas.

¿Qué es el "Recuento Total de Rondas"?

El Recuento Total de Rondas es una configuración de tipo de contribución que define cómo se obtienen Puntos XP o Tokens según el número de rondas jugadas.

• Recuento Total de Rondas (solo Dinero Real): Cuenta solo las rondas jugadas con dinero real.

• Recuento Total de Rondas (Dinero Real y Dinero de Bonificación): Cuenta las rondas jugadas tanto con dinero real como con dinero de bonificación.

Cada ronda que cumple los criterios cuenta como una ocurrencia, y los puntos o tokens otorgados dependen del porcentaje de contribución configurado para ese evento o categoría de juego.

¿Los Tokens expiran y cuál es el período mínimo de expiración que pueden establecer los Operadores?

Los Tokens en Gamanza no expiran por defecto. Permanecen en la cuenta del jugador indefinidamente, a menos que la función de Degradación de Rangos esté habilitada y el operador elija confiscar Tokens como parte de la configuración de degradación.

Si esta opción está activada, el porcentaje de Tokens a eliminar lo establece el operador, y la eliminación ocurre solo cuando se produce una degradación—no como una expiración temporal.

¿Por qué la recompensa de un jugador no aparece como "reclamada" aunque haya completado la misión?

Las recompensas no se asignan automáticamente cuando se completa una misión. Los jugadores deben reclamar activamente la recompensa a través de los Widgets:

1. Las recompensas pendientes aparecen en la sección de Widgets.

2. El jugador necesita hacer clic en el cofre.

3. Aparecerá una pantalla de confirmación con un botón "Reclamar".

4. Una vez que el jugador hace clic en "Reclamar", el sistema asigna la recompensa y se refleja en la cuenta del jugador.

Esto asegura que el jugador reconozca y recoja activamente sus recompensas.

¿Cuál es la API para acreditar XP a muchos jugadores a la vez?

Los operadores pueden usar POST /v1/platform-api/xp-bulk/credit para acreditar XP en lote. Maneja las respuestas 202/4xx/5xx apropiadamente.

¿Pueden los Operadores acreditar también monedas de moneda virtual?

Sí, los operadores pueden acreditar moneda virtual (Tokens) manualmente, al igual que los Puntos XP o los Impulsores (Boosters).

En la ventana de Recompensa Manual, bajo la tarjeta del jugador, los operadores pueden elegir la moneda virtual (tokens, puntos xp y otros) y luego Agregar o Eliminarlos.

La transacción se refleja entonces instantáneamente tanto en el saldo de Tokens del jugador como en la lista Mis Recompensas, etiquetada con la Fuente de Gamificación: Manual, garantizando que sea totalmente trazable y auditable.

¿Pueden los Operadores asignar múltiples tipos de recompensa en una sola solicitud?

Sí. Pueden configurar un paquete de recompensas (por ejemplo, potenciador de XP + tokens + XP) en una sola asignación.

¿Cuáles son las mejores prácticas al asignar recompensas?

Los operadores deben proporcionar cadenas de razón/fuente significativas para auditoría e implementar un manejo de errores robusto.

¿La asignación de recompensas se refleja en la interfaz de administración y en los Widgets?

Sí. Las asignaciones aparecen en “Mis Recompensas”, en la interfaz de administración y en los widgets del frontend cuando están configuradas.