Personalization

How it works

Personalization allows you to specify the conditions for displaying the game catalog and applying promotions only for certain authorized users.

The following personalization options are available:

  • Xsolla side personalization. The personalization rules and logic are configured and stored on Xsolla’s side. The partner sends user attributes to Xsolla, and then Xsolla creates the catalog according to the configured logic.
  • Partner side personalization. The personalization rules and logic are configured and stored by the partner, who then passes a catalog for a specific user to Xsolla.

Who can use it

  • Partners who have integrated the Buy Button and configured the sale of game keys.
  • Partners who want to use Xsolla's game catalog personalization or their own personalization.

Prerequisites

  1. Create your Xsolla Publisher Account.
  2. Create a new project.
  3. Connect Store to your project.
  4. Create game key packages.

Xsolla side personalization

User flow

  1. Unauthorized user goes to the game catalog and sees games that aren’t set up for personalized promotions.
  2. The user clicks Log in and authorizes through Xsolla Login.

  1. Xsolla requests user attributes through Xsolla Login.
  2. Xsolla displays a personalized catalog based on the rules of the availability of games and promotions created on Xsolla's side, and user attributes obtained from Xsolla Login.
  3. The user selects a game from the personalized catalog and clicks Buy Now.

  1. At the time of purchase, the Xsolla requests the user's attributes again and compares them with the personalization rules:
    • If the game is no longer available to the user, the user receives a message that the game cannot be purchased.
    • If the game is available, the user proceeds to payment.

Note
You should promptly submit updated data to Xsolla Login when changing user attributes.

Setting up a personalized game catalog

To use Xsolla's personalization of the game catalog for users:

  1. Set up user attributes in the Login product.
  2. Set catalog display rules.

Catalog display rules

Catalog display rules allow you to customize the display of the catalog based on user attributes.

A rule can contain an unlimited number of items of the following types:

  • item
  • bundle
  • package of currencies
  • game keys

You can create multiple conditions with the same user attribute in one rule.

Note
Multiple rules may be applied to the same item. If no rules apply to an item, it will be available to all users.

Creating a catalog display rule

To create a catalog display rule:

  1. Open your project in Publisher Account.
  2. Click Store in the side menu.
  3. In the Catalog Management pane, click Configure.

  1. In the Catalog display rules pane, click Configure.

  1. Click Create rule.

  1. Specify the name of the rule and set the conditions for displaying the item in the catalog.

  1. Select the items to which the rule will apply.

  1. Check your settings. If necessary, click the Edit button to make changes.

  1. Click Save and Exit.

To edit and delete rules, click on the ••• icon and select the menu item. To activate or deactivate a rule, click the switch and select the item.

You can use Publisher Account or API methods to manage the rules that specify how the catalog is displayed. This includes the set and quantity of items and the conditions that will be applied to these items.

Setting up personalized promotions

You can set up personalized promotions, such as discounting a DLC for users who already own the base game.

You can set one or more conditions. Please note that while the promotion is active, you cannot change it. Read Set up promotional campaigns for more information about promotion types and settings.

To set up personalized promotions:

  1. Set up user attributes in the Login product.
  2. Set up a promotional campaign with bonuses or campaign with discounts. Set the Trigger promotion only for specific users switch to On and specify the conditions.

Partner side personalization

You can send a request to the project account manager if you want to personalize the catalog on your side. This feature is useful when you implement advanced personalization logic on your side and do not want to set rules and specify attributes on Xsolla’s side.

Note
Setting up personalized promotions on the partner’s side is not available. You can customize personalized promotions only on Xsolla's side.
Notice
You can use the personalized catalog only if you have Xsolla Login connected.

User flow

  1. Unauthorized user goes to the game catalog and sees all the games.
  2. The user clicks Log in and authorizes through Xsolla Login.

  1. Xsolla sends a webhook that requests games by user ID.
  2. The response from the partner returns a list of game SKUs available to this user.
  3. The user selects a game from the personalized catalog and clicks Buy Now.

  1. On Xsolla’s side, step 3 and 4 of this script are executed to check the availability of games at the time of purchase:
    • If an game is no longer available to the user, the user receives a message that the game cannot be purchased.
    • If the game is available, the user proceeds to pay for the game.

Setting up a personalized game catalog

  1. Contact the project account manager to connect the personalization.
  2. Open your project in Publisher Account, go to Settings > Webhooks and enter the URL to send webhooks. This step is optional if you already have webhooks set up.
  3. Set up webhook processing:
    1. Xsolla will send a webhook that contains the user and project parameters to the webhook URL when a user interacts with the game catalog.
    2. You should return a list of game SKU that are available to the user in response. In this case, you can also include information that a particular user can buy a certain game a specified number of times. This feature allows you to control the number and type of games that the user can add to the cart and buy.
Notice
You should ensure the webhooks are processed in less than 3 seconds - users will receive an error if the response is longer.

To test the webhook, you can query the game catalog. You will receive a webhook at the configured URL in response.

Was this article helpful?
Thank you!
Is there anything we can improve? Message
We’re sorry to hear that
Please explain why this article wasn’t helpful to you. Message
Thank you for your feedback!
We’ll review your message and use it to help us improve your experience.
Rate this page
Rate this page
Is there anything we can improve?

Don’t want to answer

Thank you for your feedback!
Last updated: December 30, 2022

Found a typo or other text error? Select the text and press Ctrl+Enter.

Report a problem
We always review our content. Your feedback helps us improve it.
Provide an email so we can follow up
Thank you for your feedback!