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 a qualquer momento, por exemplo, durante as vendas festivas.
• Criar um item antecipadamente sem exibi-lo no catálogo.
• Motivar os usuários a comprar itens exibindo um timer próximo ao item. Ao criar uma interface de catálogo usando o construtor de sites, o timer é exibido automaticamente. Ao construir o catálogo usando uma interface personalizada, o timer deve ser implementado do seu lado.

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

Configuração e atualização de limites

Configuração e atualização na Conta de Distribuidor

1. Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > All items > Virtual items.
2. Selecione Add e então Virtual items.

3. Especifique os seguintes parâmetros:
   • imagem
   • SKU
   • um ou diversos grupos aos quais o item deve pertencer
   • nome
   • descrição
   • preços

4. Para limitar a quantidade de vezes que um usuário pode comprar um item, defina a opção Limit the number of times one user can buy this item como On e especifique o limite.
5. Para definir quantas vezes os limites são atualizados:
   1. 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.

1. 2. Defina o cronograma de atualização especificando os parâmetros correspondentes ao período.

6. 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, selecione No end date.
7. Selecione Create item.

Configure e atualize via chamadas 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
• Atualizar moeda virtual ou Atualizar moeda virtual
• Criar pacote de moedas virtuais ou Atualizar pacote de moedas virtuais
• Criar conjunto ou Conjunto de atualização
• Criar jogo, Atualizar jogo por SKU ou Atualizar jogo por ID

• 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, onde TMZ é o indicador de fuso horário no formato GMT hh:mm.

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

Você pode configurar vários períodos para exibir um item na loja. Para fazer 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 API de recuperação de catálogo retornam os itens que são exibidos na loja no momento da solicitação. Para obter informações sobre os itens cujo período de exibição ainda não começou ou que já expirou, passe o parâmetro show_inactive_time_limited_items com um valor de 1 ao solicitar o catálogo.

Exibe os limites no catálogo de itens

A exibição de itens de tempo limitado no catálogo depende da implementação — pelo construtor de sites ou via API.

Exibição 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 timer surge automaticamente no cartão do item e exibe o tempo restante:

• Se houver mais de uma semana restante até o fim da venda, o timer exibe os dias e as horas.
• Se houver mais de um dia restante até o fim da venda, o timer exibe horas e minutos.
• Se houver menos de um dia restante até o fim da venda, o timer exibe minutos e segundos.

Obter informações de limites 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 pacotes
• Obter lista de jogos