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 flexível de preços:
  • Definir o preço de um item individual em moeda real e/ou moedas virtuais.
  • Criar itens gratuitos.
• Detecção automática do país e da moeda do usuário.
• Configuração de disponibilidade:
  • Restringir a venda de itens em regiões específicas.
  • Limitar a quantidade de itens disponíveis para compra.
  • Limitar o tempo de exibição dos itens na loja.
  • Configurar itens que não estão disponíveis para compra. Um item pode ficar oculto do catálogo, mas ainda estar disponível como parte de um conjunto ou como bônus de outro item.

Como configurar

2. Selecione Create manually e então Virtual item na lista suspensa.

3. Na seção Configurações gerais, informe:
   • SKU
   • Um ou mais grupos aos quais o item deve pertencer (opcional)
   • Nome
   • Descrição breve
   • Descrição estendida — para adicioná-la, ative a Opção correspondente (opcional)

4. Na seção Media, envie uma ou mais imagens ou vídeos (opcional) — do seu dispositivo ou através de um link. Na loja criada com o editor de sites da Xsolla, todos os cartões de item exibem o arquivo marcado como Main, enquanto os demais arquivos ficam disponíveis apenas em cartões de item com galeria de mídia. O arquivo marcado como Main também é retornado nas respostas das Chamadas de API de obtenção do catálogo.

5. Na seção Price settings, defina os preços ou crie um item grátis:
   • Para definir um preço, selecione Paid item, ative a opção Pricing in real currency e/ou Pricing in virtual currency e informe o preço. Se necessário, configure os preços regionais.
   • Para criar um item grátis, selecione Free item.

6. Para limitar a quantidade de itens disponíveis para compra:
   1. Ative a opção na seção Limits e especifique a quantidade.
   2. Configure a frequência de redefinição do limite. Para isso, selecione um período na lista suspensa:
      1. Daily.
      2. Weekly.
      3. Monthly.
      4. Custom interval. O intervalo é calculado a partir da data de início de exibição do item na loja.
      5. No regular refresh.
   3. Defina a programação de redefinição especificando os parâmetros correspondentes ao período selecionado.

7. Para configurar um limite de tempo de exibição para o item (opcional):

   1. Ative a opção na seção Add specific display period.
   2. Especifique o fuso horário e o início e o fim do período.

   Para deixar o fim do período de exibição do item sem especificação, ative a opção No end date.

8. Configure os atributos usando uma das opções a seguir (opcional):
   1. Adicione atributos e seus valores no formato JSON.
   2. Crie manualmente atributos e seus valores e vincule-os aos itens.

9. Se o item pago for usado em alguma mecânica com recompensa aleatória (por exemplo, lootboxes ou gacha), ative a opção Mark as paid randomized reward.

10. Selecione Create.

11. Na janela que surgir, selecione o status do item e então Continue.

O item criado aparecerá na seção All items.

Configurar via API

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

Exibir itens virtuais na loja

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

Exibir via editor de sites

Para exibir um item virtual no seu site:

1. Criar um item virtual.

2. No seu projeto na Conta de Distribuidor, vá para a seção Storefronts > Websites.

3. No painel do site desejado, clique em Open Site Builder.

2. No seu projeto na conta para jogos móveis, vá para a seção Web Shop.

3. Clique no painel do site desejado.

4. Se o seu site tiver várias páginas, selecione a que você precisa:

   1. Selecione o título da página atual na parte superior do editor.
   2. Selecione a página necessária na lista suspensa.

5. Na seção do bloco Store, selecione Virtual items no campo Item type e selecione, no campo Item group, o grupo de itens que você quer vender no site.

6. Defina um layout do cartão do item.

7. Depois de fazer todas as alterações necessárias e preparar seu site para o lançamento:

   1. No canto superior direito do editor do site, clique em Publish.
   2. Marque as caixas ao lado das páginas que você quer publicar.
   3. Clique em 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 está definido como Available e se não há limite de exibição por tempo ativo.

Obter informações de item virtual via API

Para recuperar o catálogo de itens virtuais no lado do cliente, use os métodos da subseção Catalog do grupo Itens virtuais e moedas. Não é necessária autorização 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, a moeda virtual e os itens são concedidos automaticamente ao inventário do usuário no PlayFab.
• Se você usa um sistema de entrega personalizado, todos os itens virtuais e a moeda são concedidos do seu lado. Recomendamos configurar um manipulador de Webhook para receber os dados do pedido no seu backend. Os dados necessários estão incluídos no Webhook Pagamento bem-sucedido do pedido.

Consulte a seção Configurar o rastreamento do Status do Pedido para obter mais detalhes sobre este e outros métodos de recuperação de dados de compra.

Links úteis