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, necesitará 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

Para establecer el sistema de recompensas, implemente los siguientes métodos API:

• Obtener lista de artículos virtuales
• Obtener cadenas de recompensas del usuario actual
• Obtener el saldo de puntos de valor del usuario actual
• Reclamar recompensa por paso
• Actualizar clan del usuario actual
• Obtener los 10 mejores contribuyentes a la cadena de recompensas bajo clan

Definir el clan del usuario

Si no utiliza Xsolla Site Builder, debe transmitir el clan del usuario en los atributos de usuario para que la cadena de recompensas del clan funcione correctamente.

Para añadir un atributo con un clan a un usuario, utilice los métodos de actualización de atributos y transmita la matriz attributes con el valor del clan en el cuerpo de la solicitud.

Ejemplo:

 1
 2{
 3"attributes": [
 4{
 5
 6"key": "clan_id",
 7"value": "beetles"
 8}
 9],
10"publisher_id": 000000,
11"publisher_project_id": 000000
12}

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

También puede actualizar el clan del usuario utilizando la API. Primero, actualice los atributos del usuario en Xsolla Login, luego llame a la API Actualizar clan actual 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.

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. En su proyecto en Cuenta del editor, vaya a Store > Live-ops and promotion tools.
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. En su proyecto en Cuenta del editor, vaya a Store > Live-ops and promotion tools.
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.

12. 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.

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.