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
- itens virtuais
- pacotes de moedas virtuais e moedas virtuais
- conjuntos
- Chamadas de API Obter pedido ou Atualizar item virtual para itens virtuais
- Chamadas de API Criar moeda virtual ou Atualizar moeda virtual para itens virtuais
- Chamadas de API Criar pacote de moedas virtuais ou Atualizar pacote de moedas virtuais para pacotes de moedas virtuais
Chamadas de API Criar conjunto ou Conjunto de atualização para conjuntos
periods[0].date_from
com a data e hora do início do período de exibição do item no formatoYYYY-MM-DDThh:mm:ss±TMZ
, ondeTMZ
é o indicador de fuso horário no formato GMThh:mm
.periods[0].date_until
com a data e hora do final do período de exibição do item no formatoYYYY-MM-DDThh:mm:ss±TMZ
, ondeTMZ
é o indicador de fuso horário no formato GMThh:mm
. Para não indicar o final do período de exibição de um item, passenull
.
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:
"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.
Os limites de tempo de exibição de item não são contabilizados dentro de um conjunto.
EXEMPLO
- Você cria um item virtual
Booster e define seu período de exibição de 29 de outubro até 15 de novembro. - Você pode criar um conjunto de
Legendary Start Pack que incluiBooster . O conjunto não tem um tempo limite, então é sempre visível na loja. - Dia 20 de outubro, um usuário abre sua loja no jogo. Você usa os seguintes métodos:
- Obter item virtual para exibir o catálogo de itens virtuais.
- Obter lista de pacotes para exibir o catálogo de conjuntos.
show_inactive_time_limited_items
nesses métodos. - Você recupera o catálogo de item:
- O
Booster não é incluído na resposta do Obter lista de itens virtuais, porque seu período de exibição é 29 de outubro até 15 de novembro. Se você passar o parâmetroshow_inactive_time_limited_items:1
no Obter lista de itens virtuais, noBooster é 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 Obter lista de pacotes como parte do conjuntoLegendary Start Pack , e o usuário pode obtê-lo independentemente do parâmetroshow_inactive_time_limited_items
.
- O
Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.