Limite de tempo para exibir itens na loja

Como funciona

Você pode definir o período de exibição de um item na loja para:

• Manter a relevância do catálogo em um determinado momento, por exemplo, durante promoções sazonais.
• Criar um item com antecedência sem exibi-lo no catálogo.
• Motivar os usuários a comprar itens ao exibir um cronômetro ao lado do item. Ao criar uma interface de catálogo usando o construtor de sites, o cronômetro é exibido automaticamente. Ao construir o catálogo usando uma interface personalizada, o cronômetro deve ser implementado do seu lado.

A configuração do limite de tempo está disponível nos seguintes cenários:

• venda de itens no jogo — itens virtuais, pacotes de moedas virtuais e conjuntos
• venda de jogos e DLC via chaves de jogo

Configurar e atualizar limites

Para criar um item com uma quantidade limitada de usos:

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.

Configuração e atualização via chamadas de API

Para definir um limite de tempo para exibir itens na loja, use as seguintes chamadas de API:

• Criar item virtual ou Atualizar item virtual
• Criar moeda virtual ou Atualizar moeda virtual
• Criar pacote de moedas virtuais ou Atualizar pacote de moedas virtuais
• Criar conjunto ou Atualizar conjunto
• Criar jogo, Atualizar jogo por SKU ou Atualizar jogo por ID

Passe os seguintes parâmetros para a criação de item ou chamada de API de atualização de item:

• periods[0].date_from com a data e hora do início do período de exibição do item no formato YYYY-MM-DDThh:mm:ss±TMZ, em que TMZ é o indicador de fuso horário no formato GMT hh:mm.

• periods[0].date_until com a data e hora do fim do período de exibição do item no formato YYYY-MM-DDThh:mm:ss±TMZ, em que TMZ é o indicador de fuso horário no formato GMT hh:mm. Para não indicar o fim do período de exibição de um item, especifique apenas um período e passe “periods[0].date_until”: null.

Você pode configurar vários períodos para exibir um item na loja. Para isso, passe uma matriz de objetos com as datas de início e término de todos os períodos nas chamadas de API.

Exemplo:

 1"periods": [
 2      {
 3        "date_from": "2022-06-10T14:00:00+03:00",
 4        "date_until": "2022-06-30T14:00:00+03:00"
 5      },
 6       {
 7        "date_from": "2022-07-10T14:00:00+03:00",
 8        "date_until": "2022-07-30T14:00:00+03:00"
 9      },
10       {
11        "date_from": "2022-08-10T14:00:00+03:00",
12        "date_until": "2022-08-30T14:00:00+03:00"
13      }
14]

As chamadas de API de recuperação do catálogo retornam os itens exibidos na loja no momento da solicitação. Para obter informações sobre itens cujo período de exibição ainda não começou ou já expirou, passe o parâmetro show_inactive_time_limited_items com o valor 1 ao solicitar o catálogo.

Exibir limites no catálogo de itens

A exibição de itens de tempo limitado no catálogo depende de como ela é implementada — pelo Site Builder ou via API.

Exibir via Site Builder

Se você usar um construtor de sites, os limites de tempo são exibidos automaticamente. 30 dias antes do fim do período de venda de um item, um cronômetro surge automaticamente no cartão do item e exibe o tempo restante:

• Se faltar mais de uma semana para o fim da promoção, o cronômetro mostra dias e horas.
• Se faltar mais de um dia para o fim da promoção, o cronômetro mostra horas e minutos.
• Se faltar menos de um dia para o fim da promoção, o cronômetro mostra minutos e segundos.

Obter informações de limite via API

Se o catálogo for implementado usando a API, a informação do período de venda do item é retornada na matriz items.periods 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 conjuntos
• Obter lista de jogos

Os dados sobre as datas de quando um item está disponível para venda pode ser usada para exibir os limites no catálogo — por exemplo, para exibir o período durante o qual um usuário pode comprar o item.