Crear moneda virtual

La moneda virtual es dinero virtual que se usa para comprar y vender artículos del juego. Dependiendo de su finalidad, una moneda virtual afecta al equilibrio de la economía del juego o está relacionada con la monetización de la aplicación. También se puede crear una moneda convertible, es decir, una moneda virtual vinculada a la plataforma de compra y que solo se puede adquirir con dinero real.

Puede vender la moneda virtual en cantidades predefinidas. Para un paquete, puede definir un precio especial que no sea igual a la cantidad de moneda virtual que contiene.

Consulte la sección de Moneda virtual para obtener más información sobre moneda virtual.

Para establecer una moneda virtual:

1. Abra su proyecto en Cuenta del editor y vaya a Items catalog > Virtual currency.
2. Haga clic en New virtual currency.
3. Especifique:
   • Imagen (opcional).
   • SKU.
   • Nombre.
   • Precio en moneda real o virtual.
   • Moneda predeterminada.
   • Atributos (opcional).

4. Puede definir la moneda virtual como moneda prémium. Esta moneda está vinculada a la plataforma en la que se realiza la compra y solo se puede vender por dinero real. Para configurar el almacenamiento separado de moneda prémium para distintas plataformas, active la opción Premium Currency.

Configurar un paquete de moneda virtual

Para configurar un paquete de moneda virtual:

1. Abra su proyecto en Cuenta del editor y vaya a Items catalog > Virtual Currency > Packages.
2. Haga clic en New Package.

3. Especifique:
   • Imagen del paquete (opcional).
   • SKU del paquete.
   • Nombre del paquete.
   • Breve descripción del paquete.
   • Moneda virtual para un paquete.
   • Precios en moneda real y virtual.
   • Moneda predeterminada.
   • Atributo (opcional).

4. Para limitar el número de veces que un usuario puede comprar un paquete de moneda virtual, active la opción Limit number of times one user can buy a virtual currency package y especifique el límite.
5. Para establecer un límite de tiempo para mostrar el paquete en la tienda, en el campo Show item in store, seleccione Time period y especifique la zona horaria, el inicio y el final del periodo. Si no quiere especificar el final del periodo, marque la casilla No end date.
6. Revise la configuración y haga clic en Create package.

Crear artículos virtuales

Los artículos virtuales son el contenido en el juego que puede vender a cambio de moneda real y virtual.

Existen 3 tipos de artículos virtuales:

• Consumibles - objetos que se pueden tener en grandes cantidades y comprar varias veces. Su cantidad disminuye cuando los usuarios los consumen.
• No consumibles - artículos que se pueden acumular o comprar una sola vez. Se mantienen en el inventario del usuario y no se pueden retirar del inventario al ser consumidos en el lado del cliente. Solo se pueden retirar a través de un método del servidor.
• Artículo de tiempo limitado - un artículo no consumible que está disponible durante un periodo limitado y no desaparece del inventario cuando expira. El usuario debe volver a comprar este artículo para activarlo.

Consulte la sección de Artículos virtuales para obtener más información sobre artículos virtuales.

Para establecer artículos virtuales, es necesario configurar grupos de artículos virtuales. Los grupos le permiten tener un catálogo multinivel y gestionar un escaparate de artículos en la tienda.

Para crear grupos de artículos virtuales:

1. Abra su proyecto en Cuenta del editor y vaya a Items catalog > Virtual items.
2. Haga clic en + y seleccione Create group en la lista desplegable.

3. Especifique los siguientes parámetros:
   • Código de grupo.
   • Nombre de grupo.
4. Si quiere mostrar el grupo en un catálogo, active la opción Show group in Store.

5. Haga clic en Create group.

Para crear un artículo virtual:

1. Abra su proyecto en Cuenta del editor y vaya a Items catalog > Virtual Items.
2. Haga clic en + y seleccione Create Item en la lista desplegable.

3. Especifique:
   • Imagen (opcional).
   • SKU.
   • Uno o varios grupos a los que debe pertenecer el artículo.
   • Nombre.
   • Descripción (opcional).

