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:

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:

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 Catalog del grupo de métodos Virtual Items & Currency 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.

Nota

Para los usuarios no autorizados, siempre se muestra el número máximo de artículos que pueden comprar. Para mostrar al usuario el número restante de artículos (sujeto al límite actual), transmita los datos de autorización del usuario cuando solicite el catálogo de artículos empleando los métodos de la subsección Catalog del grupo de métodos Artículos virtuales y moneda virtual.

Para visualizar correctamente el número de artículos que están disponibles para el usuario, es necesario configurar la autenticación.

Ejemplo de solicitud:
Copy
Full screen
Small screen

{
  "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
      },
}
Nota

Xsolla garantiza que no se superen los límites e impide que los usuarios adquieran más artículos que los que establece el límite.

Al abrir la interfaz de pago y abonar un artículo, todos los pedidos pendientes de pago con este artículo quedan anulados.

Ejemplo: el usuario puede abrir el formulario de pago de un artículo con restricción de compra en varias pestañas del navegador hasta que el artículo haya sido adquirido. Esto origina automáticamente la creación de varios pedidos para el mismo artículo. Después de comprar un artículo en una pestaña, Xsolla anulará todos los pedidos no abonados con el mismo artículo.

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

Puede establecer el periodo de visualización de un artículo en la tienda en:
  • 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
Nota
Cuando cree una interfaz de catálogo utilizando Site Builder, el temporizador se muestra automáticamente. Cuando cree un catálogo en su propia interfaz, deberá implementar el temporizador.
Para establecer un límite de tiempo para visualizar un artículo en la tienda mediante Cuenta del editor, seleccione Time period y especifique la zona horaria, el inicio y el final del periodo. Para no indicar el final del periodo de visualización del artículo, marque la casilla No end date.
Nota
Tras crear un artículo virtual, una moneda virtual o un paquete de moneda virtual, puede establecer los estados para determinar si el artículo está disponible, no disponible o parcialmente disponible.
Para establecer un límite de tiempo para mostrar un artículo en la tienda mediante API, transmita los siguientes parámetros en la llamada API Create virtual item o la Update virtual item:
  • 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 Create virtual item o Update virtual item, transmita una matriz de objetos con las fechas de inicio y fin de todos los periodos.

Ejemplo:

Copy
Full screen
Small screen
    "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:

    Configuración mediante Cuenta del editor

    Configuración mediante llamadas API

    Utilice las llamadas API de la subsección Admin del grupo Virtual Items & Currency para configurar artículos virtuales.
    Aviso
    Los métodos de la subsección Admin no están creados para generar un catálogo en la tienda en el frontend. Debería usarlos para páginas de destino, tiendas web y aplicaciones lógicas dentro del juego.

    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
    Aviso

    Para obtener más información sobre cómo trabajar con claves API, consulte la Referencia de la API.

    Recomendaciones clave:

    • Guarde la clave de API generada en su servidor. Puede ver la clave de API en la Cuenta del editor solo una vez cuando se crea.
    • Mantenga su clave de API en secreto. Proporciona acceso a su cuenta personal y a sus proyectos en Cuenta del editor.
    • La clave de API debe almacenarse en su servidor y nunca en archivos binarios o en el front-end.

    Si una llamada API que necesita no contiene el parámetro de ruta project_id, use la clave de API que sea válida en todos los proyectos de la empresa para establecer la autorización.

    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

    Para establecer restricciones regionales para los artículos virtuales, transmita una matriz de objetos con los identificadores de las regiones en las que el artículo estará disponible a las llamadas Create item o Update item.
    Copy
    Full screen
    Small screen
    "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.

    Copy
    Full screen
    Small screen
    "regional_prices": [{
         “region_id”: “123”,
         “country_iso”: “CHN”,
         “amount”: 40,
         “currency_iso”: “CNY”,
         “is_default”: true,
         “is_enabled”: true
      }
    ]
    
    Nota
    Debe configurar las regiones en el proyecto con antelación. Para ello, contacte con su gestor del éxito del cliente o envíe un correo electrónico a csm@xsolla.com.
    ¿Te ha resultado útil este artículo?
    ¡Gracias!
    ¿Hay algo en lo que podamos mejorar? Mensaje
    Lo sentimos
    Por favor, cuéntanos por qué no te ha resultado útil este artículo. Mensaje
    ¡Gracias por tu mensaje!
    Nos ayudará a mejorar tu experiencia.
    Última actualización: 10 de Octubre de 2023

    ¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.

    Informar de un problema
    Nos esforzamos por ofrecer contenido de calidad. Tus comentarios nos ayudan a mejorar.
    Déjanos tu correo electrónico para que te podamos responder
    ¡Gracias por tu mensaje!