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 de itens virtuais:

1. Abra seu projeto na sua Conta de Distribuidor e acesse a seção Items catalog > Virtual items.
2. Selecione + e então 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 e acesse a seção Items catalog > Virtual items, selecione ••• na lista suspensa, e então Edit group.

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

3. Clique em Save changes.

Adicionar item ao grupo

Para adicionar um item virtual a um grupo obrigatório, especifique o grupo ao criar um novo item ou editar o item existente.

Classificar itens

Para classificar itens (no exemplo de itens virtuais):

1. Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > Virtual items.
2. Acesse o grupo.
3. Focalize o cursor 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:

 1{
 2  "sku": "sword",
 3  "name": {
 4    "en": "Sword"
 5  },
 6  "is_enabled": true,
 7  "is_free": false,
 8  "order": 1,
 9  "description": {
10    "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."
11  },
12  "prices": [
13    {
14      "amount": 100,
15      "currency": "USD",
16      "is_enabled": true,
17      "is_default": true
18    }
19  ],
20  "vc_prices": [],
21  "is_show_in_store": true,
22  "groups": [
23    "chests",
24    "bonus"
25  ]
26}

Obtenção e lista de grupos

Filtrar itens

Para filtrar itens do grupo necessário:

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 Obter lista de pacotes de moedas virtuais.
   • Conjuntos — chamada de API Obter lista de conjuntos.
2. Usando os filtros, encontre os itens com o parâmetro external_id do grupo específico necessário no parâmetro groups.