Sistema de recompensas

Glosario

Cómo funciona

El sistema de recompensas le permite incentivar a los usuarios para que realicen compras en la tienda con moneda real. Si los usuarios forman parte de clanes, sus compras aportan puntos de valor a todo el clan.

Puede crear cadenas de recompensas individuales y para clanes y conceder a los usuarios recompensas por artículos comprados. El juego puede incluir varias cadenas de recompensas de cualquier tipo. Cada cadena puede tener un máximo de 31 pasos. Para cada nivel, se define el número de puntos de valor necesarios para completarlo.

También puede crear una cadena de recompensas personalizada. La personalización le permite mostrar la cadena únicamente a un grupo específico de usuarios autorizados en función de sus atributos. Puede diseñarse una cadena de recompensas personalizada para un usuario individual o para un clan.

En cada paso de la cadena de recompensas, un usuario puede recibir entre 1 y 10 recompensas. Un clan también puede recibir entre 1 y 10 recompensas por miembro en cada paso.

Puede recompensar a los usuarios con los siguientes tipos de artículos:

• artículos virtuales
• moneda virtual
• paquetes de moneda virtual
• lotes

Para que el sistema de recompensas funcione correctamente, es necesario configurar la autenticación de usuarios. Para los usuarios no autentificados, tanto la cadena de recompensas individual como la de clanes se muestran sin progreso. Los usuarios autenticados que no son miembros de un clan solo ven su cadena de recompensas individual. Las cadenas de recompensas de clanes aparecen como no disponibles.

Flujo del usuario

1. El usuario accede al sitio.
2. El usuario ve el catálogo de artículos, el sistema de recompensas y el número de puntos de valor disponibles para cada artículo.
3. El usuario inicia sesión.
4. Ahora el usuario puede ver su progreso actual en el sistema de recompensas.
5. El usuario realiza una compra y avanza en la cadena de recompensas.

Cómo conseguirlo

Para establecer un sistema de recompensas, necesita los siguientes datos:

• fechas de inicio y final del sistema de recompensas

• una imagen, descripción, SKU y nombres de los puntos de valor que permiten progresar en la cadena de recompensas individuales y del clan
• el número de puntos de valor
• artículos en la cadena de recompensas

Vea los siguientes ejemplos.

Cadena de recompensas:

Descripción	Ejemplo:
Nombre	Fragmento
Texto explicativo	Para obtener recompensas, recopile los fragmentos.
Código de artículo (SKU)	ExampleSKU003
Imagen o su URL

Implemente en su lado lo siguiente:

• visualización de los elementos del sistema de recompensas en la tienda:
  • el número de puntos de valor que se concede por la compra de artículos en el catálogo
  • puntos de valor
  • pasos
  • cadenas de recompensas
  • el saldo de puntos de valor del usuario autorizado
  • recompensas
• el envío de los datos del clan del usuario a Xsolla Login

Configurar a través de la Cuenta del editor

Antes de crear una cadena de recompensas, debe crear puntos de valor, recompensas y artículos que los usuarios y un clan pueden comprar para ganar puntos de valor.

Crear puntos de valor

Para crear puntos de valor:

1. Abra su proyecto en Cuenta del editor y vaya a LiveOps > Rewards.
2. En la pestaña Rewards, haga clic en Create value points.

3. Especifique los siguientes parámetros:
   • Añada una imagen (opcional).
   • Introduzca un SKU único para los puntos de valor.
   • Especifique si los puntos de valor se utilizarán para un clan
   • Indique un nombre para los puntos de valor.

4. Haga clic en Next.
5. Seleccione el SKU del artículo virtual y especifique el número de puntos de valor que el usuario recibirá por cada compra.
6. Haga clic en + para añadir el número de artículos necesarios.
7. Haga clic en Save.

Los puntos de valor creados se muestran encima de las cadenas de recompensa. Los puntos de valor del clan están identificados de forma específica. Para cambiar la configuración de un punto de valor específico, haga clic en Edit en la fila correspondiente.

Crear una cadena de recompensas

Para crear la cadena de recompensas:

1. Abra su proyecto en Cuenta del editor y vaya a LiveOps > Rewards.
2. Haga clic en Create reward.

3. Elija el tipo de New reward chain: Individual reward chain o Clan reward chain.
4. Especifique los siguientes parámetros. Si selecciona una cadena de recompensas individual:
   1. Especifique el nombre de la cadena de recompensas.
   2. Incluya una descripción.
   3. En la lista desplegable, seleccione puntos de valor.