• Propiedad del artículo: artículos consumibles, no consumibles o de tiempo limitado.
• Precios en moneda real o virtual.

4. Establezca un límite de compra para el artículo (opcional). Para ello, active la opción Limit number of times one user can buy this item y especifique el número de artículos que puede comprar un usuario.
5. Para establecer un límite de tiempo para mostrar el artículo en la tienda, en el campo Show item in store, seleccione Time period y especifique la zona horaria, el inicio y el final del periodo. Si no quiere especificar el final del periodo, marque la casilla No end date.
6. Revise la configuración y haga clic en Create item.

Crear lotes

El lote es un conjunto de varios artículos que se venden como una sola unidad. Puede añadir artículos de diferentes tipos a un lote:

• Moneda virtual.
• Paquete de moneda virtual.
• Artículos virtuales que incluyen artículos de tiempo limitado.
• Lotes.

Consulte la sección de Bundles (Lotes) para obtener más información sobre los lotes.

Para crear un lote:

1. Abra su proyecto en Cuenta del editor y vaya a Items catalog > Bundles.
2. Haga clic en + y seleccione Create bundle en la lista desplegable.

3. Especifique:
   • Imagen (opcional).
   • SKU.
   • Nombre.
   • Descripción (opcional).
   • Contenido.
4. Establezca el precio del lote. Defina los precios o cree un lote gratuito:
   1. Para crear un lote gratuito, en el campo Paid or Free, seleccione Free bundle.
   2. Para establecer un precio, en el campo Paid or Free, seleccione Paid bundle y especifique el precio en monedas reales o virtuales. Si es necesario, establezca precios regionales.

5. Establezca un límite de compra para el lote (opcional). Para ello, active la opción Limit number of times one user can buy bundle y especifique el número de lotes que puede comprar un usuario.
6. Haga clic en Next.
7. Configure cómo se mostrará el lote en la tienda:
   • Cambie el estado a Disponible.
   • Establezca un límite de tiempo para mostrar un lote en la tienda (opcional). Para ello, seleccione Time period y especifique la zona horaria, el inicio y el final del periodo. Si no quiere indicar el final del periodo, marque la casilla No end date.
8. Haga clic en Next.
9. Revise la configuración y haga clic en Save.

Puede automatizar la creación y actualización del catálogo con las llamadas a la Shop Builder API. Con la automatización, puede mantener su catálogo actualizado sin invertir mucho tiempo. La automatización del catálogo le permite crear y actualizar artículos y promociones e importar datos de sistemas externos.

La autorización básica se utiliza para las llamadas API. Introduzca la Authorization:Basic <your_authorization_basic_key>, en la cual <your_authorization_basic_key> es el par Merchant ID:clave de API codificado según el estándar Base64. Vaya a Cuenta del editor para encontrar estos parámetros:

• Merchant ID se muestra:
  • En Company settings > Company.
  • En la URL de la barra de direcciones del navegador de cualquier página de Cuenta del editor. La URL tiene el siguiente formato: https://publisher.xsolla.com/<merchant_id>/.

• API key se muestra en Cuenta del editor solo una vez al crearla y deberá guardarla por su parte. Puede crear una nueva clave en la siguiente sección:
  • Company settings > API keys
  • Project settings > API keys

Para crear artículos mediante API:

1. Exporte los datos del artículo desde su sistema.
2. Transforme los datos exportados a un formato que coincida con el formato de datos del método API del tipo de artículo requerido.
3. Para cada artículo de la exportación, cree un script que invoque el método API requerido:
   • Crear artículo virtual
   • Crear moneda virtual
   • Crear un paquete de moneda virtual
   • Crear lote

Si quiere utilizar grupos de artículos, créelos antes en la interfaz de Cuenta del editor.

1. Abra su proyecto en la Cuenta del editor y, en la sección Items catalog vaya al tipo de artículo correspondiente que desee configurar:
   • Artículo virtual
   • Artículos virtuales
   • Claves del juego
   • Lotes
2. En la lista desplegable Manage catalog drop-seleccione Import items (JSON).

