Como agrupar e classificar itens no catálogo

A ordem dos grupos e dos itens dentro deles afeta a aparência do catálogo na sua loja — no site ou no aplicativo. Uma ordem devidamente configurada ajuda você a trabalhar com vendas de forma mais eficaz: você pode mostrar itens populares e grupos para os usuários primeiro.

Ao solicitar a lista de grupos de itens, os grupos são retornados na ordem em que estão classificados. Da mesma forma, ao solicitar itens por grupo, os itens são retornados na ordem em que estão classificados. Itens sem um grupo especificado são automaticamente adicionados ao grupo Não Agrupados — eles não podem ser classificados e não são retornados ao solicitar itens por grupo.

Principais recursos:

• Adicionar um item a vários grupos.
• Classificar grupos.
• Classificar itens dentro de um grupo.

Organizar grupos:

1. Crie e edite grupos na Conta de Distribuidor.
2. Adicione itens e obtenha informações sobre grupos:
   • via Conta de Distribuidor
   • via chamadas de API

Configuração através da Conta de Distribuidor

Criar grupo

Para criar um grupo:

1. No seu projeto na Conta de Distribuidor, vá para a seção Items catalog > All items.
2. Clique em Edit groups and order.

3. Clique em Create group.

4. Especifique os parâmetros necessários:
   • ID Externo — um ID de grupo único.
   • Nome do Grupo.

5. Adicione itens ao grupo (opcional). Se o seu catálogo ainda não tiver itens, você pode salvar as configurações atuais e voltar a esta etapa mais tarde.
6. Selecione o status Enabled na lista suspensa para mostrar o grupo na loja.
7. Clique em Create.

Editar grupo

Para editar um grupo:

1. Em um projeto na Conta de Distribuidor, vá para a seção Items catalog > All items.
2. Clique em Edit groups and order.
3. Clique em ⋮ perto do grupo desejado e na lista suspensa, selecione Edit.

4. Faça as alterações necessárias e clique em Save.

Excluir grupo

Você pode excluir apenas grupos que não contêm itens.

Para excluir um grupo:

1. Em um projeto na Conta de Distribuidor, vá para a seção Items catalog > All items .
2. No campo Filter, selecione o grupo. Todos os itens incluídos nele são exibidos.

3. Na coluna Groups, desmarque a caixa de seleção do grupo a ser excluído para cada item.
4. Clique em Edit groups and order.
5. Clique em ⋮ perto do grupo desejado, e na lista suspensa, selecione Delete.

Adicionar item ao grupo

Para adicionar um item (usando itens virtuais como exemplo) ao grupo necessário, especifique o grupo ao criar ou editar o item virtual:

• nas configurações básicas do item virtual;

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

Classificar itens

Para classificar itens (usando itens virtuais como exemplo):

1. Em um projeto na Conta de Distribuidor, vá para a seção Items catalog > All items.
2. Clique em Edit groups and order.
3. Clique em ⋮ perto do grupo desejado, e na lista suspensa, selecione Edit.
4. Expanda o bloco de itens virtuais clicando em ⌄.
5. Passe o mouse sobre o número do item virtual. O ícone ☰ será exibido. Arraste o item virtual para a posição desejada. Você também pode mover o item diretamente para o topo ou para o final da lista. Para fazer isso, clique em ⋮ e selecione a opção correspondente.

6. Clique em Save.

Organizar grupos

Para organizar grupos:

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.