Promoções de bônus
Como funciona
As promoções de bônus são uma ferramenta de marketing para incentivar os compradores de itens virtuais, concedendo-lhes itens bônus.
Principais características:
- Fornecimento de um ou vários itens bônus ao comprar um item promocional.
- Especificação da quantidade de vezes que uma promoção pode ser utilizada pelo usuário.
- Configuração de promoções de bônus personalizadas.
Exemplos de uso:
- Bônus na forma de moedas virtuais que podem ser gastas em itens virtuais.
- Promoções de bônus em datas significativas para o seu projeto, como o aniversário do projeto, para recompensar os usuários por sua fidelidade.
- Itens bônus, além de compras de itens para usuários que atingiram um determinado nível em um jogo, como recompensa por sua fidelidade.
Itens bônus para os usuários por um tempo limitado para motivá-los a comprarem itens virtuais.
Ao criar um catálogo de itens usando métodos de API, você pode recuperar informações sobre promoções. Na resposta, além de informações sobre o item virtual, você receberá as seguintes informações sobre uma promoção do tipo Bonus:
- nome
- data de início e término
- item(ns) bônus
- quantidade total de promoções disponíveis ao usuário
- quantidade restante de promoções disponíveis ao usuário
Se a quantidade restante de promoções disponíveis ao usuário for zero, as informações da promoção não serão exibidas no catálogo.
- json
{
"item_id": 400962,
"sku": "test_item",
"type": "virtual_good",
"name": "name_test_limit",
"description": "description_test_limit",
"price": {
"amount": "1.00",
"amount_without_discount": "1.00",
"currency": "USD"
},
"virtual_prices": [
{
"description": null,
"item_id": 322172,
"sku": "1234500",
"name": "virt currency only",
"type": "virtual_currency",
"amount": 1,
"amount_without_discount": 1,
"calculated_price": {
"amount": "1.00",
"amount_without_discount": "1.00"
},
"is_default": true
}
],
"can_be_bought": true,
"promotions": [
{
"name": "New Year Bonus",
"date_start": "2022-12-30T22:00:00+03:00",
"date_end": "2023-01-02T21:59:59+03:00",
"discount": null,
"bonus": [
{
"quantity": 3,
"name": "mybonusitem",
"sku": "444777",
"type": "virtual_good"
}
],
"limits": {
"per_user": {
"available": 7,
"total": 7
}
}
}
],
"limits": null,
"attributes": [],
"is_free": false,
"groups": [
{
"external_id": "01022023",
"name": "Group1"
}
],
"virtual_item_type": "consumable",
"inventory_options": {
"consumable": {
"usages_count": 1
},
"expiration_period": null
}
}
Se houver um limite definido para a compra de um item bônus e o usuário tiver recebido todos os itens disponíveis dentro desse limite, o item promocional não estará disponível para compra.
Se uma promoção bônus tiver um limite de uso e o número restante de promoções disponíveis para o usuário for zero, o item promocional será exibido no catálogo sem o item bônus.
Exemplos
Dependendo das restrições definidas, há diferentes cenários de usuário para comprar itens promocionais com bônus.
Exemplo de limites na compra de itens de bônus:
Na Conta de Distribuidor, o item Booster tem uma restrição de compra — ele pode ser comprado por um usuário no máximo 2 vezes.
Booster é um item bônus ao comprar Empire Lootbox.
Usuário comprou Booster 1 vez e também comprou Empire Lootbox 1 vez, recebendo Booster como bônus.
Ao tentar comprar Empire Lootbox novamente, a resposta ao método de criação de pedidos indicará que o usuário excedeu o limite de compra para o item Booster.
Exemplo de limites no uso de promoções bônus:
Na Conta de Distribuidor, a promoção bônus tem um limite de uso — não mais do que 1 vez por usuário.
Booster é um item bônus ao comprar Empire Lootbox.
O usuário comprou Empire Lootbox 1 vez e recebeu Booster como bônus.
Ao tentar comprar Empire Lootbox novamente, o item bônus Booster não será exibido e entregue ao usuário.
Exemplo de limites na compra de itens bônus e no uso de promoções de bônus:
Na Conta de Distribuidor, o item Booster tem uma restrição de compra — ele pode ser comprado por um usuário no máximo 1 vez.
Booster é um item bônus ao comprar o Empire Lootbox.
A promoção bônus tem um limite de uso — não mais do que 2 vezes por usuário.
O usuário comprou Empire Lootbox 1 vez e recebeu Booster como bônus.
Ao tentar comprar Empire Lootbox novamente, a resposta ao método de criação de pedidos indicará que o usuário excedeu o limite de compra para o item Booster.
Como obtê-lo
Configuração de uma promoção de bónus
Você pode configurar promoções de bônus das seguintes maneiras:- via a Conta de Distribuidor
- via métodos de API
Configuração através da Conta de Distribuidor
Se você configurar promoções de bónus através da Conta de Distribuidor, você poderá:- configurar o período de validade da promoção
- limitar o número de vezes que a promoção pode ser usada pelo usuário
- definir as condições para que a promoção seja ativada
configurar promoções que se aplicam a qualquer tipo de itens:
- pacotes de moedas virtuais
- itens virtuais (incluindo itens de tempo limitado)
- chaves de jogo
- pacotes
A edição de promoções de bônus com um status Active não está disponível na Conta de Distribuidor no momento.
Você pode usar métodos de API para melhorar suas opções de configuração de promoções de bônus.
Para configurar uma promoção através da Conta de Distribuidor:
- Vá para Store > Promotions and rewards na Conta de Distribuidor.
- Clique em Create promotion.
- Especifique os seguintes parâmetros:
- Insira o título da promoção.
- Escolha Bonus como o Promotion type.
- Especifique os itens promocionais.
- Especifique o item que é concedido ao usuário ao comprar o item promocional.
Para selecionar vários tipos de itens promocionais para uma promoção, primeiro escolha um tipo de item e verifique se ele está exibido no campo List of promotional items e, em seguida, volte para o campo Promotional items e selecione outro tipo.
Para selecionar vários tipos diferentes de itens bônus para uma promoção, primeiro selecione um tipo de item e verifique se eles estão exibidos no campo List of bonus items e, em seguida, volte para o campo Bonus items e selecione outro tipo.
- Clique em Next.
- Você pode definir a quantidade de usos para a promoção, se necessário. Para fazer isso, na página Conditions and limits, defina Limit number of times one user can use promotion como On e especifique a quantidade.
- Para configurar promoções personalizadas, defina Trigger promotion only for specific users como On e especifique a(s) condição(ões). Para configurar uma personalização, siga estas instruções.
- Clique em Next.
- Especifique o período da promoção.
- Clique em Next.
- Verifique as configurações e clique em Save and exit.
- Para ativar uma promoção:
- Encontre a promoção em seu catálogo de promoções.
- Clique no ícone ••• e, na lista suspensa, selecione Edit promotion ou vá para a edição clicando na ação no catálogo de ações.
- No canto superior direito, abra o menu suspenso e escolha Activate promotion.
Configuração por meio de métodos de API
Para trabalhar com promoções de bônus, você pode usar os métodos da subseção Common e Bonuses do grupo de métodos Promotions.
Para criar uma promoção de bônus, use o método Create bonus promotion e especifique os parâmetros necessários.
Para ativar uma promoção de bônus, use o método Update bonus promotion com o parâmetro “is_enabled”:true
ou o método Activate promotion.
Para desativar uma promoção, use o método Deactivate promotion.
Para editar uma promoção por meio de métodos de API, chame o método Update bonus promotion com os novos parâmetros da promoção. A edição da promoção também está disponível para promoções com o status Active.
Ao criar ou editar uma promoção de bônus por meio de métodos de API, você também pode:
- Para definir a ação da promoção para todos os itens do projeto, passe o parâmetro
“condition”:null
para o método Create bonus promotion ou Update bonus promotion.
- json
“condition”: null
- Para configurar uma promoção indefinida, passe o parâmetro
“date_end”:null
para o método Create bonus promotion ou Update bonus promotion.
- json
“date_end”: null
Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.