Conjuntos

Como funciona

Conjunto é um aglomerado de vários itens que são vendidos como uma única unidade.

Principais características:

• Adicionar itens de diferentes tipos a um pacote:
  • moeda virtual (incluindo a moeda dependente da plataforma)
  • pacote de moedas virtuais
  • chaves de jogo para plataformas pré-selecionadas
  • itens virtuais, incluindo itens de tempo limitado
  • conjuntos
• Configure o preço do conjunto em moedas reais e virtuais.
• Pacote grátis.
• Limitando a quantidade de conjuntos disponíveis para compra.
• Limitando o tempo de exibição de conjuntos na loja.

Um conjunto é descompactado automaticamente após a compra. Se um conjunto incluir outro conjunto, o conjunto incluído será separado automaticamente em itens independentes.

O método de entrega de itens de um conjunto descompactado depende do tipo de item:

• pacotes de moedas virtuais, itens virtuais, itens de tempo limitado e conjuntos são entregues para:
  • inventário (método padrão)
  • PlayFab, se você configurou a integração
• as chaves do jogo de são entregues para:
  • e-mail (método padrão)
  • PlayFab, se você configurou a integração

Quando o comprador devolve o pacote cancelando uma transação (por exemplo), todos os itens concedidos do conjunto são automaticamente retirados do usuário. Se eles gastaram alguns dos itens, os itens restantes ainda são retirados.

Restrições:

• Não é possível adicionar os seguintes itens ao conjunto:
• o mesmo conjunto
• bens físicos
• Não é possível criar um conjunto vazio.
• As vendas do conjunto são pausadas depois que você fica sem chaves para vender e essas chaves são incluídas no conjunto.
• O preço do conjunto deve ser um valor fixo de moeda real e/ou virtual.
• Você pode configurar restrições regionais para um conjunto somente via API.

Limitação do número de conjuntos disponíveis para compra

Você pode limitar a compra de conjuntos. Por exemplo, você pode limitar:

• o número de conjuntos por usuário
• conjuntos de boas-vindas que só estão disponíveis para compra uma vez

Se o usuário tiver atingido o limite especificado, o conjunto não será exibido no catálogo. Se o conjunto contiver um pacote de moedas virtuais ou item com um limite de compra e o usuário já tiver comprado o valor permitido, o pacote não será exibido no catálogo.

Você pode exibir o número máximo disponível de pacotes e o número restante de pacotes que está disponível para o usuário.

Para definir um limite de compra ao criar um conjunto na Conta de Distribuidor, defina a opção Limit number of times one user can buy this bundle como On e especifique o número de vezes que o conjunto pode ser comprado.

Você pode usar os métodos da subseção Catalog do grupo de métodos Bundles para obter informações sobre conjuntos.

Na resposta, você receberá as seguintes informações, além de informações sobre o conjunto:

• o número máximo de conjuntos que um usuário pode comprar
• o número restante de conjuntos disponíveis para o usuário comprar

Você pode ler mais sobre como configurar ou atualizar restrições nas instruções Limites para o usuário.

{
  "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
           },
          }
        }
      ]
    }
  ]
}

Limitando o tempo de exibição de conjuntos na loja

• manter a relevância do catálogo em um determinado momento, por exemplo, durante as vendas de fim de ano
• crie um conjunto com antecedência sem exibi-lo no catálogo
• motive os usuários a comprar conjuntos exibindo um temporizador ao lado do item

Para definir um limite de tempo de exibição de um conjunto na loja pela Conta de Distribuidor, selecione Time period e especifique o fuso horário, o período inicial e o período final. Para não indicar o fim do período de exibição do conjunto, marque a caixa No end date.

Para definir um limite de tempo para exibir um conjunto na store via API, passe os seguintes parâmetros na chamada de API Create bundle ou Update bundle:

• periods[0].date_from com a data e hora do início do período de exibição do item no formato YYYY-MM-DDThh:mm:ss±TMZ, onde TMZ é o indicador de fuso horário no formato GMT hh:mm

• periods[0].date_until com a data e hora do final do período de exibição do item no formato YYYY-MM-DDThh:mm:ss±TMZ, onde TMZ é o indicador de fuso horário no formato GMT hh:mm. Para não indicar o final do período de exibição de um item, passe null

Você pode configurar vários períodos para exibir um conjunto na loja. Para fazer isso, no método Create bundle ou Update bundle, passe uma matriz de objetos com as datas de início e término de todos os períodos.

Exemplo:

"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"
      }
]

Quem pode usar

Para parceiros que desejam vender conjuntos de itens por um preço inferior ao total inicial de todos os itens do conjunto, o que aumenta as vendas e ajuda a obter novos jogadores, e que integraram um dos seguintes produtos (ou ambos):

• In-Game Store com os módulos Virtual Items ou Virtual Currency configurados.
• Buy Button com o módulo Game Keys configurado.

Como obtê-lo

Fluxo de integração

1. Configure um conjunto.
2. Implemente a obtenção de conjuntos em um catálogo.

Configuração de conjunto

• via Conta de Distribuidor
• via métodos de API

Configuração através da Conta de Distribuidor

1. Vá para a Conta de Distribuidor > Store > Bundles e clique em Create bundle.
2. Especifique os seguintes parâmetros para um conjunto:
   1. Imagem
   2. Nome
   3. Descrição
   4. Conteúdos
   5. Preço
   6. Exibição na Store
3. Verifique as configurações e clique em Save.

Configuração por meio de métodos de API

Adicione a chave de jogo ao conjunto

Para adicionar uma chave de jogo para uma plataforma selecionada a um conjunto, passe uma matriz com SKUs das plataformas necessárias para os métodos Create bundle ou Update bundle.

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

Configuração de restrições regionais

Para configurar restrições regionais para um pacote, passe uma matriz com IDs de regiões com suporte para os métodos Create bundle ou Update bundle.

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

Configuração de preços regionais

Para configurar preços regionais para um conjunto, passe uma matriz de objetos com configurações de preço para as regiões aos métodos Create bundle ou Update bundle.

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

Obter conjuntos em um catálogo