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:
- Adicione itens grátis ao catálogo.
- Implemente a lógica de aquisição de itens grátis pelos usuários.
- 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:
- Em um clique (sem usar o carrinho de compras) — um SKU em qualquer quantidade. Por exemplo, 100 poções idênticas.
- Através do carrinho de compras — qualquer tipo de item em qualquer quantidade.
Aquisição de itens grátis com um clique
Para implementar essa opção, chame o método createOrderWithSpecifiedFreeItem
da biblioteca Store quando um usuário clicar 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 do usuário contiver itens pagos e gratuitos:
- Obtenha o token de pagamento e o ID do pedido usando o método
createOrderWithCart
da biblioteca Store. - Obtenha o URL para abrir a interface de pagamento. Para fazer isso, chame o método
createPaymentUrl
da biblioteca Store e passe o token de pagamento e o ID do pedido. - Implemente a abertura da interface de pagamento:
- Obtenha o token de pagamento e o ID do pedido usando o método
- Para abrir a interface de pagamento em um navegador externo, chame o método estático
UIApplication.shared.open
e passe para ele o URL obtida na etapa anterior. - Para abrir a interface de pagamento no navegador integrado, instancie a classe
PaystationWebView
da biblioteca Payments e chame o métodoloadPaystation
. Um exemplo de implementação é fornecido no projeto de demonstração na classePaystationVC
.
- Para abrir a interface de pagamento em um navegador externo, chame o método estático
- Se o carrinho do usuário contiver apenas itens gratuitos, chame o método
createOrderWithFreeCart
da biblioteca Pagamentos. A entrega de itens ao inventário do usuário do lado da Xsolla ocorre imediatamente após uma solicitação bem-sucedida para este método (sem a necessidade de abrir o Portal de Pagamentos).
Concessão de itens grátis aos usuários
Você pode acompanhar o status de um pedido de item grátis chamando repetidamente o método getOrder
da biblioteca Store.
Se o pedido foi bem-sucedido, use métodos SDK para exibir o inventário do usuário e atualizar os dados no lado do cliente do aplicativo.
Links úteis
Última atualização: 22 de Janeiro de 2024Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.