Bonus promotions

How it works

Bonus promotions are a marketing tool to incentivize virtual items’ buyers by granting them bonus items.

Main features:

• Providing one or multiple bonus items when purchasing a promotional item.
• Specifying the number of times a promotion is available to a user.
• Setting up personalized bonus promotions.

Examples of use:

• Bonuses in the form of virtual currency that can be spent on virtual items.
• Bonus promotions on significant dates for your project, such as the anniversary of the project, to reward users for their loyalty.
• Bonus items in addition to item purchases to users who have reached a certain level in a game, as a reward for their loyalty.

• Bonus items to users for a limited time to motivate them to purchase virtual items.

When building a catalog of items using API methods, you can retrieve information about promotions. In the response, in addition to information about the virtual item, you will receive the following information about a Bonus type promotion:

• name
• start and end date
• bonus item(s)
• total number of promotions available to the user
• remaining number of promotions available to the user

If the remaining number of promotions available to the user is zero, the promotion information will not be displayed in the catalog.

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

How to get it

Setting up bonus promotion

• via Publisher Account
• via API methods

Set up via Publisher Account

• set up the promotion’s validity period
• limit the number of times the promotion can be used by the user
• set the conditions for the promotion to trigger

• set up promotions that apply to any types of items:

  • virtual currency packages
  • virtual items (including time-limited items)
  • game keys
  • bundles

Editing bonus promotions with an Active status isn’t currently available in Publisher Account.

You can use API methods to enhance your bonus promotions configuration options.

To set up a promotion via Publisher Account:

1. Go to Store > Promotions and rewards in Publisher Account.

2. Click Create promotion.

3. Specify the following parameters:
   1. Enter the promotion title.
   2. Choose Bonus as a Promotion type.
   3. Specify promotional items.
   4. Specify the item that is granted to the user when purchasing the promotional item.

4. Click Next.
5. You can set the number of uses for the promotion if necessary. To do this, on the Conditions and limits page, switch the Limit number of times one user can use promotion toggle to On and specify the number.
6. To set up personalized promotions, set Trigger promotion only for specific users to On and specify the condition(s). To set up a personalization, follow these instructions.
7. Click Next.
8. Specify the promotion period.

9. Click Next.
10. Check the settings and click Save and exit.
11. To activate a promotion:
    1. Find the promotion in your promotions catalog.
    2. Click the ••• icon, and in the drop-down list, select Edit promotion or go to editing by clicking on the promotion in the promotion catalog.
    3. In the upper right corner, open the drop-down menu and choose Activate promotion.

Set up via API methods

To work with bonus promotions, you can use the methods from the Common and Bonuses subsection of the Promotions method group.

To create a bonus promotion, use the Create bonus promotion method and specify the necessary parameters.

To activate a bonus promotion, use the Update bonus promotion method with the “is_enabled”:true parameter or the Activate promotion method.

To deactivate a promotion, use the Deactivate promotion method.

To edit a promotion via API methods, call the Update bonus promotion method with the new promotion parameters. Editing the promotion is also available for promotions with an Active status.

When creating or editing a bonus promotion via API methods, you can also:

• To set the action of the promotion for all items in the project, pass the “condition”:null parameter to the Create bonus promotion or Update bonus promotion method.

“condition”: null

• To set up an indefinite promotion, pass the “date_end”:null parameter to the Create bonus promotion or Update bonus promotion method.

“date_end”: null