Como agrupar e classificar itens no catálogo

Você pode adicionar itens em grupos para criar um catálogo de vários níveis. O grupo pode incluir tipos idênticos e diferentes de itens:

• Itens virtuais
• Moedas virtuais
• Pacotes de moedas virtuais
• Conjuntos
• Chaves de jogo

Principais características:

• Adicione o mesmo item em vários grupos.
• Adicione grupos menores aos maiores para criar um catálogo de vários níveis.
• Altere a ordem dos grupos.
• Altere a ordem dos itens.

Configure grupos de uma das seguintes maneiras:

• via Conta de Distribuidor (somente para itens virtuais)
• via chamadas de API

Configuração através da Conta de Distribuidor

Criar grupo

Para criar um grupo para itens virtuais:

1. Abra seu projeto na Conta de Distribuidor.
2. Clique em Store no menu lateral.
3. No painel Virtual items, clique em:
   • Connect – se você não tiver itens virtuais.
   • Configure – se você conectou itens virtuais anteriormente.
4. Clique em + e selecione Create group na lista suspensa.

5. Especifique os seguintes parâmetros:
   • External ID — código de grupo exclusivo.
   • Group name.
6. Defina a opção Show group in Store como On.
7. Clique em Create group.

Editar grupo

Para editar um grupo:

1. Abra seu projeto na Conta de Distribuidor.
2. Clique em Store no menu lateral.
3. No painel Virtual items, clique em ••• e, na lista suspensa, selecione Edit group.

4. Faça as alterações necessárias.

5. Clique em Save changes.

Adicionar item ao grupo

Classificar itens

1. Abra seu projeto na Conta de Distribuidor.
2. Clique em Store no menu lateral.
3. No painel Virtual items, clique em:
   • Connect – se você não tiver itens virtuais.
   • Configure – se você conectou itens virtuais anteriormente.
4. Vá para o grupo.
5. Passe o mouse sobre o número do item virtual. O ícone ☰ será exibido. Arraste o item virtual para a nova posição.

Configure por meio de chamadas de API

Adicionar item ao grupo

Para adicionar um item ao grupo existente por meio de chamadas de API, passe a matriz que contém o parâmetro external_id dos grupos aos quais o item deve pertencer no campo group:

• Chaves de jogo — Use as chamadas de API Create game, Update game by SKU, e Update game by ID.
• Itens virtuais — Use as chamads de API Create virtual item e Update virtual item.
• Moedas virtuais — Use as chamadas de API Create virtual currency e Update virtual currency.
• Pacotes de moedas virtuais — Use as chamadas de API Create virtual currency package e Update virtual currency package.
• Conjuntos — Use as chamadas de API Create bundle e Update bundle.

Exemplo de solicitação:

{
   "sku": "sword",
   "name": {
      "en": "Sword",
   },
   "is_enabled": true,
   "is_free": false,
   "order": 1,
   "description": {
      "en": "A sword is a bladed melee weapon intended for cutting or thrusting that is longer than a knife or dagger, consisting of a long blade attached to a hilt.",
   },
   "prices": [
      {
         "amount": 100,
         "currency": "USD",
         "Is_enabled": true,
         "is_default": true
      }
   ],
   "vc_prices": [ ],
   "is_show_in_store": true,
   "groups": [
   "chests", "bonus"
],
}

Obtenção e lista de grupos

Filtrar itens

1. Obtenha a lista de itens por meio das seguintes chamadas de API:
   • Chaves de jogo — chamada de API Get games list.
   • Moedas virtuais — chamada de API Get virtual currency list.
   • Pacotes de moedas virtuais — chamada de API Get virtual currency package list.
   • Conjuntos — chamada de API Get list of bundles.
2. Usando os filtros, encontre os itens com o parâmetro external_id do grupo específico necessário no parâmetro groups.