SDKs para Unity / Itens gratuitos
  Voltar aos Documentos

SDKs para Unity

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

Você pode limitar a quantidade grátis de itens exclusivos caso o usuário já os possuam.

Para configurar itens grátis:

  1. Adicione itens grátis ao catálogo.
  2. Implemente a lógica de aquisição de itens grátis pelos usuários.
  3. Implemente a lógica de concessão de itens grátis aos usuários.

Adição de itens gratuitos ao catálogo

Você pode encontrar instruções detalhadas sobre como criar itens nas seguintes seções de documentação:

Ao criar ou editar um item grátis, você precisa selecionar um Free item, Free package ou Free bundle na seção Paid or Free.

Aquisição de itens grátis pelo usuário

Um usuário pode adquirir um item grátis de duas maneiras:

Aquisição de itens grátis com um clique

Para implementar essa opção, chame o método SDK PurchaseFreeItem quando um usuário clica no botão no catálogo para solicitar o item gratuito.

A entrega de itens para o inventário do usuário do lado da Xsolla ocorre imediatamente após uma solicitação bem-sucedida a este método (sem a necessidade de abrir o Pay Station).

Aquisição de itens grátis através do carrinho de compras

Caso o usuário compre através do carrinho de compras:

  • Se o carrinho contém itens ambos pagos e grátis, chame o método SDK Purchase da classe Cart. Esse método encapsula métodos para criar um pedido, abrir uma interface de pagamento e rastrear o status do pedido.

  • Se o carrinho contém apenas itens grátis, chame o método SDK PurchaseFreeCart da classe Cart. A entrega de itens para o inventário do usuário no lado da Xsolla ocorre imediatamente após uma solicitação bem-sucedida deste método (sem a necessidade de abrir o Pay Station).

Concessão de itens grátis aos usuários

Os métodos Purchase, PurchaseFreeItem e PurchaseFreeCart contêm a lógica para rastrear o status do pedido. Ao chamar esses métodos, passe uma função que é chamada quando o pedido transita para o status done no parâmetro onSuccess. Atualize o inventário no lado do cliente do aplicativo usando uma das seguintes opções:

Observação
Se você configurou o servidor do aplicativo para lidar com webhooks da Xsolla, você poderá atualizar os dados no lado do cliente do aplicativo quando o webhook order_paid for recebido.
Este artigo foi útil?
Obrigado!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
Avalie esta página
Avalie esta página
Podemos melhorar alguma coisa?

Não quero responder

Obrigado pelo seu feedback!

Links úteis

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

Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.

Relatar um problema
Nós sempre avaliamos nossos conteúdos. Seu feedback nos ajuda a melhorá-los.
Forneça um e-mail para que possamos responder
Obrigado pelo seu feedback!