Moedas virtuais

Como funciona

Moedas virtuais são tipos de dinheiro virtual usados para comprar e vender bens virtuais. Dependendo de como é usada, a moeda virtual afeta o saldo da economia do jogo ou está relacionada à monetização do aplicativo.

Principais características:

• Venda de qualquer quantia de moedas virtuais ou pacotes de moedas virtuais com uma quantia fixa.
• Venda de moedas virtuais e pacotes de moedas virtuais por moedas reais ou virtuais.
• Limitação da quantidade de pacotes de moedas virtuais disponíveis para compra.
• Limitação do tempo de exibição das moedas virtuais e pacotes de moedas virtuais na loja.
• Pacotes de moedas virtuais gratuitas.

As seguintes opções só estão disponíveis para a venda de moedas virtuais:

• Qualquer quantia — permite que você venda moedas virtuais na quantia especificada pelo usuário. Para usar essa opção, implemente um campo de entrada no lado do cliente que permita que o usuário insira a quantia desejada da moeda ao fazer uma compra.
• Pacotes — permite que você venda moedas virtuais em quantias predefinidas. O preço de um pacote de moeda é definido separadamente e pode diferir do preço padrão da quantia equivalente da moeda.

1. Exemplo: Um pacote contém 100 moedas de ouro e custa $90, enquanto que o preço de uma moeda de ouro é $1.

Restrições:

• Você só pode adicionar um tipo de moeda virtual a um pacote.
• Um preço em outra moeda virtual só pode ser configurado via chamadas de API.
• Um pacote de moedas virtuais pode ser tornado gratuito — sem especificar um preço em moedas reais ou virtuais. Isso pode ser configurado via Conta de Distribuidor ou via chamadas de API. Moedas virtuais gratuitas que não façam parte de um pacote só podem ser criadas via chamadas de API.
• A quantidade de moeda virtual em um pacote pode ser especificada somente com números inteiros.

Como configurar

Configuração através da Conta de Distribuidor

• Moedas virtuais
• Pacotes de moedas virtuais

Para configurar moedas virtuais pela 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 currency na lista suspensa.

3. Especifique os seguintes parâmetros:
   1. Imagem (optional).
   2. SKU.
   3. Nome da moeda virtual.
4. Para configurar como a moeda virtual é exibida na loja, selecione o status apropriado.

5. Para definir um preço, selecione Set up prices e especifique o preço em moeda real. Se necessário, configure preços regionais.
6. 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.

7. Confira as configurações e selecione Create currency.

Observação

Antes de definir um pacote de moedas virtuais, você deve criar uma moeda virtual.

Para definir um pacote de moedas virtuais pela 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 currency package na lista suspensa.

3. Especifique os seguintes parâmetros:
   1. Imagem (opcional).
   2. SKU.
   3. Um ou diversos grupos aos quais o pacote deve pertencer.
   4. Nome.
   5. Descrição (opcional).
4. Para configurar como a moeda virtual é exibida na loja, selecione o status apropriado.

5. Especifique a moeda virtual inclusa no pacote e sua quantia.
6. Defina preços ou crie um item gratuito no campo Paid or free:

1. • Para criar um pacote gratuito, selecione Free package.

1. • Para definir um preço, selecione Paid package e especifique o preço em moedas reais. Se necessário, configure preços regionais.

7. Para limitar a quantidade de pacotes disponíveis para compra, ative a opção Limit number of times one user can buy package e insira a quantidade desejada.
8. 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 pacote.
      • No regular refresh.

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

9. Configure um limite de tempo para exibir um pacote (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.

10. 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.

11. Confira as configurações e selecione Create package.

Configuração via API

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

Exibição de moedas virtuais na loja

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

Exibição via site builder

1. Crie um pacote de moedas virtuais.
2. No seu projeto na Conta de Distribuidor, acesse a seção Storefronts > Websites.
3. No painel do site desejado, selecione Open Site Builder.

4. Na seção do bloco Store, selecione o pacote de moedas virtuais que deseja vender no site no campo Item type.

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 pacotes de moedas virtuais ficará disponível. Se nenhum pacote 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 moedas virtuais via API

Para recuperar o catálogo de moedas virtuais e pacotes de moedas virtuais no lado do cliente, use as chamadas da subseção Catálogo do grupo Itens virtuais e moeda.

Conceder moedas virtuais aos usuários

Dependendo do tipo de item e configurações de integração, a moeda virtual é concedida ao usuário de 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.