Limites de compra do item
Como funciona
Você pode determinar um limite de compra por usuário e configurar redefinições programadas para esses limites.
A configuração de limite está disponível para os seguintes cenários:
- venda de itens no jogo — itens virtuais, pacotes de moedas virtuais e conjuntos
- venda de jogos e DLCs via chaves de jogo
Você pode ativar redefinições periódicas de limites para:
- permitir compras repetidas.
- sincronizar dados com o seu sistema quando itens são vendidos entre diversas plataformas de publicação de jogos.
- o catálogo de itens usando chamadas da subseção Catálogo do grupo Itens virtuais & Moeda.
- O catálogo de jogos usando chamadas da subseção Catálogo do grupo Game Keys.
Observação
A Xsolla aplica limites e impede que usuários comprem mais itens do que o limite definido.
- Quando a interface de pagamento é aberta e um item é comprado, todos os pedidos não pagos que contêm o item se tornam inválidos.
- Exemplo: um usuário pode abrir o formulário de pagamento por um item limitado em múltiplas abas de navegador ou navegadores diferentes antes de concluir a compra, o que cria diversos pedidos para o mesmo item. Quando a compra é concluída em uma aba, a Xsolla cancela todos os pedidos não pagos daquele item.
- Quando um pagamento é reembolsado ou um pedido é cancelado, os limites não são redefinidos. Você pode redefini-los usando as seguintes chamadas de API: Atualizar todos os limites de compra para o usuário especificado e Atualizar todos os limites de promoção para o usuário especificado.
- Exemplo: um usuário pode comprar um item que possui limites de compra, usá-lo no jogo, e então solicitar um reembolso. Se os limites fossem redefinidos automaticamente, o usuário poderia comprar o item novamente, usá-lo e repetir o ciclo, efetivamente contornando os limites planejados. Para impedir isso, os limites não são redefinidos quando um pagamento é reembolsado ou quando um pedido é cancelado.
Configuração e atualização de limites
Configuração e atualização na Conta de Distribuidor
Observação
- O processo de configuração abaixo é exibido usando itens virtuais como exemplo.
- Antes de configurar itens virtuais, é recomendado criar grupos. Grupos permitem que você construa um catálogo multinível e gerencie como os itens são exibidos na sua loja.
- Na Conta de Distribuidor, você pode atualizar limites para um item específico de todos os usuários. Há opções avançadas de configuração disponíveis via chamadas de API.
Para criar um item com uma quantidade limitada de usos:
- Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > All items > Virtual items.
- Abra o projeto na sua conta e vá para a seção Items catalog > All items > Virtual items.
- Abra o projeto na sua conta e vá para a seção Items catalog > All items > Virtual items.
- Abra o projeto na sua conta e vá para a seção Items catalog > All items > Virtual items.
- Abra seu projeto na conta de jogos móveis e acesse a seção Catalog.
- Selecione Add e então Virtual items.
- Especifique os seguintes parâmetros:
- imagem
- SKU
- um ou diversos grupos aos quais o item deve pertencer
- nome
- descrição
- preços
Observação
Não é possível criar um item sem especificar o preço na moeda real ou virtual. Não é possível criar um item com um preço de valor zero. Se necessário, configure preços regionais.
- Para limitar a quantidade de vezes que um usuário pode comprar um item, ative a opção Limitar a quantidade de vezes que um usuário pode comprar este item e especifique o limite.
- Para definir quantas vezes os limites são atualizados:
- Na lista suspensa, selecione o período:
- Diário
- Semanal
- Mensal
- Intervalo personalizado. O intervalo é calculado a partir da data inicial do período de exibição do item na loja.
- Sem atualização regular.
- Na lista suspensa, selecione o período:
Observação
Por padrão, o item é oculto do catálogo após o limite de compra ser atingido. Se a atualização automática de limite for configurada, a caixa de seleção Show item even users reach the purchase limit permite que o item permaneça visível até o próximo ciclo de atualização.
- Defina o cronograma de atualização especificando os parâmetros correspondentes ao período.
- Para definir um período de exibição do item no catálogo, selecione Limited time, especifique o fuso horário, data inicial e data final. Para tornar um item disponível indefinidamente, marque a caixa No end date.
- Se o item pago será usado em qualquer mecânica com uma recompensa aleatória (ex.: caixas de espólios ou gacha), ative a opção Mark as paid randomized reward.
Observação
Esse parâmetro pode ser necessário para jogos distribuídos em países com restrições legais em tais mecânicas.
- Selecione Create item.
Para configurar ou atualizar limites para um item existente:
- Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > All items > Virtual items.
Configuração e atualização na sua conta
Observação
- O processo de configuração abaixo é exibido usando itens virtuais como exemplo.
- Antes de configurar itens virtuais, é recomendado criar grupos. Grupos permitem que você construa um catálogo multinível e gerencie como os itens são exibidos na sua loja.
- Na sua conta, você pode atualizar limites para um item específico para todos os usuários. Há opções avançadas de configuração disponíveis via chamadas de API.
Para criar um item com uma quantidade limitada de usos:
- Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > All items > Virtual items.
- Abra o projeto na sua conta e vá para a seção Items catalog > All items > Virtual items.
- Abra o projeto na sua conta e vá para a seção Items catalog > All items > Virtual items.
- Abra o projeto na sua conta e vá para a seção Items catalog > All items > Virtual items.
- Abra seu projeto na conta de jogos móveis e acesse a seção Catalog.
- Selecione Add e então Virtual items.
- Especifique os seguintes parâmetros:
- imagem
- SKU
- um ou diversos grupos aos quais o item deve pertencer
- nome
- descrição
- preços
Observação
Não é possível criar um item sem especificar o preço na moeda real ou virtual. Não é possível criar um item com um preço de valor zero. Se necessário, configure preços regionais.
- Para limitar a quantidade de vezes que um usuário pode comprar um item, ative a opção Limitar a quantidade de vezes que um usuário pode comprar este item e especifique o limite.
- Para definir quantas vezes os limites são atualizados:
- Na lista suspensa, selecione o período:
- Diário
- Semanal
- Mensal
- Intervalo personalizado. O intervalo é calculado a partir da data inicial do período de exibição do item na loja.
- Sem atualização regular.
- Na lista suspensa, selecione o período:
Observação
Por padrão, o item é oculto do catálogo após o limite de compra ser atingido. Se a atualização automática de limite for configurada, a caixa de seleção Show item even users reach the purchase limit permite que o item permaneça visível até o próximo ciclo de atualização.
- Defina o cronograma de atualização especificando os parâmetros correspondentes ao período.
- Para definir um período de exibição do item no catálogo, selecione Limited time, especifique o fuso horário, data inicial e data final. Para tornar um item disponível indefinidamente, marque a caixa No end date.
- Se o item pago será usado em qualquer mecânica com uma recompensa aleatória (ex.: caixas de espólios ou gacha), ative a opção Mark as paid randomized reward.
Observação
Esse parâmetro pode ser necessário para jogos distribuídos em países com restrições legais em tais mecânicas.
- Selecione Create item.
Para configurar ou atualizar limites para um item existente:
- Abra o projeto na sua conta e vá para a seção Items catalog > All items > Virtual items.
- Abra o projeto na sua conta e vá para a seção Items catalog > All items > Virtual items.
- Abra o projeto na sua conta e vá para a seção Items catalog > All items > Virtual items.
Configuração e atualização na sua conta
Observação
- O processo de configuração abaixo é exibido usando itens virtuais como exemplo.
- Antes de configurar itens virtuais, é recomendado criar grupos. Grupos permitem que você construa um catálogo multinível e gerencie como os itens são exibidos na sua loja.
- Na sua conta, você pode atualizar limites para um item específico para todos os usuários. Há opções avançadas de configuração disponíveis via chamadas de API.
Para criar um item com uma quantidade limitada de usos:
- Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > All items > Virtual items.
- Abra o projeto na sua conta e vá para a seção Items catalog > All items > Virtual items.
- Abra o projeto na sua conta e vá para a seção Items catalog > All items > Virtual items.
- Abra o projeto na sua conta e vá para a seção Items catalog > All items > Virtual items.
- Abra seu projeto na conta de jogos móveis e acesse a seção Catalog.
- Selecione Add e então Virtual items.
- Especifique os seguintes parâmetros:
- imagem
- SKU
- um ou diversos grupos aos quais o item deve pertencer
- nome
- descrição
- preços
Observação
Não é possível criar um item sem especificar o preço na moeda real ou virtual. Não é possível criar um item com um preço de valor zero. Se necessário, configure preços regionais.
- Para limitar a quantidade de vezes que um usuário pode comprar um item, ative a opção Limitar a quantidade de vezes que um usuário pode comprar este item e especifique o limite.
- Para definir quantas vezes os limites são atualizados:
- Na lista suspensa, selecione o período:
- Diário
- Semanal
- Mensal
- Intervalo personalizado. O intervalo é calculado a partir da data inicial do período de exibição do item na loja.
- Sem atualização regular.
- Na lista suspensa, selecione o período:
Observação
Por padrão, o item é oculto do catálogo após o limite de compra ser atingido. Se a atualização automática de limite for configurada, a caixa de seleção Show item even users reach the purchase limit permite que o item permaneça visível até o próximo ciclo de atualização.
- Defina o cronograma de atualização especificando os parâmetros correspondentes ao período.
- Para definir um período de exibição do item no catálogo, selecione Limited time, especifique o fuso horário, data inicial e data final. Para tornar um item disponível indefinidamente, marque a caixa No end date.
- Se o item pago será usado em qualquer mecânica com uma recompensa aleatória (ex.: caixas de espólios ou gacha), ative a opção Mark as paid randomized reward.
Observação
Esse parâmetro pode ser necessário para jogos distribuídos em países com restrições legais em tais mecânicas.
- Selecione Create item.
Para configurar ou atualizar limites para um item existente:
- Abra o projeto na sua conta para jogos de celular e vá para a seção Catalog > Virtual items.
- Abra o grupo contendo o item.
- Na fileira do item, selecione ••• e escolha Edit na lista suspensa.
- Na seção Limits for single user, defina o limite e/ou selecione a frequência de redefinição de limites, então especifique o horário e fuso.
Observação
Por padrão, o item é oculto do catálogo após o limite de compra ser atingido. Se a atualização automática de limite for configurada, a caixa de seleção Show item even users reach the purchase limit permite que o item permaneça visível até o próximo ciclo de atualização.
- Selecione Save changes.
Observação
Você pode definir limites na quantidade de chaves de jogo disponíveis por usuário na seção Items catalog > All items > Game keys.
Para configurar a frequência de redefinição de limites para chaves de jogo, use as chamadas API correspondentes.
Observação
Você pode definir limites na quantidade de chaves de jogo disponíveis por usuário na seção Items catalog > All items > Game keys.
Para configurar a frequência de redefinição de limites para chaves de jogo, use as chamadas API correspondentes.
Observação
Você pode definir limites na quantidade de chaves de jogo disponíveis por usuário na seção Items catalog > All items > Game keys.
Para configurar a frequência de redefinição de limites para chaves de jogo, use as chamadas API correspondentes.
Observação
Você pode definir limites na quantidade de chaves de jogo disponíveis por usuário na seção Items catalog > All items > Game keys.
Para configurar a frequência de redefinição de limites para chaves de jogo, use as chamadas API correspondentes.
Observação
Você pode definir limites na quantidade de chaves de jogo disponíveis por usuário na seção Catalog > Game keys.
Para configurar a frequência de redefinição de limites para chaves de jogo, use as chamadas API correspondentes.
Configure e atualize via chamadas API
Para configurar limites de compra de itens via API, use o objeto limits nos seguintes métodos:
limits.recurrent_schedule.Se você tiver um período de atualização de limite configurado, você também pode controlar se o item permanece visível no catálogo após o limite de compra ser atingido. Para fazer isso, passe o parâmetro “limits.per_user.limit_exceeded_visibility”: “show”.
Se nenhuma atualização recorrente for configurada, o item é oculto do catálogo após o limite ser atingido independentemente do valor do parâmetro.
Para atualizar e gerenciar limites via API, use os métodos na subseção Gerenciamento do grupo de métodos Limites.
| Característica | Chamada de API |
|---|---|
| Atualizar limites do item especificado para todos ou alguns dos usuários. | Atualizar limite de compra. |
| Limpa todos os limites para um usuário específico. | Atualizar todos os limites de compra para o usuário especificado. |
| Altera o limite na compra de um item especificado para um usuário especificado. | Defina o número de itens disponíveis para o usuário especificado. |
| Obtém informações sobre quais limites são configurados para um item especificado e para um usuário especificado. | Obtenha o número de itens disponíveis para o usuário especificado. |
| Aumenta o número de itens que podem ser comprados por um usuário específico. | Aumente o número de itens disponíveis para o usuário especificado. |
| Reduz o número de itens que podem ser comprados para um usuário específico. | Diminuir o número de itens disponíveis para o usuário especificado. |
Exibe os limites no catálogo de itens
Limites na venda de itens são exibidos no catálogo dependendo de como são implementados — seja pelo Site Builder ou via API.
Exibição via site builder
Se você usar o construtor de sites, os limites são exibidos automaticamente — um cartão de itens exibe um contador de itens disponíveis ao usuário.
Observação
Para atrair a atenção a itens promocionais, recomendamos usar o estilo de carta de Oferta em Destaque.
Obter informações de limites via API
Se o catálogo for implementado usando a API, a informação de limites é retornada na matriz items.limits nas seguintes chamadas API relacionadas ao catálogo:
- Obter lista de itens virtuais
- Obter lista de moedas virtuais
- Obter lista de pacotes de moedas virtuais
- Obter lista de pacotes
- Obter lista de jogos
can_be_bought = false.
Você pode atualizar esses limites como necessário.
Esses dados podem ser usados para exibir limites no catálogo — por exemplo, para exibir a quantidade máxima de itens disponíveis para compra.Este artigo foi útil?
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.
