Crear una cadena de recompensas.

Cómo funciona

El sistema de recompensas sirve para incentivar a los usuarios para que hagan compras en la tienda con moneda real. Por cada compra, ganan puntos de valor y avanzan por una cadena de recompensas. Si los usuarios forman parte de clanes, sus compras aportan puntos de valor a todo el clan.

Ejemplo de una cadena de recompensas con puntos de valor ganados por compra:

Glosario

Requisitos previos

Asegúrese de que su tienda contenga artículos que los usuarios puedan comprar para ganar puntos de valor.

Antes de crear una cadena de recompensas de clan, configure los clanes de usuarios.

Crear puntos de valor

Para crear puntos de valor:

1. Abra su proyecto en Cuenta del editor y vaya a la sección LiveOps > Canvas.

2. En el área de la lista de puntos de valor, haga clic en el icono +.

3. Elija un tipo de punto de valor — Individual value points o Clan value points. El tipo de punto de valor se define en el paso de creación y no se puede cambiar posteriormente.

4. Añada una imagen (opcional).

5. Introduzca un nombre.

6. Introduzca un SKU único para el punto de valor.

7. Haga clic en Next.

8. Asigne puntos de valor:

   1. Haga clic en Add affected item.

   2. Seleccione los artículos y especifique cuántos puntos de valor reciben los usuarios por comprar cada artículo.

   3. Haga clic en Select.

   Si su tienda aún no contiene ningún artículo, puede guardar la configuración actual y volver a este paso más tarde.

9. Haga clic en Next.

10. Revise la configuración de los puntos de valor.

11. Haga clic en Create.

Crear cadena de recompensas

Para crear una cadena de recompensas:

1. Abra su proyecto en Cuenta del editor y vaya a la sección LiveOps > Canvas.
2. Proceda a crear recompensas de una de las siguientes maneras:
   1. En la barra de herramientas, haga clic en el icono + y seleccione Reward chain.
   2. En el área de la lista de cadenas de recompensas, haga clic en el icono +.
   3. Abra el menú contextual en cualquier parte del canvas y seleccione Reward chain.

3. Seleccione el tipo de cadena — Individual reward chain o Clan reward chain. El tipo de cadena de recompensas se define en el paso de creación y no se puede cambiar posteriormente.

4. Especifique los parámetros básicos de la cadena:

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

5. Haga clic en Next.

6. Configure los puntos de valor — cree nuevos puntos de valor o seleccione de los existentes.

7. Haga clic en Next.

8. Añada una recompensa para cada paso de la cadena. Para añadir una recompensa para un solo paso:

   1. Haga clic en Add new step.

   2. Seleccione los artículos que los usuarios reciben como recompensa por este paso y especifique la cantidad para cada artículo.

   3. Haga clic en Add item.

9. En la lista de los pasos, especifique la cantidad requerida de puntos de valor para reclamar la recompensa. Los puntos de valor asignados a cada paso subsiguiente deben ser mayores que el anterior. El límite máximo es de 100 000 puntos de valor por paso.

10. Para cambiar el orden de las recompensas en la cadena, arrastre la fila a la posición deseada usando el icono ☰ (opcional).

11. Después de añadir las recompensas para cada paso, haga clic en Next.

12. Especifique el periodo de validez de la cadena de recompensas: una zona horaria, una fecha de inicio y una fecha de finalización. Si no quiere indicar el final del periodo de validez, marque la casilla No end date.

Nota

Para añadir otro periodo de validez a la cadena de recompensas, haga clic en Add period. Si una cadena tiene varios periodos de validez, cada uno debe tener una fecha de finalización. La cadena finaliza en el último segundo del minuto especificado. Por ejemplo, si la hora de finalización es a las 12:00, la cadena permanecerá activa hasta las 12:00:59.

Si utiliza los mismos puntos de valor para varias cadenas de recompensas, deje al menos 15 minutos entre el final de un periodo de cadena y el inicio del siguiente. Los puntos de valor y el progreso de los pasos se restablecen mediante un trabajo en segundo plano que se ejecuta a las :00, :15, :30 y :45 de cada hora (no al final exacto del periodo). Si el siguiente periodo comienza antes de esos momentos, los usuarios pueden seguir teniendo su saldo anterior. Si desea restablecer el progreso de los pasos inmediatamente, llame al método API Restablecer cadena de recompensas.

13. Para restablecer automáticamente el progreso en la cadena de recompensas, active el conmutador Reset value points.

14. Si quiere que la cadena de recompensas se renueve en un momento determinado, active el conmutador Make reward chain renewable y especifique el horario de actualización.

15. Si desea personalizar la cadena de recompensas:

    1. Active el conmutador Personalized reward chain.

    2. Seleccione una de las opciones de visualización de la cadena:

       • Display to eligible users — en este caso, la cadena se muestra solo a los usuarios autorizados que cumplan con las condiciones especificadas.

       • Display to ineligible users — para tal cadena, no necesita especificar las condiciones de personalización — se aplica por defecto. Esto significa que se muestra a los usuarios no autorizados, así como en los casos en que no se encuentra una cadena de recompensas personalizada que coincida para el usuario autorizado.

    3. Si selecciona la opción Display to eligible users, especifique la condición:

       1. Especifique el tipo de atributo del usuario — cadena, número o fecha.

       2. Seleccione el atributo del usuario de la lista desplegable.

       3. Seleccione el operador de comparación.

       4. Especifique el valor del atributo del usuario.

    4. Para añadir más condiciones, haga clic en Add condition y complete los campos mostrados (opcional).

16. Haga clic en Next.

17. Revise la cadena.

18. Para activar la cadena inmediatamente (opcional), active el conmutador Create in Active status.

19. Haga clic en Create.

Nota

Las cadenas activas no se pueden editar. Para cambiar la configuración de una promoción, primero desactívela.

Puede activar o desactivar la cadena de las siguientes maneras:

• Desde la tarjeta de la cadena de recompensas
• Desde la lista de cadenas de recompensas
• Mientras edita la cadena

Visualización del sistema de recompensas

Mostrar a través del creador de sitios web

Para asegurar que el sistema de recompensas funcione adecuadamente, se debe configurar la autenticación de usuarios. Para los usuarios no autorizados, tanto las cadenas de recompensas individuales como las de clan se visualizan sin progreso.

Los usuarios autorizados que no formen parte de un clan solo pueden ver su cadena de recompensas individual. Las cadenas de recompensas de clan se muestran 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. Si su sitio tiene varias páginas, seleccione la que necesite:
   1. Haga clic en el título de la página actual, situado en la parte superior del creador.
   2. Seleccione la página que necesita de la lista desplegable.
4. En el área principal del creador, seleccione el lugar donde quiera añadir un nuevo bloque y haga clic en Add block.
5. Seleccione Reward system bloque.

6. En la lista desplegable, elija una cadena de recompensas.

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

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

Configurar detalles para 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}

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