To get new users to your application and increase sales, you can implement coupon promotions. When redeeming a coupon, the user may receive one of the following rewards:

• virtual currency package
• game key
• virtual item

For details on the features and limitations of coupon promotions, see the In-Game Store guide.

To work with coupon promotions:

1. Complete the settings in Publisher Account following to the instructions for setting up promotional campaigns with coupons.
2. Implement in-game logic using the following SDK methods:

• XStore.getCouponRewardsByCode — gets a list of items that can be credited to the user when the coupon is redeemed. The Get coupon rewards API call is used alongside the SDK method.
• XStore.redeemCoupon — redeems the coupon code and rewards the user. The Redeem coupon code API call is used alongside the SDK method.

To get new users to your application and increase sales, you can implement a campaign with promo codes. When redeeming a promo code, the user may receive one or more of the following rewards:

• discount that applies to the user’s cart
• bonus items:
  • virtual currency package
  • game key
  • virtual item including a bundle or nonrenewing subscription

For details on the features and limitations of campaigns with promo codes, see the In-Game Store guide.

To work with promo codes:

1. Complete the settings in Publisher Account by following the instructions for setting up a campaign with promo codes.
2. Implement in-game logic using the following SDK methods:

1. • XStore.getPromocodeRewardsByCode — gets promo code rewards. Allows users to choose one of many items as a bonus. The Get promo code reward API call is used alongside the SDK method.
   • XStore.redeemPromocode — redeems promo code. After redeeming a promo code, the user gets free items and/or the price of the cart is decreased. The Redeem promo code API call is used alongside the SDK method.

To get new users to your application and increase sales, you can sell sets of items as bundles for less than the cost of their content.

A bundle may include:

• virtual currency (including the platform-dependent currency)
• package of virtual currency
• game keys for preselected DRMs
• virtual items including nonrenewing subscriptions
• bundles

For details on the features and limitations of bundles, see the In-Game Store guide.

To work with bundles:

1. Complete the settings in Publisher Account by following the instructions for setting up a bundle.
2. Implement in-game logic using the following SDK methods:

1. • XStore.getBundleList — gets a list of bundles for building a catalog. The Get list of bundles API call is used alongside the SDK method.
   • XStore.getBundle — gets a bundle for the specified SKU. The Get specified bundle API call is used alongside the SDK method.

Implement the sale of virtual items and virtual currency outside the game via the in-game store site. The purchased items and currency will be available in the player’s inventory.

To integrate your store site with the SDK:

1. Create a store site.
2. Specify the site address of the in-game store in the application code.
3. Implement the logic for your application to work with the store site.

Create a store site

You can create a store site with Site Builder by following the instructions for connecting a store on the site.

If you want to connect a store site that was created using a different solution, follow the instructions for creating a store.

Recommendations for the logic for your application to work with the store site

Follow these recommendations when developing your application:

1. Synchronize the fields of user registration and authorization in your application and in the Login widget on the store site:
   • If a user email and password are used for registration and authorization, set the username equal to the email in the application.

1. • If you use a username, user email and password for registration and authorization, contact your Account Manager to change the Login widget fields.

2. When navigating to the store site from the application client, implement pass-through user authorization. To do this, the user token must be passed in the URL parameters. An example of authorization is shown in the demo app.