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 produto — 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.
2. Clique em Store no menu lateral.
3. No painel Virtual Items, clique em Configure.
4. Clique no ícone + e escolha Create group na lista suspensa.
5. Especifique:
   • ID Externo;
   • Nome do grupo.
6. Clique em Create group e vá para o grupo.
7. Clique em Create item.
8. Especifique:
9. Imagem
10. 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

9. No bloco Price settings, escolha Free item.
10. 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.
11. Se você quiser mostrar um item na loja, defina a opção Show item in store como On.
12. 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 — Create virtual item
   • Paca pacotes de moedas — Create virtual currency package
   • Para conjuntos — Create bundle
   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 vá para o Site Builder.
2. Na seção Site, escolha seu site e clique em 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.

Última atualização: 22 de Janeiro de 2024