Lotes

Cómo funciona

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

Características principales:

• Se pueden añadir artículos de diferentes tipos a un paquete:
  • moneda virtual (incluida la moneda dependiente de la plataforma)
  • paquete de moneda virtual
  • claves del juego para plataformas preseleccionadas
  • artículos virtuales, incluidos artículos de duración limitada
  • lotes
• Se puede establecer el precio del paquete en monedas reales y virtuales.
• Lote gratuito.
• Limitación del número de paquetes disponibles para la compra.
• Limitación del tiempo de visualización de los lotes en la tienda.

Un lote se desempaqueta automáticamente después de una compra realizada correctamente. Si un lote incluye otro lote, el paquete incluido se descompone automáticamente en artículos independientes.

El método de entrega de artículos de un lote desempaquetado depende del tipo de artículo:

• paquetes de moneda virtual, artículos virtuales, artículos de duración limitada, y los paquetes se entregan al:
  • inventario (método por defecto)
  • PlayFab, si se configuró la integración
• las claves de juego se entregan al :
  • correo electrónico (método por defecto)
  • PlayFab, si se configuró la integración

Cuando el comprador devuelve el lote cancelando una transacción (por ejemplo), todos los artículos transferidos del paquete se retiran automáticamente de la cuenta del usuario. Si ha utilizado algunos de los artículos, se le retirarán los que queden.

Restricciones:

• No puede añadir los siguientes artículos al lote:
• el mismo lote
• bienes físicos
• No puede crear un lote vacío.
• Las ventas de lotes se suspenden cuando usted se queda sin claves para vender y estas claves se incluyen en el lote.
• El precio del lote debe ser un valor fijo de moneda real o virtual.
• Sólo puede configurar restricciones regionales para un lote mediante API.

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

{
  "items": [
    {
      "sku": "kg_1",
      "name": "kg_10.00_bundle",
      "type": "bundle",
      "description": "pricePoint_44056_1",
      "image_url": null,
      "long_description": null,
      "attributes": {
        "external_id": "genre",
        "name": "Genre",
        "values": [
          {
            "external_id": "genre_e3364991f92e751689a68b96598a5a5a84010b85",
            "value": "Casual"
          },
          {
            "external_id": "genre_eba07bfd0f982940773cba3744d97264dd58acd7",
            "value": "Strategy"
          },
          {
            "external_id": "genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8",
            "value": "Mobile"
          }
        ]
      },
      "is_free": false,
      "order": 999,
      "groups": [],
      "price": {
        "amount": 9.99,
        "currency": "USD",
        "amount_without_discount": 9.99
      },
      "total_content_price": {
        "amount": 10.99,
        "currency": "USD",
        "amount_without_discount": 10.99
      },
      "media_list": [],
      "virtual_prices": [],
      "can_be_bought": true,
      "bundle_type": "standard",
      "limits": {
        "$ref": "./Catalog_item_limits.yaml"
      },
      "content": [
        {
          "sku": "big_rocket",
          "name": "Big Rocket",
          "description": "Big Rocket - short description.",
          "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
          "type": "virtual_currency",
          "quantity": 100,
          "virtual_item_type": "non_consumable",
          "attributes": {
            "external_id": "size",
            "name": "Size",
            "values": [
              {
                "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
                "value": "Large"
              }
            ]
          },
          "is_free": false,
          "groups": [],
          "price": {
            "amount": 10.99,
            "currency": "USD",
            "amount_without_discount": 10.99
          },
          "virtual_prices": [],
          "limits": {
            "per_user": {
              "total": 5,
              "available": 5
              },
            "per_item": null
           },
          }
        }
      ]
    }
  ]
}

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 Create bundle o Update bundle:

• 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 Create bundle o Update bundle, transmita una matriz de objetos con las fechas de inicio y fin de todos los periodos.

Ejemplo:

"periods": [
      {
        "date_from": "2022-06-10T14:00:00+03:00",
        "date_until": "2022-06-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-07-10T14:00:00+03:00",
        "date_until": "2022-07-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-08-10T14:00:00+03:00",
        "date_until": "2022-08-30T14:00:00+03:00"
      }
]

¿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. Vaya a Cuenta del editor > Store > Bundles y haga clic en Create bundle.
2. Especifique los siguientes parámetros para un paquete:
   1. Imagen
   2. Nombre
   3. Descripción
   4. Contenido
   5. Precio
   6. Mostrar en Tienda
3. Compruebe la configuración y haga clic en Save.

Configuración mediante métodos API

Agregar clave de juego al lote

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

"content": [{
     “sku”: “brilliant_game_sku_steam”,
     “quantity”: 1
  }
]

Establecer restricciones regionales

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

"regions": [{
     “id”: “123”
  }, {
     “id”: “456”
  }
]

Establecer precios regionales

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

"regional_prices": [{
     “region_id”: “123”,
     “country_iso”: “CHN”,
     “amount”: 40,
     “currency_iso”: “CNY”,
     “is_default”: true,
     “is_enabled”: true
  }
]

Obtener lotes en un catálogo