Si elige la cadena de recompensas de clan:
1. En la lista desplegable Clan type, elija un tipo de clan.
2. Establezca los parámetros de la cadena de recompensas del clan:
   1. Especifique el nombre de la cadena de recompensas.
   2. Incluya una descripción.
   3. Especifique un título para el encabezado emergente de la cadena de recompensas.
   4. Especifique el texto del consejo emergente (lo que los usuarios deben hacer para ganar recompensas para su clan).
   5. Añada una imagen (opcional).
   6. En la lista desplegable, seleccione puntos de valor.

5. Haga clic en Next.
6. Haga clic en Add new step.
7. Especifique los siguientes parámetros y haga clic en Save:
   1. Nombre del paso.
   2. Cantidad de puntos de valor necesaria para reclamar la recompensa.
   3. Cantidad de artículos virtuales necesarios para el paso.
8. Haga clic en Next.

9. Si desea personalizar la cadena de recompensas:

   1. Establezca el conmutador Personalized reward chain como activo.
   2. Seleccione una de las opciones de visualización de la cadena y haga clic en Next:
      • Show reward chain to specific users. Cuando está habilitada, la cadena solo se muestra a los usuarios autorizados que cumplen las condiciones especificadas.
      • Show reward chain to users who don't meet conditions. Cuando está habilitada, la cadena solamente se muestra si no se detecta ninguna cadena de recompensas que coincida con el usuario; por ejemplo, si el usuario no está autorizado o sus atributos no coinciden con ninguna cadena personalizada.
   3. Si ha seleccionado mostrar la cadena a usuarios específicos:
      1. Haga clic en Add condition y establezca las condiciones de personalización:
         • User attribute es una característica del usuario, como el país o la edad. Los atributos se configuran en la sección de Login.
         • Attribute type define el formato del valor del atributo: cadena, número o fecha.
         • Comparison operator determina de qué forma se compara el valor del atributo del usuario con la condición especificada; por ejemplo, equals (igual a), greater than (superior a), less than (inferior a) o contains (lo contiene).
         • Attribute value es el valor específico utilizado para la comparación. Por ejemplo, si el atributo de usuario es la edad, el tipo de atributo es el número, el operador de comparación es "mayor que" y el valor del atributo es 18, la cadena solo se mostrará a los usuarios mayores de 18 años.
      2. Para añadir otra condición de personalización, haga clic en Añadir condición. Haga clic en Add condition.
   4. Haga clic en Next.

10. Cree los pasos necesarios y haga clic en Save.

11. Haga clic en Next.
12. Especifique el periodo de validez de la cadena de recompensas.
13. Si quiere que la cadena de recompensas se renueve en un momento determinado, active la opción Make reward chain renewable y especifique el modo de actualización.

14. Haga clic en Save.

1. En el catálogo de recompensas, seleccione la cadena de recompensas.
2. Haga clic en ••• y seleccione Activate en la lista desplegable.

Establecer un bloque de sistema de recompensas en Site Builder

Para añadir un bloque Reward system a una página en Site Builder:

1. Abra su proyecto en Cuenta del editor y vaya a Storefronts > Websites.
2. En el panel del sitio correspondiente, haga clic en Open Site Builder.

3. Haga clic en Add block en la plantilla del sitio.
4. Elija Reward system de la lista de bloques.

5. En la lista desplegable, seleccione una cadena de recompensas configurada en el en el Shop Builder.

6. Personalice los colores de los botones y del texto (opcional).
7. Haga clic en Preview en la esquina superior derecha del creador para ver su sistema de recompensas. Haga clic en Publish para publicar el sitio.

Configuración mediante métodos API

Puede usar métodos de la subsección Admin del grupo de métodos Cadenas de recompensas y puntos de valor para gestionar el sistema de recompensas.

1. Cree puntos de valor que den acceso a recompensas a través de la API Crear punto de valor.
2. Asigne puntos de valor a artículos específicos a través de la API Fijar puntos de valor para los artículos; los usuarios recibirán estos puntos después de comprar los artículos.

3. Cree un sistema de recompensas a través de la API Crear una cadena de recompensas. Para crear una cadena de recompensas personalizada, transmita la condición de visualización en la attribute_conditions matriz.

   Puede especificar si se debe mostrar una cadena de recompensas personalizada a un usuario que no tenga el atributo definido en la condición. Para ello, transmita true en el parámetro can_be_missing.

   Puede definir una cadena de recompensas que se muestre a un usuario si no se encuentra ninguna cadena personalizada coincidente. Para ello, transmita false en el parámetro is_always_visible.

