Artículos virtuales

Cómo funciona

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

Características principales:

• Establecer precios en moneda real y virtual.
• Configurar catálogos con varios niveles.
• Determinar automáticamente la moneda y el país del usuario.
• Limitar el número de artículos disponibles para la compra.
• Limitar el tiempo de visualización de los artículos en la tienda.
• Artículos gratuitos.

Características de la configuración de fijación de precios:

• Un artículo puede tener el precio tanto en moneda real como virtual.
• Puede establecer los precios en varias monedas reales o virtuales. Asegúrese de seleccionar una moneda por defecto en este caso.
• Puede crear un artículo sin especificar su precio en moneda real o virtual. Si dicho artículo se muestra en la tienda, estará disponible para los usuarios de forma gratuita.

Restricciones de configuración de fijación de precios:

• No puede crear un artículo con un valor de precio igual a cero.

Existen 3 tipos de artículos virtuales:

• Consumibles
• No consumibles
• Ártículos de duración limitada

Artículos virtuales consumibles

Un artículo consumible es un artículo del inventario que se se puede tener en grandes cantidades y comprar varias veces. Su cantidad disminuye cuando los usuarios lo consumen.

Características principales:

• Reponer las existencias de artículos en el inventario.
• Almacenar muchas instancias del mismo artículo en el inventario del usuario.
• Puede consumirse desde el lado del cliente.

Por ejemplo: Granadas, balas, etc.

Artículos virtuales no consumibles

Un artículo no consumible es un artículo del inventario que puede acumularse o comprarse una sola vez.

Características principales:

• Los usuarios solo pueden tener una unidad de este artículo en el inventario.
• No se puede retirar del inventario al ser consumido en el lado del cliente. Solo se puede retirar mediante un método del servidor.

Ejemplo: Acceso a una ubicación, estado, aspectos estéticos, DLC preinstalado , opción SIN ANUNCIOS para juegos móviles, etc.

Artículos de duración limitada

Un artículo de duración limitada es una compra única. El usuario tiene que volver a comprarlo cuando expira.

Características principales:

• Se vuelve inactivo cuando expira.
• El usuario vuelve a comprar esta suscripción para activarlo.

Ejemplo: Battle Pass, Season Pass, acceso temporal a un elemento estético, un artículo o contenido adicional interno del juego.

Para conocer más detalles, consulte la receta artículos de duración limitada.

Limitar el número de artículos disponibles para la compra

Puede limitar la compra de artículos. Por ejemplo, puede limitar:

• el número de artículos por usuario
• artículos de bienvenida que solo están disponibles para la compra una vez

Si el usuario ha alcanzado el límite especificado, el artículo no se mostrará en el catálogo.

Puede mostrar el número máximo disponible de artículos y el número restante de artículos que está disponible para el usuario.

Para establecer un límite de compra al crear un artículo en Cuenta del editor, establezca el conmutador Limit number of times one user can buy this item en la posición On y especifique el número de veces que se puede comprar el artículo.

Puede utilizar los métodos de la subsección Catálogo del grupo de métodos Artículos virtuales y moneda para obtener información sobre los artículos.

En la respuesta, recibirá la siguiente información además de la información sobre el artículo virtual:

• el número máximo de artículos que un usuario puede comprar
• el número restante de artículos disponibles que el usuario puede comprar

Puede obtener más información sobre cómo establecer o actualizar las restricciones en las instrucciones de Límites para el usuario.

