Promo codes and coupons

Promo codes and coupon promotions are a marketing tool used to provide users with codes for obtaining bonus items. Users can enter the promo code into a special field in the catalog to redeem it.

Promo codes redeemable at the time of purchase, and coupons — after the user enters a code.

Setting up a personalization is available with any authentication type: through User ID or Xsolla Login.

User flow

1. The user goes to the landing page with Promocodes block.

2. The user clicks Log in and authorizes through User ID or Xsolla Login.
3. The user enters a code in a special field in the interface and clicks a button to the right of the field.

4. Opens a modal window:
   • when activating a promo code – with info about discounts and bonuses;
   • coupon redemption – with info about discounts and bonuses that user already received.

5. For promo codes promotion:
   1. An updated catalog is displayed with discounts and bonus products using a promo code.

Before making a purchase, the user can cancel the promotional code, then the catalog will be updated and displayed without discounts and bonuses for the promo code. In this case, the promo code is not considered redeemed.

2. User makes a purchase, after it promo code will be considered redeemed.

If bonus items are attached to the promo code, they are credited to the user.

How to get it

To add a block with the ability to redeem codes to your site:

1. Add a field for entering a code in Site Builder.
2. Create promotions with promo codes or coupons in the Store.

Set up in Web Shop

1. Open your project in Publisher Account.
2. Click Site Builder in the side menu.
3. In the Sites section, select your site and click Open Site Builder.
4. Click Add block.
5. Choose Promocodes block.

Set up in Publisher Account

• Promo codes
• Coupons

To set up a promo code promotion:

1. Open your project in Publisher Account.
2. In the side menu, click Store.
3. In the LiveOps and promotion tools pane click:
   • Connect – if you don’t have promotions
   • Configure – if you previously connected promotions

4. Click Create promotion.

5. Specify the following parameters:
   • Enter the promotion name.
   • Choose Promo codes as the promotion type.
6. Create an External ID — a unique promotion identifier used to manage promotions via API methods.
7. Specify the discount percentage for the promo code. The discount can be applied to the entire purchase or to specific items.
8. Choose the bonus items that the user receives when they redeem a promo code:
• no reward
• virtual currency package
• virtual item (one or more, including bundles and time-limited items)

9. Specify the total number of redemptions and number of redemptions per user.

10. Specify the duration of the campaign.

11. Check the settings and save the promotion.
12. Go to the promotion editing menu.
13. In the Codes tab, choose how the promo codes are generated.
14. Generate the promo code or enter it manually.
15. Save changes.
16. Activate the promotion.

Note

While the promotion is active, you cannot change it.

To set up a promotion via Publisher Account:

1. Open your project in Publisher Account.
2. In the side menu, click Store.
3. In the LiveOps and promotion tools panel click:
   • Connect – if you don’t have promotions
   • Configure – if you previously connected promotions

4. Click Create promotion.

5. Specify the following parameters:
   1. Enter the promotion name.
   2. Choose Coupon as the promotion type.
   3. Create an External ID — a unique promotion identifier used to manage promotions via API methods.
   4. Choose the bonus item that the user receives when they redeem a coupon:
      1. Virtual currency package.
      2. Virtual item (one or several, including bundles and time-limited items).

6. Specify the total number of redemptions and the number of redemptions per user.

7. Set the campaign start and end dates.

8. Check the settings and save the promotion.

9. Go to the promotion editing menu.
10. In the Codes menu, choose the method for how the coupons are generated.
11. Generate the coupon code or enter it manually.
12. Save changes.
13. Activate the promotion.

Note

While the promotion is active, you cannot change it.