Artículos gratuitos

Cómo funciona

Los artículos gratuitos son aquellos que los usuarios pueden obtener sin gastar dinero virtual o real.

Los artículos gratuitos están disponibles en los siguientes casos:

• Venta de artículos dentro del juego: artículos virtuales, paquetes de moneda virtual y lotes.
• Venta de juegos y DLC mediante claves del juego.

Casos de uso:

• Artículos gratuitos ofrecidos en hitos del proyecto o fechas especiales, como un aniversario, para recompensar la fidelidad de los usuarios.
• Complementos gratuitos para usuarios que ya hayan comprado el juego base, como recompensa de fidelidad.
• Paquetes iniciales gratuitos disponibles en la tienda web para atraer a nuevos usuarios al juego.

Los artículos virtuales, la moneda virtual y los lotes gratuitos solo están disponibles para los usuarios autorizados. Las claves de juego gratuitas están disponibles tanto para usuarios autorizados como no autorizados. Los límites en el número de artículos gratuitos solo se pueden configurar para los usuarios autorizados.

Configurar artículos gratuitos

2. Hagan clic en Create manually y seleccionen Virtual items de la lista desplegable.

3. En la sección General settings, indiquen lo siguiente:
   1. SKU
   2. Uno o varios grupos a los que debe pertenecer el artículo (opcional).
   3. Nombre.
   4. Descripción breve.
   5. Descripción ampliada — para añadirla, activen el conmutador correspondiente (opcional).

4. En la sección Media, suban una o varias imágenes o vídeos (opcional), desde su dispositivo o mediante un enlace. En la tienda creada con el editor de sitios de Xsolla, todas las tarjetas de artículo muestran el archivo marcado como Main, mientras que los archivos restantes solo están disponibles en tarjetas de artículo con galería multimedia. El archivo marcado como Main también se devuelve en las respuestas de las llamadas API de obtención del catálogo.

5. En la sección Price settings, seleccionen Free item.

6. Para limitar la cantidad de artículos disponibles para la compra:
   1. Activen el conmutador en la sección Limits e indiquen la cantidad.
   2. Configuren la frecuencia de restablecimiento del límite. Para ello, seleccionen un periodo en la lista desplegable:
      1. Daily.
      2. Weekly.
      3. Monthly.
      4. Custom interval. El intervalo se calcula desde la fecha de inicio de visualización del artículo en la tienda.
      5. No regular refresh.
   3. Configuren la programación del restablecimiento indicando los parámetros correspondientes al periodo seleccionado.

7. Para configurar un límite de tiempo de visualización del artículo (opcional):

   1. Activen el conmutador en la sección Add specific display period.
   2. Especifiquen la zona horaria, el inicio y el final del periodo.

   Para dejar sin especificar el final del periodo de visualización del artículo, activen el conmutador No end date.

8. Configuren los atributos con una de las siguientes opciones (opcional):
   1. Añadan atributos y sus valores en formato JSON.
   2. Creen manualmente los atributos y sus valores y vincúlenlos a los artículos.

9. Seleccionen Create.
10. En la ventana que se abre, seleccionen el estado del artículo y seleccionen Continue.

El artículo creado aparecerá en la sección All items.

Configurar mediante API

Para que un artículo sea gratuito, transmita “is_free”: true en el cuerpo de la solicitud al llamar a las siguientes llamadas API Admin:

• Crear artículo virtual o Actualizar artículo virtual
• Crear juego, Actualizar juego por ID o Actualizar juego por SKU
• Crear moneda virtual o Actualizar moneda virtual
• Crear paquete de moneda virtual o Actualizar paquete de moneda virtual
• Crear lote o Actualizar lote Si desean limitar la cantidad de artículos gratuitos que un usuario puede recibir, pasen los siguientes parámetros en las llamadas de creación o actualización del artículo:
  • limits con la cantidad especificada
  • limits.recurrent_schedule con la frecuencia de restablecimiento del límite especificada

También pueden configurar el límite de tiempo de visualización del artículo en la tienda y establecer restricciones regionales.

Mostrar artículos gratuitos en el catálogo

Los artículos gratuitos se muestran en el catálogo en función de cómo esté implementado: a través del Site Builder o mediante API.

Mostrar a través del Site Builder

Para mostrar artículos gratuitos en su sitio web:

1. Crear artículos gratuitos.
   2. En su proyecto en la Cuenta del editor, vayan a la sección Storefronts > Websites.
   3. En el panel del sitio deseado, hagan clic en Open Site Builder.

   

2. En el proyecto en su cuenta para juegos para móviles, vayan a la sección Web Shop.
3. Hagan clic en el panel del sitio correspondiente.