{
  "items": [
    {
      "sku": "big_rocket",
      "name": "Big Rocket",
      "groups": [
        {
          "external_id": "accessory",
          "name": "Accessory"
        }
      ],
      "attributes": [
        {
          "external_id": "stack_size",
          "name": "Stack size",
          "values": [
            {
              "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
              "value": "5"
            }
          ]
        }
      ],
      "type": "virtual_good",
      "description": "Big Rocket - description",
      "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
      "is_free": false,
      "price": {
        "amount": "100.99",
        "amount_without_discount": "100.99",
        "currency": "USD"
      },
      "virtual_prices": [
        {
          "amount": 100,
          "sku": "vc_test",
          "is_default": true,
          "amount_without_discount": 100,
          "image_url": "http://image.png",
          "name": "SHOTGUN FOR TRUE RAIDERS",
          "type": "virtual_currency",
          "description": "description"
        }
      ],
      "can_be_bought": true,
      "inventory_options": {
        "consumable": {
          "usages_count": 1
        },
        "expiration_period": {
          "type": "day",
          "value": 1
        }
      },
      "virtual_item_type": "non_renewing_subscription",
      "limits": {
        "per_user": {
            "total": 5,
            "available": 5
        },
        "per_item": null
      },
}

Limitar el tiempo de visualización de los artículos en la tienda

• mantener la relevancia del catálogo en un momento determinado, por ejemplo, durante la temporada de ventas navideñas
• crear un artículo por adelantado sin mostrarlo en el catálogo
• estimular a los usuarios para que compren artículos mostrando un temporizador junto al artículo

• periods[0].date_from con la fecha y la hora del inicio del periodo de visualización del artículo en formato YYYY-MM-DDThh:mm:ss±TMZ, en el cual TMZ es el indicador de zona horaria en formato GMT hh:mm.

• periods[0].date_until con la fecha y hora del final del periodo de visualización del artículo en formato YYYY-MM-DDThh:mm:ss±TMZ, en el cual TMZ es el indicador de zona horaria en formato hh:mm GMT. Para no indicar el final del periodo de visualización de un artículo, transmita null.

Puede establecer múltiples periodos para mostrar un artículo en la tienda. Para ello, en el método Crear artículo virtual o Actualizar artículo virtual, transmita una matriz de objetos con las fechas de inicio y fin de todos los periodos.

Ejemplo:

"periods": [
      {
        "date_from": "2022-06-10T14:00:00+03:00",
        "date_until": "2022-06-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-07-10T14:00:00+03:00",
        "date_until": "2022-07-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-08-10T14:00:00+03:00",
        "date_until": "2022-08-30T14:00:00+03:00"
      }
]

¿Quién puede utilizarlo?

• Socios que deseen establecer una economía o monetización del juego añadiendo moneda virtual al juego y vendiendo artículos virtuales a cambio de esta moneda.
• Para socios que hayan integrado In-Game Store y deseen establecer un nuevo tipo de producto: artículos virtuales.

Cómo conseguirlo

Flujo de integración

1. Configurar artículos virtuales y grupos de artículos virtuales.
2. Configurar restricciones regionales y precios regionales.

Configurar artículos virtuales y grupos de artículos virtuales

Para establecer artículos virtuales, hay que configurar grupos de artículos virtuales. Los grupos permiten tener un catálogo multinivel. Los artículos que no tienen un grupo especificado se añaden al grupo Ungrouped.

Para establecer artículos virtuales y grupos de artículos virtuales, puede:

• utilizar las funciones de Cuenta del editor
• utilizar llamadas API

Configuración mediante Cuenta del editor

Configuración mediante llamadas API

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

• Merchant ID se muestra:
  • en la sección 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>/<Publisher Account section>.

• Clave de API se muestra en la Cuenta del editor solo una vez cuando se crea y debe almacenarse en su servidor. Puede crear una nueva clave en la siguiente sección:
  • Company settings > API keys
  • Project settings > API keys

Utilice las llamadas API de la subsección Catalog del grupo Virtual Items & Currency para obtener el catálogo de artículos virtuales en el lado del cliente. Estas llamadas no requieren autorización básica.

Utilice la llamada API Get virtual items list para obtener la lista completa de artículos no divididos en grupos. Para obtener la lista de artículos del grupo definido, transmita el parámetro external_id a la llamada Get items list by specified group.

Configurar restricciones regionales y precios regionales

"regions": [{
     “id”: “123”
  }, {
     “id”: “456”
  }
]

Para establecer precios regionales para artículos virtuales, transmita una matriz de objetos con la configuración de precios regionales a las llamadas API Create item o Update item.

"regional_prices": [{
     “region_id”: “123”,
     “country_iso”: “CHN”,
     “amount”: 40,
     “currency_iso”: “CNY”,
     “is_default”: true,
     “is_enabled”: true
  }
]