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 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.
• Incentivar a los usuarios a comprar artículos mostrando un temporizador junto al artículo. Si crea una interfaz de catálogo utilizando el creador de sitios web, el temporizador se muestra automáticamente. Si crea el catálogo utilizando una interfaz personalizada, deberá implementar el temporizador por su cuenta.

• la venta de artículos del juego: artículos virtuales, paquetes de moneda virtual y lotes
• la venta de juegos y DLC a través de claves de juego

Configurar y actualizar límites

Configurar y actualizar en Cuenta del editor

1. Abra su proyecto en Cuenta del editor y vaya a Items catalog > All items > Virtual items.
2. Haga clic en Add y seleccione Virtual items.

3. Especifique los siguientes parámetros:
   • imagen
   • SKU
   • uno o varios grupos a los que debe pertenecer el artículo
   • nombre
   • descripción
   • precios

4. Para limitar el número de veces que un usuario puede comprar un artículo, active la opción Limit the number of times one user can buy this item y especifique el límite.
5. Para establecer la frecuencia con la que se actualizan los límites:
   1. En la lista desplegable, seleccione el periodo:
      • Daily
      • Weekly
      • Monthly
      • Custom interval. El intervalo se calcula a partir de la fecha de inicio del periodo de visualización del artículo en la tienda.
      • No regular refresh

1. 2. Configure la programación de actualizaciones especificando los parámetros correspondientes al periodo.

6. Para establecer un periodo de visualización del artículo en el catálogo, seleccione Limited time, especifique la zona horaria y la fecha de inicio y fin. Si quiere que el artículo esté disponible de forma indefinida, seleccione No end date.
7. Haga clic en Create item.

Configuración y actualización mediante llamadas API

Para establecer un límite de tiempo para mostrar 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

• 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 varios periodos para visualizar 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 recuperació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 un valor de 1 al solicitar el catálogo.

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

La visualización de los artículos con límite de tiempo en el catálogo depende de cómo se implemente: a través del creador de sitios web o mediante API.

Mostrar a través del 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 un temporizador en la ficha del artículo que muestra el tiempo que queda:

• Si queda más de una semana para que termine la venta, el temporizador muestra los días y las horas.
• Si queda más de un día para que termine la venta, el temporizador muestra las horas y los minutos.
• Si queda menos de un día para que termine la venta, el temporizador muestra los minutos y los segundos.

Obtener información sobre límites a través de la API

Si el catálogo se implementa mediante 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