3. Escoja la acción:
   • Agregar nuevos artículos - solamente se agregarán artículos con nuevos códigos de artículo (SKU).
   • Agregar nuevos artículos y actualizar los existentes - se agregarán artículos con nuevos SKU y se actualizarán los datos de los artículos existentes.
   • Agregar los nuevos, actualizar los existentes, deshabilitar los artículos que faltan - se agregarán/actualizarán los artículos con SKU del archivo. Si hay un artículo en el catálogo, pero no existe el correspondiente SKU en el archivo, el estado del artículo en Cuenta del editor cambiará a Partially available - el artículo no puede comprarse por separado, pero está disponible como parte de un lote o bonificación.

4. Rellene el archivo para la importación:
   • Descargue la plantilla del archivo en la ventana de descargas y rellénela siguiendo el ejemplo que aparece a continuación.
   • Exporte los elementos y utilice el archivo exportado como plantilla.
   • Cree su propio archivo JSON y rellénelo según el ejemplo que aparece abajo.

Un ejemplo de archivo JSON completo:

  1{
  2    "virtual_currency": [
  3        {
  4            "sku": "Gem_test_import",
  5            "name": {
  6                "en": "Gem_test_import"
  7            },
  8            "type": "virtual_currency",
  9            "description": {
 10                "en": "my test imported currency"
 11            },
 12            "image_url": "https://cdn3.xsolla.com/img/misc/merchant/default-dc-image.png",
 13            "description": {
 14                "en": "my test imported currency",
 15                "de": "meine importierte Testwährung"
 16            },
 17            "attributes": [],
 18            "is_free": false,
 19            "order": 1,
 20            "groups": [],
 21            "regional_prices": [],
 22            "prices": [
 23                {
 24                    "amount": 2,
 25                    "currency": "USD",
 26                    "is_default": true,
 27                    "is_enabled": true
 28                }
 29            ],
 30            "media_list": [],
 31            "vc_prices": [],
 32            "is_enabled": true,
 33            "is_show_in_store": true,
 34            "regions": [],
 35            "limits": {
 36                "per_user": null,
 37                "per_item": null,
 38                "recurrent_schedule": null
 39            },
 40            "periods": [],
 41            "inventory_options": {
 42                "consumable": true,
 43                "expiration_period": null
 44            },
 45            "is_hard": false
 46        }
 47    ],
 48    "virtual_items": [
 49        {
 50            "sku": "event_access_test_import",
 51            "name": {
 52                "en": "Special Event Access_test_import"
 53            },
 54            "type": "virtual_good",
 55            "description": {
 56                "en": "Get special event access as a bonus only on your first purchase. Find the right doggy at the Robo-Dog Exhibition!"
 57            },
 58            "image_url": "https://cdn3.xsolla.com/img/misc/images/1e3ef1a96cc9dd8d98bc124d5d6fad79.png",
 59            "long_description": null,
 60            "attributes": [],
 61            "is_free": false,
 62            "order": 1,
 63            "groups": [
 64                "my_test_group"
 65            ],
 66            "regional_prices": [],
 67            "prices": [
 68                {
 69                    "amount": 35,
 70                    "currency": "USD",
 71                    "is_default": true,
 72                    "is_enabled": true
 73                }
 74            ],
 75            "media_list": [],
 76            "vc_prices": [],
 77            "is_enabled": true,
 78            "is_show_in_store": true,
 79            "regions": [],
 80            "limits": {
 81                "per_user": null,
 82                "per_item": null,
 83                "recurrent_schedule": null
 84            },
 85            "periods": [],
 86            "inventory_options": {
 87                "consumable": true,
 88                "expiration_period": null
 89            }
 90        }
 91    ],
 92    "virtual_currency_packages": [
 93        {
 94            "item_id": 441982,
 95            "sku": "small_gold_pack_test_import",
 96            "type": "bundle",
 97            "name": {
 98                "en": "Small gold pack"
 99            },
100            "bundle_type": "virtual_currency_package",
101            "description": {
102                "en": "Gold x100"
103            },
104            "image_url": "https://cdn3.xsolla.com/img/misc/images/ba43c46ea75fd5713c210f5736993a92.png",
105            "vc_prices": [],
106            "regional_prices": [],
107            "prices": [
108                {
109                    "amount": 5,
110                    "currency": "USD",
111                    "is_default": true,
112                    "is_enabled": true
113                }
114            ],
115            "is_enabled": true,
116            "is_show_in_store": true,
117            "regions": [],
118            "limits": {
119                "per_user": null,
120                "per_item": null,
121                "recurrent_schedule": null
122            },
123            "periods": [],
124            "attributes": [],
125            "long_description": null,
126            "media_list": [],
127            "order": 100000000,
128            "is_free": false,
129            "groups": [],
130            "content": [
131                {
132                    "sku": "Gem_test_import",
133                    "quantity": 100
134                }
135            ]
136        }
137    ],
138    "bundles": [
139        {
140            "item_id": 684024,
141            "sku": "start_pack_test_import_test_import",
142            "type": "bundle",
143            "name": {
144                "en": "Legendary Start Pack"
145            },
146            "bundle_type": "standard",
147            "description": {
148                "en": "Crystal x 1\nGem x 1"
149            },
150            "image_url": "https://cdn3.xsolla.com/img/misc/merchant/default-dc-image.png",
151            "regional_prices": [],
152            "prices": [
153                {
154                    "amount": 20,
155                    "currency": "USD",
156                    "is_default": true,
157                    "is_enabled": true
158                }
159            ],
160            "virtual_prices": [],
161            "is_enabled": true,
162            "is_show_in_store": true,
163            "regions": [],
164            "limits": {
165                "per_user": null,
166                "per_item": null,
167                "recurrent_schedule": null
168            },
169            "periods": [],
170            "attributes": [],
171            "long_description": null,
172            "media_list": [],
173            "order": 5,
174            "is_free": false,
175            "groups": [
176                "my_test_group"
177            ],
178            "content": [
179                {
180                    "sku": "Gem_test_import",
181                    "quantity": 1
182                },
183                {
184                    "sku": "event_access_test_import",
185                    "quantity": 1
186                }
187            ]
188        }
189    ]
190}

