Moneda virtual

Cómo funciona

La moneda virtual es dinero virtual que se emplea para comprar y vender productos virtuales. En función de cómo se utilice, la moneda virtual afecta al equilibrio de la economía del juego o está vinculada a la monetización de la aplicación.

Características principales:

• Vender cualquier cantidad de moneda virtual o paquetes de moneda virtual con una cantidad fija.
• Vender moneda virtual o paquetes de moneda virtual por moneda real o virtual.
• Limitar el número de paquetes de moneda virtual disponibles para la compra.
• Limitar el tiempo de visualización de la moneda virtual y de los paquetes de moneda virtual en la tienda.
• Paquetes de moneda virtual gratuitos.

Las siguientes opciones están disponibles para vender moneda virtual:

• Cualquier cantidad: le permite vender moneda virtual por el importe especificado por el usuario. Para usar esta opción, implemente un campo de entrada en el lado del cliente que permita al usuario introducir la cantidad de moneda deseada cuando haga una compra.
• Paquetes: prermiten vender moneda virtual en cantidades predefinidas. El precio de un paquete de de moneda se establece por separado y puede diferir del precio estándar de la misma cantidad de esa moneda.

1. Ejemplo: Un paquete contiene 100 monedas de oro y cuesta 90 $, mientras que el precio de una moneda de oro es de 1 $.

Restricciones:

• Solamente puede añadir un tipo de moneda virtual a un paquete.
• Un precio en otra moneda virtual solo puede configurarse mediante llamadas API.
• Puede crearse un paquete de moneda virtual gratuito: sin especificar un precio en moneda real o virtual. Esto puede configurarse a través de Cuenta del editor o mediante llamadas API. La moneda virtual gratuita que no se incluye en un paquete solo puede crearse mediante llamadas API.
• La cantidad de moneda virtual de un paquete puede especificarse únicamente como un valor entero.

Cómo se configura

Establecer a través de Cuenta del editor

• Moneda virtual
• Paquetes de moneda virtual

Para establecer una moneda virtual mediante 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 currency de la lista desplegable.

3. Especifique los siguientes parámetros:
   1. Imagen (opcional).
   2. Código de artículo (SKU).
   3. Nombre de la moneda virtual.
4. Para configurar cómo se muestra la moneda virtual en la tienda, seleccione el estado correspondiente.

5. Para establecer un precio, haga clice en Set up prices y especifique el precio en moneda real. si es necesario, configure los precios regionales.
6. 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.

7. Compruebe la configuración y haga clic en Create currency.

Nota

Antes de establecer un paquete de moneda virtual, debe crear una moneda virtual.

Para establecer un paquete de moneda virtual mediante 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 currency package 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 paquete.
   • Nombre.
   • Descripción (opcional).
4. Para configurar cómo se muestra la moneda virtual en la tienda, seleccione el estado correspondiente.

5. Especifique la moneda virtual que se incluye en el paquete y su cantidad.
6. Establezca precios o cree un artículo gratuito en el campo Paid or free:

1. • Para crear un paquete gratuito, seleccione Free package.

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

7. Para limitar el número de paquetes disponibles para la compra, active el conmutador Limit number of times one user can buy package e introduzca la cantidad deseada.
8. 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 paquete.
      • No regular refresh.

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

9. Configurar un límite de tiempo de visuaización del paquete (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.

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

11. Compruebe la configuración y haga clic en Create package.

Establecer mediante API

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

Mostrar moneda virtual en la tienda

La visualización de los moneda virtual o de paquetes de moneda virtual 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

1. Crear paquete de moneda 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 boque Store, seleccione el paquete de moneda virtual que desee vender en el sitio web, en el campo Item type.

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 paquetes de moneda virtual. Si no se muestran paquetes, 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 la moneda virtual mediante API

Para recuperar el catálogo de monedas virtuales y de paquetes de monedas virtuales en el lado del cliente, use las llamadas de la subsección Catálogo del grupo Artículos y monedas virtuales.

Conceder moneda virtual a los usuarios

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

• Si ha integrado PlayFab, la moneda virtual y los artículos se conceden 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.