Limitación del tiempo de visualización de los artículos en la tienda

Cómo funciona

Puede establecer el periodo de visualización de un artículo en la tienda para:

• Mantener el catálogo actualizado en cada momento, por ejemplo, durante las promociones de temporada.
• Crear un artículo con antelación sin mostrarlo en el catálogo.
• Motivar a los usuarios a comprar mostrando un temporizador junto al artículo. Si crea una interfaz de catálogo con el creador de sitios web, el temporizador se muestra automáticamente. Si crea el catálogo con una interfaz personalizada, debe implementar el temporizador en su interfaz.

La configuración del límite de tiempo está disponible 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 de juego

Configurar y actualizar límites

Para crear un artículo con un límite de usos:

2. Haga clic en Create manually y seleccione Virtual item en la lista desplegable.

3. En la sección General settings, especifique lo siguiente:
   • SKU
   • uno o varios grupos a los que debe pertenecer el artículo (opcional)
   • nombre
   • descripción breve
   • descripción ampliada: para añadirla, active la opción correspondiente (opcional)

4. En la sección Media, suba 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 web 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 una 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, defina los precios o cree un artículo gratuito:
   • Para establecer un precio, seleccione Paid item, active la opción Pricing in real currency o Pricing in virtual currency, y especifique el precio. Si es necesario, configure los precios regionales.
   • Para crear un artículo gratuito, seleccione Free item.

6. Para limitar la cantidad de artículos disponibles para la compra:
   1. Active la opción en la sección Limits e indique la cantidad.
   2. Configure la frecuencia de restablecimiento del límite. Para ello, seleccione 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. Configure 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. Active la opción en la sección Add specific display period.
   2. Especifique la zona horaria, el inicio y el final del periodo.

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

8. Configure los atributos con una de las siguientes opciones (opcional):
   1. Añada atributos y sus valores en formato JSON.
   2. Cree manualmente los atributos y sus valores y vincúlelos a los artículos.

9. Si el artículo de pago se va a usar en alguna mecánica con recompensa aleatoria (por ejemplo, cajas de botín o gacha), active la opción Mark as paid randomized reward.

10. Haga clic en Create.

11. En la ventana que se abre, seleccione el estado del artículo y haga clic en Continue.

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

Configurar y actualizar mediante llamadas API

Para establecer un límite de tiempo de visualización de los artículos en la tienda, utilice las siguientes llamadas API:

• Crear artículo virtual o Actualizar artículo virtual
• Crear moneda virtual o Actualizar moneda virtual
• Crear paquete de moneda virtual o Actualizar paquete de moneda virtual
• Crear lote o Actualizar lote
• Crear juego, Actualizar juego por SKU o Actualizar juego por ID

Transmita los siguientes parámetros en la llamada API de creación o actualización del artículo:

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

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

Puede configurar varios periodos para mostrar un artículo en la tienda. Para ello, transmita una matriz de objetos con las fechas de inicio y fin de todos los periodos en las llamadas API.

Ejemplo:

 1"periods": [
 2      {
 3        "date_from": "2022-06-10T14:00:00+03:00",
 4        "date_until": "2022-06-30T14:00:00+03:00"
 5      },
 6       {
 7        "date_from": "2022-07-10T14:00:00+03:00",
 8        "date_until": "2022-07-30T14:00:00+03:00"
 9      },
10       {
11        "date_from": "2022-08-10T14:00:00+03:00",
12        "date_until": "2022-08-30T14:00:00+03:00"
13      }
14]

Las llamadas API de obtención del catálogo devuelven los artículos que se muestran en la tienda en el momento de la solicitud. Para obtener información sobre los artículos cuyo periodo de visualización aún no ha comenzado o ya ha finalizado, transmita el parámetro show_inactive_time_limited_items con el valor 1 al solicitar el catálogo.

Mostrar los límites en el catálogo de artículos

La visualización de los artículos de duración limitada en el catálogo depende de cómo se implemente: con el creador de sitios web o mediante la API.

Mostrar mediante el creador de sitios web

Si utiliza un creador de sitios web, los límites de tiempo se muestran automáticamente. Treinta días antes de que finalice el periodo de venta de un artículo, aparece en la tarjeta del artículo un temporizador que muestra el tiempo que queda:

• Si queda más de una semana hasta el final del periodo de venta, el temporizador muestra días y horas.
• Si queda más de un día hasta el final del periodo de venta, el temporizador muestra horas y minutos.
• Si queda menos de un día hasta el final del periodo de venta, el temporizador muestra minutos y segundos.

Obtener información de límites mediante la API

Si el catálogo se implementa mediante la API, la información sobre el periodo de venta del artículo se devuelve en la matriz items.periods en las siguientes llamadas API relacionadas con el catálogo:

• 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

Los datos sobre las fechas en las que un artículo está disponible para su venta se pueden utilizar para mostrar límites en el catálogo, por ejemplo, para mostrar el periodo durante el cual un usuario puede comprar el artículo.