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.

Não é possível definir restrições regionais para promoções de bônus.

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.

Copy
Full screen
Small screen

{
  "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
  }
}
Observação

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:

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.

Observação
Novas promoções ficam inativas por padrão. Para ativar sua promoção, edite-a e, no canto superior direito da lista suspensa, selecione Activate promotion.

Para configurar uma promoção através da Conta de Distribuidor:

  1. Vá para Store > Promotions and rewards na Conta de Distribuidor.
  1. Clique em Create promotion.
  1. Especifique os seguintes parâmetros:
    1. Insira o título da promoção.
    2. Escolha Bonus como o Promotion type.
    3. Especifique os itens promocionais.
    4. Especifique o item que é concedido ao usuário ao comprar o item promocional.
Observação

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.

  1. Clique em Next.
  2. 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.
  3. 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.
  4. Clique em Next.
  5. Especifique o período da promoção.
  1. Clique em Next.
  2. Verifique as configurações e clique em Save and exit.
  3. Para ativar uma promoção:
    1. Encontre a promoção em seu catálogo de promoções.
    2. 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.
    3. 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 Comum e Bônus do grupo de métodos Promoções.

Para criar uma promoção de bônus, use o método Criar promoção de bônus e especifique os parâmetros necessários.

Para ativar uma promoção de bônus, use o método Atualizar promoção bônus com o parâmetro “is_enabled”:true ou o método Activate promotion.

Para desativar uma promoção, use o método Desativar promoção.

Para editar uma promoção por meio de métodos de API, chame o método Atualizar promoção bônus 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:

Copy
Full screen
Small screen

“condition”: null
Copy
Full screen
Small screen

“date_end”: null
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!