5. Cargue el archivo completo en el campo correspondiente de la ventana de importación.
6. Si ocurre algún error durante la importación, en la ventana de importación aparecerá una lista con estos errores y recomendaciones para su corrección. Haga los cambios necesarios en el archivo y cárguelo de nuevo.

Tras cargarlo correctamente, se crearán, actualizarán o desactivarán los artículos con los códigos de artículo (SKU) especificados.

También puede importar artículos usando la llamada de API Import items via JSON file.

Si crea un sitio web utilizando Web Shop o la plantilla Single game page, el bloque se agrega al sitio web de forma automática.

Si está creando un sitio web con otras plantillas y quiere añadir un bloque Store al sitio web:

1. Abra su proyecto en Cuenta del editor y vaya a Storefronts > Websites.
2. Haga clic en Open Site Builder.

3. Haga clic en Add Block en la plantilla del sitio.
4. Seleccionar de la lista el bloque Store.

5. En la lista desplegable, elija el tipo y el grupo del artículo que quiere vender en el sitio.

6. Para vender distintos tipos de artículos, añada secciones de tienda. Para ello, en el menú del bloque Store, haga clic en Add Store Section.
7. Para vender artículos en diferentes partes del sitio web, añada bloques de Store adicionales.

Puede añadir un botón de compra rápida de artículos en cualquier plantilla dentro de los siguientes bloques:

• Card grid
• Header
• Call-to-action
• Game editions
• Promo Slider

En la plantilla Single Game Page, el botón está ubicado en el Bloque principal.

Para personalizar el botón:

1. Vaya a uno de los bloques indicados.
2. En la parte derecha del creador de sitios web, acceda al botón.
3. En la lista desplegable de Action, seleccione Purchase Item.
4. En la lista desplegable de Item, elija el producto.