4. Active el sistema de recompensas a través de la API Activar cadena de recompensas.

También puede modificar, desactivar o eliminar el sistema de recompensas y retirar puntos de valor de los artículos.

Funciones para mostrar el sistema de recompensas en la interfaz de la tienda

Funciones de visualización de los puntos de valor

Puede seleccionar varias cadenas de recompensas dentro de un mismo bloque y elegir cómo se muestran: una debajo de otra o en pestañas. Puede personalizar el aspecto de cada cadena de recompensas individualmente.

Las fichas de artículos muestran puntos de valor solo para las cadenas de recompensas que se han añadido al sitio. Sin embargo, cuando los usuarios compran artículos, los miembros del clan reciben puntos de valor por todas las cadenas de recompensas activas, independientemente de si se muestran en el sitio o no.

Ejemplo:

Tiene 2 cadenas de recompensas configuradas: una cadena de recompensas individual y una cadena de recompensas de clan. La cadena individual tiene un punto de valor llamado Crystal y la cadena de clan tiene un punto de valor llamado Magic Bubble.

En el catálogo de artículos, hay un artículo llamado Sword con puntos de valor asignados. Cuando un miembro del clan compre este artículo, recibirá 20 Crystals y 40 Magic Bubbles.

Cuando añade el bloque Store en el creador y selecciona el tipo y el grupo de artículos que contienen el artículo Sword:

1. Si no se ha añadido ninguna cadena de recompensas al sitio, el artículo Sword no mostrará ningún punto de valor.
2. Si solo se ha añadido una cadena de recompensas individual y está activa, el artículo Sword mostrará solo 20 Crystals.
3. Si solo se ha añadido una cadena de recompensas de clan y está activa, el artículo Sword solo mostrará 40 Magic Bubbles.
4. Si se han añadido tanto una cadena de recompensas individual como una de clan y están activas, el artículo Sword mostrará 20 Crystals y 40 Magic Bubbles.

Para los miembros del clan, se mostrarán 40 Magic Bubbles como valor activo.

Para los usuarios sin clan, se mostrarán 40 Magic Bubbles como valor bloqueado.

Definir el clan de usuario

Xsolla no crea clanes ni almacena información sobre los miembros del clan. Debe implementar el sistema de clanes por su cuenta y pasar los datos relacionados con los clanes mediante atributos de usuario.

Para garantizar el correcto envío y tratamiento de los datos del clan:

1. Configure el esquema de atributos en Login. Añada el atributo clan_id.

Ejemplo de esquema de atributos en Login:

 1{
 2	"$schema": "https://json-schema.org/draft/2020-12/schema",
 3	"additionalProperties": false,
 4	"description": "JSON Schema example for user attributes. Not the actual schema.",
 5	"properties": {
 6
 7		"clan_id": {
 8			"description": "name of clan",
 9			"type": "string"
10		},
11		"custom-id": {
12			"description": "custom-id of a user.",
13			"type": "number"
14		},
15		"had_ban": {
16			"description": "Whether the user was banned.",
17			"type": "boolean"
18		},
19		"last_purchase": {
20			"description": "Date of user's last purchase.",
21			"type": "string"
22		},
23	},
24	"required": [],
25	"title": "Example",
26	"type": "object"
27}

2. Implemente el envío de los datos del clan del usuario:

• Al autenticar por ID de usuario, transmita el clan del usuario en la respuesta al webhook Validación de usuarios en Web Shop durante la autorización:
• Para añadir o actualizar el atributo clan_id transmita una matriz de objetos attributes con la clave de atributo clan_id.

Ejemplo de respuesta de webhook:

 1{
 2  "user": {
 3    "id": "1234567890",
 4    "picture": "https://example.com",
 5    "name": "test-name"
 6  },
 7  "attributes": [
 8    {
 9     "key": "clan_id",
10     "value": "beetles"
11    }
12  ]
13}

• Si el usuario ha dejado el clan y no se ha unido a otro, debe transmitir el valor clan_id en el campo removing_keys.

Ejemplo de respuesta de webhook:

 1{
 2  "user": {
 3    "id": "1234567890",
 4    "picture": "https://example.com",
 5    "name": "test-name"
 6  },
 7  "removing_keys": [
 8    {
 9      "key": "clan_id"
10    }
11  ]
12}

• Si el sitio utiliza la autorización a través de Xsolla Login, utilice la API Actualizar clan del usuario actual para actualizar el clan del usuario.