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.

{
  "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
  }
}

Como obtê-lo

Configuração de uma promoção de bónus

• via a Conta de Distribuidor
• via métodos de API

Configuração através da Conta de Distribuidor

• 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:

1. Vá para Store > Promotions and rewards na Conta de Distribuidor.

2. Clique em Create promotion.

3. 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.

4. Clique em Next.
5. 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.
6. 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.
7. Clique em Next.
8. Especifique o período da promoção.

9. Clique em Next.
10. Verifique as configurações e clique em Save and exit.
11. 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 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.

“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.

“date_end”: null