Itens virtuais

Como funciona

Itens virtuais são itens de jogo que usuários podem comprar com moedas reais ou virtuais, ou receber como bônus. Esses itens não possuem forma física e são utilizados exclusivamente dentro do jogo. Exemplos de itens virtuais incluem visuais, poções, armas e outros elementos que afetam a jogabilidade ou aparência do personagem.

Principais recursos:

• Configuração de precificação flexível:
  • Definir um preço para um único item em moedas reais e/ou virtuais.
  • Criação de itens gratuitos.
• Detecção automática do país e moedas do usuário.
• Configuração de disponibilidade:
  • Restrição de venda de itens em regiões específicas.
  • Limitação da quantidade de itens disponíveis para compra.
  • Limitação do tempo de exibição de itens na loja.
  • Configuração de itens que não estão disponíveis para compra. Um item pode ser ocultado do catálogo, mas ainda permanecer disponível como parte de um conjunto ou como um bônus para outro item.

Como configurar

Configuração através da Conta de Distribuidor

1. Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > All items.
2. Selecione Add e então Virtual item na lista suspensa.

3. Especifique os seguintes parâmetros:
   • Imagem (opcional).
   • SKU.
   • Um ou diversos grupos aos quais o item deve pertencer.
   • Nome.
   • Descrição (opcional).
4. Para configurar como o item virtual é exibido na loja, selecione o status apropriado.

5. Defina preços ou crie um item gratuito no campo Paid or free:

1. • Para criar um item gratuito, selecione Free item.

1. • Para definir um preço, selecione Paid item e especifique o preço em moeda real. Se necessário, configure preços regionais.

6. Para limitar a quantidade de itens disponíveis para compra, ative a opção Limit number of times one user can buy this item e insira a quantidade desejada.
7. Para configurar a frequência da redefinição do limite:

1. 1. A partir da lista suspensa, selecione um período:
      • Daily.
      • Weekly.
      • Monthly.
      • Custom interval – isso é calculado a partir da data inicial de exibição do item.
      • No regular refresh.

1. 2. Defina o cronograma de redefinição com base no período selecionado.

8. Configure um limite de tempo para exibir o item (opcional):

1. 1. No campo Show item in store, selecione Limited time.

1. 2. Especifique o fuso horário e o início e fim do período.

1. 1. Se você não quiser indicar o fim do período de exibição do item, marque a caixa No end date.

9. Configure os atributos usando um dos seguintes métodos (opcional):

1. 1. Adicione os atributos e seus valores no formato JSON.

1. 2. Crie atributos e valores manualmente e vincule-os a itens específicos.

10. Confira as configurações e clique em Create item.

Configuração via API

Para configurar itens virtuais, você pode usar as chamadas da subseção Admin no grupo Itens virtuais e moeda.

Exibição de itens virtuais na loja

A exibição de itens virtuais depende de como o catálogo é implementado — pelo construtor de sites ou via API.

Exibição via site builder

Para exibir um item virtual no seu site:

1. Crie um item virtual.

2. No seu projeto na Conta de Distribuidor, acesse a seção Storefronts > Websites.
3. No painel do site desejado, clique em Open Site Builder.

4. Na seção do bloco Store, selecione Virtual items no campo Item type e então selecione o grupo de itens que deseja vender no site no campo Item group.

5. Defina um layout para o cartão do item.
6. Depois de fazer todas as alterações necessárias e preparar seu site para o lançamento:
   1. No canto superior direito do construtor de sites, selecione Publish.
   2. Marque as caixas próximas às páginas que deseja publicar.
   3. Selecione Publish.

Depois que o site for publicado, uma seção com um grupo de itens virtuais ficará disponível. Se nenhum item for exibido, verifique se o status de Available e que nenhum limite de exibição com base no tempo está ativado.

Obtenção de informações de itens virtuais via API

Para recuperar o catálogo de itens virtuais no lado do cliente, use os métodos da subseção Catálogo do grupo de métodos Itens virtuais e moeda. A autorização não é necessária para usar esses métodos.

Conceder itens virtuais aos usuários

Dependendo do tipo de item e configurações de integração, o item virtual é concedido ao usuário em uma das seguintes maneiras:

• Se você integrou o PlayFab, moedas virtuais e itens são concedidos ao inventário PlayFab do usuário automaticamente.
• Se você usar um sistema de entrega personalizado, todos os itens virtuais e moedas são concedidos do seu lado. Recomendamos configurar um gerenciador de webhooks para receber dados de pedido no seu backend. Os dados necessários são inclusos no webhook Pagamento bem-sucedido do pedido.

Links úteis