Sistema de recompensas

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

Crear un sistema de recompensas

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.

Para crear artículos de forma manual en su proyecto en Cuenta del editor, vaya a Items catalog > All items. Puede encontrar información detallada sobre este y otros métodos para crear artículos en la sección Catálogo de artículos de la documentación.

Para crear puntos de valor:

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

3. Especifique los siguientes parámetros:
   • Añada una imagen (opcional).
   • Introduzca un nombre.
   • Introduzca un SKU único.
   • Si va a crear puntos de valor de clan, active la opción Use as clan value points. No se podrá cambiar esta configuración una vez creados los puntos de valor.
   • Asigne los puntos de valor: seleccione los artículos y especifique cuántos puntos de valor obtienen los usuarios por la compra de cada artículo. Si su tienda aún no tiene artículos, puede guardar la configuración y volver a este paso más adelante.

4. Haga clic en Add row para insertar el número deseado de posiciones.
5. Haga clic en Create value points.

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 cadena: 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:
   • Nombre del paso.
   • Cantidad de puntos de valor necesaria para reclamar la recompensa.
   • Cantidad de artículos virtuales necesarios para el paso.
8. Haga clic en Save.

9. Añada el número de pasos necesarios y haga clic en Next.

10. Si quiere personalizar la cadena de recompensas:

    1. Active la opción Personalized reward chain.
    2. Seleccione una de las opciones de visualización de la cadena y haga clic en Next:
       • Show reward chain to specific users. Establezca las condiciones de personalización. La cadena solo se mostrará a los usuarios autorizados que cumplan las condiciones especificadas.
       • Show reward chain to users who don't meet conditions. La cadena solo se mostrará si no se encuentra ninguna cadena de recompensas que coincida para el usuario, por ejemplo, si el usuario no está autorizado o sus atributos no coinciden con ninguna cadena personalizada.
11. Haga clic en Next.
12. Especifique el periodo de validez de la cadena de recompensas.
13. Puede activar la opción Set time limit y establecer la fecha y hora de caducidad de la cadena de recompensas.
14. Para restablecer automáticamente el progreso en la cadena de recompensas, marque la casilla Refresh user progress after the chain ends.
15. 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.

16. Haga clic en Create.

1. En su proyecto en Cuenta del editor, vaya a la sección LiveOps > Rewards.
2. En la fila de la cadena deseada, haga clic en ••• y luego seleccione Activate en la lista desplegable.

Configurar mediante 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.

Visualización del sistema de recompensas

Mostrar a través del creador de sitios web

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.

Para mostrar cadenas de recompensas en su sitio web:

1. En su proyecto de Cuenta del editor, vaya a Storefronts > Websites.
2. Seleccione su sitio y haga clic en Open Site Builder.
3. En el área principal del creador, seleccione el lugar donde quiera añadir un nuevo bloque y haga clic en Add block.
4. Seleccione Reward system bloque.
5. En la lista desplegable, elija una cadena de recompensas.

6. Personalice los colores de los botones y del texto (opcional).
7. Para obtener una vista previa de la cadena, haga clic en Preview en la esquina superior derecha del creador.

8. Para aplicar los cambios, publique su sitio:
   1. En la esquina superior derecha del creador de sitios web, haga clic en Publish.
   2. Marque las casillas junto a las páginas que quiera publicar.
   3. Haga clic en Publish.

Mostrar detalles sobre los puntos de valor en el creador de sitios web

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.

Mostrar cadenas de recompensas mediante llamadas API

1. En la interfaz de su aplicación, implemente los elementos para mostrar los pasos de la cadena de recompensas.
2. Implemente la lógica para trabajar con cadenas mediante las siguientes llamadas API del lado del cliente del grupo Cadenas de recompensas y puntos de valor:

3. Asegúrese de que los artículos se concedan correctamente al usuario.

Configurar el clan del usuario

Si no utiliza el creador de sitios web, debe transmitir el clan del usuario en los atributos de usuario de Xsolla Login para que la cadena de recompensas del clan funcione correctamente. Para ello:

1. Configure el esquema de atributos en Xsolla 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. Para añadir o actualizar el atributo clan_id, use los métodos de actualización de atributos y transmita la matriz attributes con el valor del clan clan_id en el cuerpo de la solicitud.

 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 utiliza la autorización a través de Xsolla Login, llame a la API Actualizar clan actual del usuario para actualizar el clan del usuario. Si los atributos contienen un nuevo clan, el usuario recibirá cualquier recompensa que no se haya reclamado de la cadena de recompensas del clan anterior, y se actualizará su afiliación al clan. Si el usuario estaba en un clan antes pero ya no forma parte de él, se revocará su afiliación al clan. La respuesta de este método incluye las recompensas que el usuario ya ha reclamado.

Mostrar detalles en Web Shop

Después de configurar el esquema de atributos, implemente la transmisión 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}

Mostrar detalles mediante API

Puede transmitir los valores actuales de los atributos directamente durante la autorización del usuario si utiliza la API Autenticación mediante ID personalizado.