Lotes

Cómo funciona

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

Funciones principales:

• Añada artículos de distintos tipos a un lote:
  • moneda virtual (incluida la moneda dependiente de la plataforma)
  • paquete de moneda virtual
  • claves de juego para plataformas preseleccionadas
  • artículos virtuales, incluidos los de duración limitada
  • lotes
• Establezca los precios de los lotes en monedas reales y virtuales. Puede establecer precios en varias monedas reales o virtuales. Asegúrese de seleccionar una moneda predeterminada en este caso.
• Lote gratuito.
• Limite el número de lotes disponibles para comprar.
• Limite el tiempo que se muestran los lotes en la tienda.

• A través de PlayFab: para monedas virtuales, artículos virtuales, artículos de duración limitada, y lotes, si la integración con PlayFab está activada.
• Por correo electrónico: para claves de juego.
• A través de su sistema de entrega utilizando los datos del webhook Pago del pedido realizado correctamente. Este método se aplica a todos los tipos de artículos si:
  • No se utiliza la integración de PlayFab.
  • Prefiere gestionar la entrega de artículos a los usuarios en su servidor.

1. En el momento de la compra, si la inclusión del contenido del lote no está desactivada, todos los artículos incluidos en el lote se transmiten a la matriz de items como una lista de artículos individuales. Si el lote contiene otro lote, su contenido también se transmite como artículos individuales.

Cuando se reembolsa un lote, por ejemplo, por cancelación de la transacción, se envía el webhook Cancelación del pedido. Utilice los datos del webhook para descontar los artículos comprados de la cuenta del usuario.

Restricciones:

• No puede añadir el mismo lote al lote.
• No puede crear un lote vacío.
• La venta de lotes se suspende cuando ya no le quedan claves para vender y estas se incluyen en el lote.

Limitar el número de lotes disponibles para la compra

Puede limitar la compra de lotes. Por ejemplo, puede limitar:

• el número de lotes por usuario
• lotes de bienvenida que solo se pueden comprar una vez

Si el usuario ha alcanzado el límite establecido, el lote no se mostrará en el catálogo. Si el lote contiene un paquete o artículo de moneda virtual con un límite de compra y el usuario ya ha comprado la cantidad permitida, el lote no se mostrará en el catálogo.

Puede mostrar el número máximo disponible de lotes y el número restante de lotes que está disponible para el usuario.

Para establecer un límite de compra al crear un lote en Cuenta del editor, establezca el conmutador Limit number of times one user can buy this bundle en la posición On y especifique el número de veces que se puede comprar el lote.

Puede utilizar los métodos de la subsección Catálog del grupo de métodos Lotes para obtener información sobre los lotes.

En la respuesta, recibirá la siguiente información además de la información sobre el lote:

• el número máximo de lotes que un usuario puede comprar
• el número restante de lotes 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.

 1{
 2  "items": [
 3    {
 4      "sku": "kg_1",
 5      "name": "kg_10.00_bundle",
 6      "type": "bundle",
 7      "description": "pricePoint_44056_1",
 8      "image_url": null,
 9      "long_description": null,
10      "attributes": {
11        "external_id": "genre",
12        "name": "Genre",
13        "values": [
14          {
15            "external_id": "genre_e3364991f92e751689a68b96598a5a5a84010b85",
16            "value": "Casual"
17          },
18          {
19            "external_id": "genre_eba07bfd0f982940773cba3744d97264dd58acd7",
20            "value": "Strategy"
21          },
22          {
23            "external_id": "genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8",
24            "value": "Mobile"
25          }
26        ]
27      },
28      "is_free": false,
29      "order": 999,
30      "groups": [],
31      "price": {
32        "amount": 9.99,
33        "currency": "USD",
34        "amount_without_discount": 9.99
35      },
36      "total_content_price": {
37        "amount": 10.99,
38        "currency": "USD",
39        "amount_without_discount": 10.99
40      },
41      "media_list": [],
42      "virtual_prices": [],
43      "can_be_bought": true,
44      "bundle_type": "standard",
45      "limits": {
46        "$ref": "./Catalog_item_limits.yaml"
47      },
48      "content": [
49        {
50          "sku": "big_rocket",
51          "name": "Big Rocket",
52          "description": "Big Rocket - short description.",
53          "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
54          "type": "virtual_currency",
55          "quantity": 100,
56          "virtual_item_type": "non_consumable",
57          "attributes": {
58            "external_id": "size",
59            "name": "Size",
60            "values": [
61              {
62                "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
63                "value": "Large"
64              }
65            ]
66          },
67          "is_free": false,
68          "groups": [],
69          "price": {
70            "amount": 10.99,
71            "currency": "USD",
72            "amount_without_discount": 10.99
73          },
74          "virtual_prices": [],
75          "limits": {
76            "per_user": {
77              "total": 5,
78              "available": 5
79              },
80            "per_item": null
81           },
82          }
83        }
84      ]
85    }
86  ]
87}

