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 Criar jogo, Atualizar jogo por SKU, e Atualizar jogo por ID.
• Itens virtuais — Use as chamads de API Obter pedido e Atualizar item virtual.
• Moedas virtuais — Use as chamadas de API Criar moeda virtual e Atualizar moeda virtual.
• Pacotes de moedas virtuais — Use as chamadas de API Criar pacote de moedas virtuais e Atualizar pacote de moedas virtuais.
• Conjuntos — Use as chamadas de API Criar conjunto e Conjunto de atualização.

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 Obter lista de jogos.
   • Moedas virtuais — chamada de API Obter lista de moedas virtuais.
   • 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.