Artículos virtuales

Cómo funciona

Los artículos virtuales son artículos dentro del juego que los usuarios pueden comprar con moneda real o virtual o recibir como bonificación. No tienen forma física y se utilizan exclusivamente dentro del juego. Ejemplos de artículos virtuales: máscaras, pociones, armas, claves y otros elementos que afectan a la jugabilidad o a la apariencia del personaje.

Características principales:

• Configuración flexible de precios:
  • Definir el precio de un único artículo en moneda real y/o moneda virtual.
  • Crear artículos gratuitos.
• Detección automática del país y la moneda del usuario.
• Configuración de disponibilidad:
  • Restringir la venta de artículos en una región específica.
  • Limitar el número de artículos disponibles para su compra.
  • Limitar el tiempo de visualización de los artículos en la tienda.
  • Configurar artículos que no están disponibles para la compra. Un artículo puede ocultarse del catálogo, pero seguir estando disponible como parte de un lote o como bonificación de otro artículo.

Cómo configurarlo

2. Haga clic en Create manually y seleccione Virtual item en la lista desplegable.

3. En la sección General settings, especifique lo siguiente:
   • SKU
   • uno o varios grupos a los que debe pertenecer el artículo (opcional)
   • nombre
   • descripción breve
   • descripción ampliada: para añadirla, active la opción correspondiente (opcional)

4. En la sección Media, suba una o varias imágenes o vídeos (opcional), desde su dispositivo o mediante un enlace. En la tienda creada con el editor de sitios web de Xsolla, todas las tarjetas de artículo muestran el archivo marcado como Main, mientras que los archivos restantes solo están disponibles en tarjetas de artículo con una galería multimedia. El archivo marcado como Main también se devuelve en las respuestas de las llamadas API de obtención del catálogo.

5. En la sección Price settings, defina los precios o cree un artículo gratuito:
   • Para establecer un precio, seleccione Paid item, active la opción Pricing in real currency o Pricing in virtual currency, y especifique el precio. Si es necesario, configure los precios regionales.
   • Para crear un artículo gratuito, seleccione Free item.

6. Para limitar la cantidad de artículos disponibles para la compra:
   1. Active la opción en la sección Limits e indique la cantidad.
   2. Configure la frecuencia de restablecimiento del límite. Para ello, seleccione un periodo en la lista desplegable:
      1. Daily.
      2. Weekly.
      3. Monthly.
      4. Custom interval. El intervalo se calcula desde la fecha de inicio de visualización del artículo en la tienda.
      5. No regular refresh.
   3. Configure la programación del restablecimiento indicando los parámetros correspondientes al periodo seleccionado.

7. Para configurar un límite de tiempo de visualización del artículo (opcional):

   1. Active la opción en la sección Add specific display period.
   2. Especifique la zona horaria, el inicio y el final del periodo.

   Para dejar sin especificar el final del periodo de visualización del artículo, active la opción No end date.

8. Configure los atributos con una de las siguientes opciones (opcional):
   1. Añada atributos y sus valores en formato JSON.
   2. Cree manualmente los atributos y sus valores y vincúlelos a los artículos.

9. Si el artículo de pago se va a usar en alguna mecánica con recompensa aleatoria (por ejemplo, cajas de botín o gacha), active la opción Mark as paid randomized reward.

10. Haga clic en Create.

11. En la ventana que se abre, seleccione el estado del artículo y haga clic en Continue.

El artículo creado aparecerá en la sección All items.

Configurar mediante API

Para configurar artículos virtuales, pueden usar las llamadas de la subsección Admin del grupo Artículos virtuales y moneda.

Mostrar artículos virtuales en la tienda

La forma de mostrar los artículos virtuales depende de cómo se implemente el catálogo: mediante el editor del sitio o mediante API.

Mostrar a través del editor de sitios

Para mostrar artículos virtuales en su sitio web:

1. Creen un artículo virtual.

2. En su proyecto en la Cuenta del editor, vayan a la sección Storefronts > Websites.

3. En el panel del sitio correspondiente, hagan clic en Open Site Builder.

2. En su proyecto en la cuenta para juegos para móviles, vayan a la sección Web Shop.

3. Hagan clic en el panel del sitio deseado.

4. Si su sitio incluye varias páginas, seleccionen la que necesiten:

   1. Hagan clic en el título de la página actual en la parte superior del editor.
   2. Seleccionen la página necesaria de la lista desplegable.

5. En la sección del bloque Store, seleccionen Virtual items en el campo Item type y seleccionen el grupo de artículos que quieren vender en el sitio web en el campo Item group.

6. Configuren el diseño de la ficha del artículo.

7. Después de realizar todos los cambios necesarios y preparar su sitio web para el lanzamiento:

   1. En la esquina superior derecha del editor del sitio, hagan clic en Publish.
   2. Marquen las casillas junto a las páginas que quieren publicar.
   3. Hagan clic en Publish.

Una vez publicado el sitio, estará disponible una sección con un grupo de artículos virtuales. Si no se muestran artículos, comprueben que su Estado sea “Available” y que no haya ningún límite de visualización por tiempo activo.

Obtener información de artículos virtuales mediante API

Para obtener el catálogo de artículos virtuales en el lado del cliente, usen los métodos de la subsección Catalog del grupo Artículos virtuales y moneda. No se requiere Autorización para utilizar estos métodos.

Conceder artículos virtuales a los usuarios

En función del tipo de artículo y de la configuración de integración, el artículo virtual se concede al usuario de una de las siguientes formas:

• Si han integrado PlayFab, la moneda virtual y los artículos se conceden automáticamente al inventario de PlayFab del usuario.
• Si usan un sistema de entrega personalizado, todos los artículos y la moneda virtual se conceden en su lado. Recomendamos configurar un controlador de webhook para recibir los datos del pedido en su backend. Los datos necesarios se incluyen en el webhook Successful payment for order.

Consulten la sección Configurar el seguimiento del estado del pedido para obtener más detalles sobre este y otros métodos de recuperación de datos de compra.

Enlaces útiles