Como configurar a limitação do tempo de exibição de itens na loja

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

  • manter a relevância do catálogo em um determinado momento, por exemplo, durante as vendas de fim de ano
  • criar um item com antecedência sem exibi-lo no catálogo
  • motive os usuários a comprar itens exibindo um temporizador ao lado do item
Observação
Quando você cria uma interface de catálogo usando o Site Builder, o temporizador é exibido automaticamente. Ao criar um catálogo em sua própria interface, você precisa implementar o temporizador.
A limitação do tempo de exibição está disponível para os seguintes tipos de item:
  • itens virtuais
  • pacotes de moedas virtuais e moedas virtuais
  • conjuntos
Observação
Para itens virtuais, pacotes de moedas virtuais e conjuntos, a configuração está disponível por meio da Conta de Distribuidor e do uso de chamadas de API. Para moedas virtuais, a configuração está disponível usando apenas chamadas de API.
Para definir um limite de tempo de exibição de moedas virtuais, pacotes de moedas virtuais e conjuntos na loja pela Conta de Distribuidor, selecione Time period e especifique o fuso horário, o período inicial e o período final. Para não indicar o fim do período de exibição do item, marque a caixa No end date.
Observação
Depois de criar um item virtual, moeda virtual ou pacote de moedas virtuais, você pode definir os status do item para determinar se ele está disponível, indisponível ou parcialmente disponível.
Para definir um limite de tempo para exibir itens na loja via API, use: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, 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:

Copy
Full screen
Small screen
    "periods": [
          {
            "date_from": "2022-06-10T14:00:00+03:00",
            "date_until": "2022-06-30T14:00:00+03:00"
          },
           {
            "date_from": "2022-07-10T14:00:00+03:00",
            "date_until": "2022-07-30T14:00:00+03:00"
          },
           {
            "date_from": "2022-08-10T14:00:00+03:00",
            "date_until": "2022-08-30T14:00:00+03:00"
          }
    ]
    

    Os métodos de obtenção de catálogo retornam os itens que estão disponíveis na loja no momento da solicitação. Para obter informações sobre itens cujo período de exibição ainda não começaram ou já expiraram, passe o parâmetro show_inactive_time_limited_items com um valor 1 ao solicitar o catálogo.

    Observação

    Os limites de tempo de exibição de item não são contabilizados dentro de um conjunto.

    EXEMPLO

    1. Você cria um item virtual Booster e define seu período de exibição de 29 de outubro até 15 de novembro.

    2. Você pode criar um conjunto de Legendary Start Pack que inclui Booster. O conjunto não tem um tempo limite, então é sempre visível na loja.

    3. Dia 20 de outubro, um usuário abre sua loja no jogo. Você usa os seguintes métodos:

    Você não passa o parâmetro show_inactive_time_limited_items nesses métodos.

    4. Você recupera o catálogo de item:

    • O Booster não é incluído na resposta do Get virtual items list, porque seu período de exibição é 29 de outubro até 15 de novembro. Se você passar o parâmetro show_inactive_time_limited_items:1 no Get virtual items list, no Booster é incluído na resposta, e as matrizes de períodos indica o período em que ele estará disponível para compra.
    • O Booster é incluído na resposta do Get list of bundles como parte do conjunto Legendary Start Pack, e o usuário pode obtê-lo independentemente do parâmetro show_inactive_time_limited_items.

    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.
    Última atualização: 3 de Outubro 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!