4. Si su sitio incluye varias páginas, seleccionen la que necesiten:
   1. Hagan clic en el título de la página actual en la parte superior del constructor.
   2. Elijan la página necesaria en la lista desplegable.
5. En la sección Store, en el Item type, seleccionen el tipo de artículo gratuito y, si corresponde, especifiquen su grupo.
6. Configuren el diseño de la tarjeta del artículo.
7. Después de realizar todos los cambios necesarios y preparar su sitio web para el lanzamiento:
   1. En la esquina superior derecha del Site Builder, hagan clic en Publish.
   2. Marquen las casillas de las páginas que deseen publicar.
   3. Hagan clic en Publish.

Una vez publicado el sitio, estará disponible una sección con artículos gratuitos. Si los artículos no se muestran, comprueben que su estado sea “Available” y que no haya ningún límite de visualización basado en el tiempo activo.

Obtener información de artículos gratuitos mediante API

Si su catálogo está configurado mediante API, los datos de los artículos gratuitos se devuelven a través de las llamadas disponibles en la subsección Catalog:

• Obtener lista de artículos virtuales
• Obtener lista de monedas virtuales
• Obtener lista de paquetes de moneda virtual
• Obtener lista de lotes
• Obtener lista de juegos

Conceder artículos gratuitos a los usuarios

La forma en que se procesa un pedido con artículos gratuitos depende de si se utiliza una cesta durante la compra.

Si un usuario compra un artículo sin usar la cesta, utilicen la llamada API Create order with specified free item.

Cuando un usuario compra artículos mediante la cesta, pueden darse los siguientes casos:

• Si la cesta del usuario contiene artículos de pago y gratuitos, utilicen las llamadas de creación del pedido Create order with all items from particular cart o Create order with all items from current cart. En este caso, el usuario completa el pago a través de la Interfaz de pago.
• Si la cesta del usuario contiene solo artículos gratuitos, utilicen las llamadas API Create order with free cart o Create order with particular free cart. En este caso, no se usa la Interfaz de pago.

  En ambos casos, Xsolla envía el webhook Successful payment for order con los datos del artículo que se usan para conceder los artículos al usuario. Para los artículos gratuitos, el parámetro order.invoice_id en el webhook se establece en null.

Ejemplo de un objeto de pedido para artículos gratuitos:

 1{
 2  "method": "POST",
 3  "url": "https://mybestgame.com/xsolla/notification",
 4  "body": {
 5    "items": [
 6      {
 7        "sku": "gift_direct_game_reward-supercoin",
 8        "type": "virtual_currency",
 9        "is_pre_order": false,
10        "quantity": 500,
11        "amount": "0",
12        "promotions": [
13
14        ]
15      },
16      {
17        "sku": "package-500_supercoin",
18        "type": "bundle",
19        "is_pre_order": false,
20        "quantity": 1,
21        "amount": "0",
22        "promotions": [
23
24        ]
25      },
26      {
27        "sku": "xsolla-giveaway_offer_11_14_22",
28        "type": "bundle",
29        "is_pre_order": false,
30        "quantity": 1,
31        "amount": "0",
32        "promotions": [
33
34        ]
35      }
36    ],
37    "notification_type": "order_paid",
38    "order": {
39      "id": 12345678,
40      "mode": "default",
41      "currency_type": "unknown",
42      "currency": null,
43      "amount": "0",
44      "status": "paid",
45      "platform": "xsolla",
46      "comment": null,
47      "invoice_id": null,
48      "promotions": [
49
50      ]
51    },
52    "user": {
53      "external_id": "1234567812345678",
54      "email": null
55    }
56  },
57  "headers": {
58    "Authorization": "Signature 3b840ccefea111dcdfd111db1fdc6df969a3ec11",
59    "Accept": "application/json",
60    "Content-Type": "application/json"
61  },
62  "type": "webhook_payment",
63  "callback_parameters": {
64    "order_id": 12345678
65  }
66}

Dependiendo de la configuración de la integración de su proyecto, los artículos se conceden al usuario de una de las siguientes maneras:

• Si han integrado PlayFab, la moneda virtual y los artículos se conceden automáticamente al inventario de PlayFab del usuario.
• Si usan un sistema de entrega personalizado, todos los artículos y la moneda virtual se conceden en su lado. Recomendamos configurar un controlador de webhook para recibir los datos del pedido en su backend. Los datos necesarios se incluyen en el webhook Successful payment for order. Consulte la sección Configurar el seguimiento del estado del pedido para más detalles sobre esta y otras opciones de obtención de datos de compra.