Lotes

Cómo funciona

Un lote es un conjunto de varios artículos que se venden como una sola unidad.

Características principales:

• Añadir artículos de distintos tipos a un lote:
  • moneda virtual
  • paquete de moneda virtual
  • claves del juego para plataformas preseleccionadas
  • artículos virtuales
  • lotes
• Lote gratuito.
• Configurar los precios del lote en monedas reales y virtuales. Puede establecer precios en varias monedas reales o virtuales. Asegúrese de seleccionar una moneda predeterminada en este caso.
• Establecer precios regionales para los lotes.
• Limitar el número de lotes disponibles para comprar.
• Establecer un límite de tiempo para mostrar los lotes en la tienda.
• Restringir la disponibilidad de lotes por región.

Restricciones:

• No puede añadir el mismo lote a un lote.
• No puede crear un lote vacío.
• Si un lote incluye claves y se agotan las disponibles, se pausa la venta de ese lote.
• La configuración de restricciones regionales para los lotes solo está disponible mediante llamadas API.

Cómo configurarlo

Para crear un lote:

2. Seleccionen Create manually y elijan Bundle en la lista desplegable.

3. En la sección General settings, indiquen 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, 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 Bundle items, seleccionen los SKU para añadir al lote. Se requiere al menos un artículo.

6. En la sección Price settings, definan los precios o creen un artículo gratuito:
   • Para establecer un precio, seleccionen Paid item, activen el conmutador Pricing in real currency y/o Pricing in virtual currency, y especifiquen el precio. Si es necesario, configuren los precios regionales.
   • Para crear un artículo gratuito, seleccionen Free item.

7. 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:
      • Daily.
      • Weekly.
      • Monthly.
      • Custom interval. El intervalo se calcula desde la fecha de inicio de visualización del artículo en la tienda.
      • No regular refresh.
   3. Configuren la programación del restablecimiento indicando los parámetros correspondientes al periodo seleccionado.

8. 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 y 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.

9. 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.

10. Si el artículo de pago se va a usar en cualquier mecánica con recompensa aleatoria (p. ej., cajas de botín o gacha), habiliten el conmutador Mark as paid randomized reward.

11. Seleccionen Create.

12. En la ventana que se abre, seleccionen el estado del artículo y luego seleccionen Continue.

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

Configurar mediante API

Para configurar los lotes, puede usar las llamadas de la subsección Admin en el grupo Bundles.

Para añadir una clave del juego para una plataforma seleccionada a un lote, pase la matriz content con los SKU de las plataformas necesarias a las llamadas Create bundle o Update bundle.

1"content": [
2  {
3     "sku": "brilliant_game_sku_steam",
4     "quantity": 1
5  }
6]

Para limitar el número de lotes disponibles para comprar, utilice las llamadas API Create bundle o Update bundle con los siguientes parámetros:

• limits — especifica el número máximo de lotes disponibles para comprar.
• limits.recurrent_schedule — define la frecuencia con la que se restablece el límite.

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

Mostrar lotes en la tienda

Los lotes se muestran en el catálogo según cómo esté implementado: a través del editor del sitio o mediante API.

Mostrar a través del editor del sitio

Para mostrar lotes en su sitio web:

1. Crear lotes.
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.

1. Crear lotes.

2. En su proyecto en la 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 editor.
   2. Seleccionen la página necesaria de la lista desplegable.

5. En el Store block, vayan a la sección Store.

6. En el Item type field, seleccionen Bundles.

7. En el campo Item group, seleccionen su grupo.
8. Elijan un diseño de la ficha de artículo.

9. Si lo necesitan, personalicen el diseño de la ficha activando las opciones correspondientes en la configuración del diseño de la ficha.

10. Después de realizar todos los cambios necesarios y preparar su sitio web para el lanzamiento:

    1. En la esquina superior derecha del editor del sitio, hagan clic en Publish.
    2. Marquen las casillas junto a las páginas que deseen publicar.
    3. Hagan clic en Publish.

Cuando el sitio esté publicado, estará disponible una sección con lotes. Si no se muestran lotes, comprueben que su estado esté establecido como Available y que no haya ningún límite de visualización basado en el tiempo activo.

Obtener información de los lotes mediante API

Si su catálogo está configurado mediante API, los datos del lote se devuelven mediante las llamadas disponibles en la subsección Catálogo:

• Obtener lista de lotes
• Obtener lista de lotes por el grupo especificado
• Obtener un lote específico

Establecer webhooks

Puede configurar qué datos del artículo se incluyen en los webhooks Successful payment for order y Order cancellation mediante la matriz items.

Conceder lotes a los usuarios

En función del tipo de artículo y de la configuración de integración, el lote se concede al usuario de una de las siguientes formas:

• 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 están incluidos en el webhook Successful payment for order.
• Si la entrega del contenido del lote no está deshabilitada, después de la compra de un lote, todos los artículos incluidos en el lote aparecen en la matriz items del webhook Successful payment for order como artículos independientes. Si un lote contiene otro lote, también se descompondrá y se enviará como artículos independientes.

Consulte la sección Configurar el seguimiento del estado del pedido para más detalles sobre este y otros métodos de obtención de datos de compra.