Marcadores de posición de plantillas CRM

1. Introducción

Esta lista proporciona una guía completa de los marcadores dinámicos disponibles dentro del CRM Gamanza Engage. Estos marcadores permiten a los operadores personalizar las comunicaciones (Correo electrónico, SMS, Notificaciones en el sitio y Web-Push) extrayendo datos en tiempo real del perfil del jugador, el progreso de gamificación y el historial de transacciones.

Nota de uso: Los marcadores normalmente deben envolverse entre llaves dobles (por ejemplo, {{rank_up.CurrentRankExternalName}}) dependiendo del editor específico que se esté utilizando en el back-office de Gamanza.

---

2. Eventos de gamificación

2.1 Subida de rango (Evento)

Se desencadena cuando un jugador acumula suficientes Puntos de Experiencia (XP) para pasar a un nuevo nivel de rango.

Marcador	Descripción
rank_up.PlayerId	Identificador único del jugador.
rank_up.CurrentLevel	El nivel numérico alcanzado dentro del nuevo rango.
rank_up.CurrentRankExternalName	El nombre público del nuevo rango (por ejemplo, "Gold Pro").
rank_up.CurrentRankExternalDescription	La descripción de marketing definida para el nuevo rango.
rank_up.XpBalance	El saldo total de XP del jugador en el momento de la subida de rango.
rank_up.Timestamp	Fecha y hora en que ocurrió la subida de rango.
rank_up.RewardExternalDescription	Detalles de la recompensa otorgada por alcanzar este rango.

2.2 Subida de nivel (Evento)

Se desencadena cuando un jugador avanza un nivel dentro de su rango actual.

Marcador	Descripción
level_up.PlayerId	Identificador único del jugador.
level_up.CurrentLevel	El número de nivel específico que el jugador acaba de alcanzar.
level_up.RemainingPendingLevels	Número de niveles restantes hasta el siguiente hito de rango.
level_up.CurrentRankExternalName	El nombre del rango al que pertenece actualmente el jugador.
level_up.XpBalance	Saldo total de XP después de la subida de nivel.
level_up.RewardExternalDescription	Descripción del bono o beneficio otorgado por la subida de nivel.

2.3 Misiones y Paquetes de Misiones

Se desencadena al completar desafíos específicos o conjuntos de desafíos.

Marcador	Descripción
mission_completed.MissionId	ID interna de la misión completada.
mission_completed.RewardExternalName	El nombre del premio ganado (por ejemplo, "50 Tiradas Gratis").
mission_completed.RemainingPendingMissions	Cuántas misiones quedan en el paquete activo actual.
mission_completed.MissionBundleExternalName	El nombre del grupo/campaña al que pertenece esta misión.
mission_bundle_completed.MissionBundleId	ID interna del paquete completado.
mission_bundle_completed.RewardExternalName	El nombre del "Gran Premio" por terminar todo el paquete.

---

3. Tienda de lealtad y compras

3.1 Compra de producto (Evento)

Se desencadena cuando un jugador gasta Tokens en la Tienda de Recompensas de Gamanza.

Marcador	Descripción
product_purchase.ProductExternalName	El nombre del artículo comprado.
product_purchase.OrderStatus	Estado actual del pedido (por ejemplo, Pendiente, Cumplido).
product_purchase.Price	El costo del artículo en Tokens.
product_purchase.TokensBalance	El saldo de Tokens restante del jugador después de la compra.
product_purchase.ProductType	Categoría del artículo (Físico, Virtual o Bono).
product_purchase.RecipientAddress	Dirección de envío proporcionada por el jugador (para bienes físicos).
product_purchase.ExternalURL	Enlace a un comprobante digital o página de seguimiento de terceros.
product_purchase.ProductRemainingStock	Inventario restante del artículo (útil para alertas de "edición limitada").

---

4. Transacciones financieras

Estos marcadores se usan para recibos transaccionales relacionados con depósitos y retiradas.

Grupo de marcadores	Campos clave	Descripción
money_deposit_successful	.amount, .currency, .paymentMethod, .realMoneyBalance	Enviado después de una recarga exitosa.
money_deposit_rejected	.amount, .transactionId, .paymentProvider	Enviado si un depósito falla; usado para mensajes de recuperación.
money_withdraw_completed	.amount, .cardType, .date, .transactionStatus	Enviado cuando una retirada es aprobada y procesada.

Nota: Todos los eventos de dinero soportan .bonusMoneyBalance para mostrar al jugador sus fondos totales jugables.

---

5. Datos de torneos

Usado para mensajería automatizada del ciclo de vida de los Torneos de Gamanza.

Marcador	Descripción
tournament_starts_in_few_minutes...TournamentExternalName	Nombre del torneo próximo.
tournament_starts_in_few_minutes...Industry	La vertical de juego (por ejemplo, Casino, Deportes, Dealer en vivo).
tournament_winner_announcement.LeaderboardPosition	La posición final del jugador (por ejemplo, 1.º, 15.º).
tournament_winner_announcement.Rank	El nivel de rango alcanzado dentro de ese torneo específico.
tournament_winner_announcement.XpPointsBalance	Puntos específicos del torneo ganados durante la sesión.

---

6. Información global del jugador y lealtad

Estos marcadores son "Globales", lo que significa que se pueden usar en casi cualquier plantilla independientemente del evento desencadenante.

6.1 Perfil del jugador (PlayersData)

Marcador	Descripción
PlayersData.FirstName	El nombre de pila del jugador tal como está registrado.
PlayersData.LastName	El apellido del jugador.
PlayersData.Email	La dirección de correo electrónico registrada del jugador.
PlayersData.CustomData.IsKycVerified	Booleano (True/False) que indica el estado de verificación de la cuenta.
PlayersData.CustomData.RiskLevel	Puntuación de segmentación interna (por ejemplo, Bajo, Medio, Alto).
PlayersData.CustomData.FavoriteGame	El título de juego más jugado por el jugador.

6.2 Lealtad global y saldos

Marcador	Descripción
VirtualCurrency.TokensBalance	Saldo actual de "Tokens de tienda" disponibles para gastar.
Ranks.CurrentLevel	El nivel actual del jugador en el programa de lealtad.
Ranks.XpBalance	Total de Puntos de Experiencia acumulados de por vida.
realMoneyBalance	El saldo actual de efectivo disponible para retirar.
bonusMoneyBalance	El saldo actual de bonificación no retirable.

---

7. Cumplimiento: Opt-In / Opt-Out

Usado para confirmar cambios en las preferencias de gamificación.

Marcador	Descripción
gamification_optout.Timestamp	Cuando el jugador desactivó las funciones de gamificación.
gamification_optin.Timestamp	Cuando el jugador reactivó las funciones de gamificación.
gamification_optin.CurrentLevel	Confirma el nivel al que el jugador vuelve al reingresar.

---

Mejores prácticas para operadores

1. Valores de reserva: Asegúrese siempre de que su herramienta CRM tenga un "valor de reserva" (por ejemplo, "Jugador" si FirstName está vacío).

2. Formateo: Para money_deposit.amount, asegúrese de que el símbolo de la moneda esté ya sea codificado de forma fija o extraído mediante el .currency marcador.

3. Pruebas: Use la función "Enviar prueba" en Gamanza Engage para asegurar que los marcadores se resuelvan correctamente antes de activar una campaña en vivo.