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:
  • Establecer un precio para un solo artículo en moneda real o 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 artículos en la tienda.
  • Configurar artículos que no están disponibles para su compra. Un artículo puede ocultarse del catálogo, pero puedes seguir incluyéndose en un lote o como bonificación por la compra de otro artículo.

Cómo se configura

Establecer a través de Cuenta del editor

1. Abra su proyecto en Cuenta del editor y vaya a la sección Items catalog > All items.
2. Haga clic en Add y seleccione Virtual item de la lista desplegable.

3. Especifique los siguientes parámetros:
   • Imagen (opcional).
   • Código de artículo (SKU).
   • Uno o varios grupos a los que debe pertenecer el artículo.
   • Nombre.
   • Descripción (opcional).
4. Para configurar cómo se muestra el artículo virtual en la tienda, seleccione el estado correspondiente.

5. Establezca precios o cree un artículo gratuito en el campo Paid or free:

1. • Para crear un artículo gratuito, seleccione Free item.

1. • Para fijar un precio, seleccione Paid item y especifique el precio en moneda real. Si es necesario, configure los precios regionales.

6. Para limitar el número de artículos disponibles para la compra, active el conmutador Limit number of times one user can buy this item e introduzca la cantidad deseada.
7. Para configurar la frecuencia con la que se restablece el límite:

1. 1. Seleccione un periodo de la lista desplegable:
      • Daily.
      • Weekly.
      • Monthly.
      • Custom interval: el intervalo se calcula a partir de la fecha de la visualización del artículo.
      • No regular refresh.

1. 2. Establezca el calendario de restablecimiento en función del periodo seleccionado.

8. Configurar un límite de tiempo de visuaización del artículo (opcional):

1. 1. En el campo Show item in store, seleccione Limited time.

1. 2. Especifique la zona horaria y el inicio y el final del periodo.

1. 1. Si no desea indicar el final del periodo de visualización del artículo, marque la casilla No end date.

9. Configure los atributos usando uno de los siguientes métodos (opcional):

1. 1. Agregue los atributos y sus valores en formato JSON.

1. 2. Cree atributos y valores manualmente, y vincúlelos a artículos específicos.

10. Compruebe la configuración y haga clic en Create item.

Establecer mediante API

Para establecer artículos virtuales, utilice las llamadas API de la subsección Admin del grupo Artículos virtuales y moneda.

Mostrar artículos virtuales en la tienda

La visualización de los artículos virtuales depende de la forma en que se implementa el catálogo: mediante el creador de sitios web o mediante API.

Mostrar a través del creador de sitios web

Para mostrar artículos virtuales en su sitio web:

1. Crear un artículo virtual.

2. En su proyecto de Cuenta del editor, vaya a la sección Storefronts > Websites.
3. En el panel del sitio correspondiente, haga clic en Open Site Builder.

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

5. Establezca un diseño de ficha de artículo.
6. Tras efectuar todos los cambios pertinentes y preparar su sitio web para el lanzamiento:
   1. En la esquina superior derecha del creador de sitios web, haga clic en Publish.
   2. Marque las casillas situadas junto a las páginas que desee publicar.
   3. Haga clic en Publish.

Cuando el sitio web esté publicado, se habilitará una sección con un grupo de artículos virtuales. Si no se muestran artículos, compruebe que su estado esté establecido como Disponible y que no esté activo ningún límite de visualización basado en el tiempo.

Obtener información de los artículos virtuales mediante API

Pâra recuperar el catálogo de artículos virtuales en el lado del cliente, utilice los métodos de la subsección Catálogo del grupo de métodos Obtener lista de artículos virtuales. No hace falta autorización para usar 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 ha integrado PlayFab, la moneda virtual y los artículos se otorgan automáticamente al inventario de PlayFab del usuario.
• Si usa un sistema de entrega personalizado, todos los artículos y monedas virtuales se conceden en su lado. Recomendamos establecer un controlador de webhook para recibir los datos del pedido en su back-end. Los datos necesarios se incluyen en el webhook Pago del pedido realizado correctamente.

Enlaces útiles