Limitar el tiempo de visualización de los lotes en la tienda

• mantener la relevancia del catálogo en un momento determinado, por ejemplo, durante la temporada de ventas navideñas
• crear un lote por adelantado sin mostrarlo en el catálogo
• estimular a los usuarios para que compren lotes mostrando un temporizador junto al artículo

Para establecer un límite de tiempo para visualizar un lote 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 lote, marque la casilla No end date.

Para establecer un límite de tiempo para mostrar un lote en la tienda mediante API, transmita los siguientes parámetros en la llamada API Crear lote o Actualizar lote:

• 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 lote en la tienda. Para ello, en el método Crear lote o Actualizar lote, transmita una matriz de objetos con las fechas de inicio y fin de todos los periodos.

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]

¿Quién puede utilizarlo?

Para socios que deseen vender grupos de artículos a un precio inferior al total inicial de todos los artículos del lote, lo cual aumenta las ventas y ayuda a conseguir nuevos jugadores.

Cómo conseguirlo

Flujo de integración

1. Establecer un lote.
2. Implementar la obtención de lotes en un catálogo.

Establecer lote

• a través de Cuenta del editor
• o a través de métodos API

Configurar a través de la Cuenta del editor

1. Abra su proyecto en Cuenta del editor y vaya a Store > Bundles.
2. Haga clic en + y seleccione Create bundle en la lista desplegable.
3. Añada:
   • Imagen (opcional).
   • SKU.
   • Uno o varios grupos a los que debe pertenecer el lote.
   • Nombre.
   • Descripción (opcional).
   • Contenido.
4. Establezca el precio del lote:
1. Defina los precios o cree un lote gratuito:
1. Para crear un lote gratuito, en el campo Paid or Free, seleccione Free bundle.
2. Para establecer un precio, en el campo Paid or Free, seleccione Paid bundle y especifique el precio en monedas reales o virtuales. Si es necesario, establezca precios regionales.
2. Establezca un límite de cantidad de compra para el lote (opcional). Para ello, active la opción Limit number of times one user can buy bundle y especifique el número de lotes que cada usuario puede comprar.
5. Haga clic en Next.
6. Configure cómo se mostrará el lote en la tienda:
   • Cambie el estado a Available.
   • Establezca un límite de tiempo para mostrar el lote en la tienda (opcional). Para ello, seleccione Time period y especifique la zona horaria, el inicio y el final del periodo. Si no quiere indicar el final del periodo, marque la casilla No end date.
7. Haga clic en Next.
8. Revise la configuración y haga clic en Save.

Configuración mediante métodos API

Agregar clave de juego al lote

Para añadir una clave de juego para una plataforma seleccionada a un lote, transmita una matriz content con los códigos de artículo (SKU) de las plataformas correspondientes a los métodos Create bundle o Update bundle.

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

Establecer restricciones regionales

Para establecer restricciones regionales para un lote, transmita una matriz con los ID de las regions admitidas a los métodos Create bundle o Update bundle.

1"regions": [{
2     “id”: “123”
3  }, {
4     “id”: “456”
5  }
6]

Establecer precios regionales

Para establecer los precios regionales de un lote, transmita una matriz de prices con la configuración de las regiones a los métodos Create bundle o Update bundle.

 1"prices": [
 2      {
 3        "amount": 100,
 4        "currency": "USD",
 5        "is_enabled": true,
 6        "is_default": true
 7      },
 8      {
 9        "amount": 200,
10        "currency": "CZK",
11        "country_iso": "CZ",
12        "is_enabled": false,
13        "is_default": false
14      }
15    ]

Obtener lotes en un catálogo