Como agrupar e classificar itens no catálogo

Você pode adicionar itens em grupos. O grupo pode incluir tipos idênticos e diferentes de itens:

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

Características principais:

• Adicione o mesmo item em diversos grupos.
• Altere a ordem dos grupos.
• Altere a ordem dos itens.

Defina grupos:

1. Crie e edite grupos pela Conta de Distribuidor.
2. Adicione itens e obtenha informações sobre os grupos:
   • via Conta de Distribuidor
   • 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 > All items.
2. Selecione Add e então Group na lista suspensa.

3. Especifique os seguintes parâmetros:
   • External ID — código de grupo exclusivo.
   • Group name.
4. Defina a opção Show group in Store como On.
5. 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 > All items.
2. Selecione Show groups.
3. Selecione⋮ perto do grupo necessário e na lista suspensa, selecione Edit.

4. Faça as alterações necessárias e selecione Save changes.

Adicionar item ao grupo

Para adicionar itens virtuais a um grupo necessário, especifique o grupo:

• ao criar um item novo
• ao editar o item existente na Conta de Distribuidor:
  • nas configurações básicas do item

• • na lista suspensa de grupos na lista de itens virtuais

Classificar itens

Para classificar itens dentro de um grupo de itens:

1. Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > All items.
2. Selecione Show groups.
3. Acesse o grupo.
4. Focalize o cursor sobre o número do item virtual. O ícone ☰ será exibido. Arraste o item virtual para a nova posição.

Organizar grupos

Para organizar grupos:

1. Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > All items.
2. Selecione Show groups.
3. Focalize o cursor sobre o nome do grupo. O ícone ☰ será exibido. Arraste o item virtual para a nova posição.

Configuração via 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 chamadas 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

Para obter a lista de todos os grupos, use a chamada de API Obter lista de grupos de itens. Para obter a lista de itens do grupo especificado, passe o parâmetro external_id para a chamada de API Obter lista de itens por grupo especificado.

Filtrar itens

Para filtrar itens do grupo necessário:

1. Obtenha a lista de itens por meio das seguintes chamadas de API:
   • Obter lista de jogos
   • Get virtual currency list
   • Obter lista de moedas virtuais
   • Obter lista de conjuntos
2. Usando os filtros, encontre os itens com o parâmetro external_id do grupo exigido especificado no parâmetro groups.