Itens gratuitos

Itens grátis são um tipo de item que os usuários podem obter sem gastar moedas virtuais ou reais. Estes incluem:

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

Os itens grátis estão disponíveis apenas para usuários autorizados.
Usuários não autorizados só podem visualizar o catálogo de itens grátis.

Exemplos de uso:

• Você pode dar itens grátis em datas importantes para o seu projeto (por exemplo, no dia em que o projeto foi fundado) para recompensar os usuários por sua lealdade.
• Você pode presentear pacotes de iniciante grátis do jogo na loja para atrair novos usuários ao jogo.

Quem pode usar

• Para parceiros que já têm a Web Shop e desejam configurar um novo tipo de itens — itens gratuitos.
• Para parceiros que desejam aumentar a fidelidade dos usuários atuais ou atrair novos jogadores.

Fluxo de integração

Crie itens gratuitos das seguintes maneiras:

• via Conta de Distribuidor
• via chamadas de API

Criar via Conta de Distribuidor

Para criar um item gratuito (com base no exemplo de itens virtuais):

1. Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > Virtual items.
2. Selecione o ícone + e escolha Create group na lista suspensa.
3. Especifique:
   • ID Externo;
   • Nome do grupo.
4. Selecione Create group e vá para o grupo.
5. Selecione Create item.
6. Especifique:
7. Imagem
8. SKU
   • Um ou vários grupos aos quais o item deve pertencer
   • Nome
   • Descrição
   • Propriedade do item: consumível, não consumível ou item de tempo limitado

7. No bloco Price settings, escolha Free item.
8. Se quiser limitar a disponibilidade de itens a usuários específicos, troque a opção Limit number of times one user can buy this item para On e especifique o número.
9. Se você quiser mostrar um item na loja, defina a opção Show item in store como On.
10. Clique em Create item.

Criar via chamadas de API

1. Para criar itens gratuitos, use chamadas de API da subseção Admin:
   • Para itens virtuais — Criar item virtual
   • Paca pacotes de moedas — Criar pacote de moedas virtuais
   • Para conjuntos — Criar conjunto
   Ao criar ou editar um item, passe is_free = true no corpo da solicitação.
2. Obtenha o status do pedido de um usuário.
3. Se você quiser limitar a disponibilidade de itens para usuários específicos, chame qualquer método de API para criar ou editar um item e especifique o valor do parâmetro limits.per_user.

Configure na Web Shop

Para mostrar itens gratuitos na Web Shop:

1. Abra seu projeto na Conta de Distribuidor e acesse a seção Storefronts > Websites.
2. Na seção Site, escolha seu site e selecione Configure.
3. No bloco Store, vá para a seção Store.
4. No campo Selecionar tipo de compra, selecione os itens grátis que você adicionou anteriormente.