Personalization

How it works

Personalization allows you to specify the conditions for displaying the item 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 In-Game Store and configured at least one of the following item types:
  • Partners who want to use Xsolla's personalization of the item catalog for players, or their own personalization.

Prerequisites

  1. Create your Xsolla Publisher Account.
  2. Create a new project.
  3. Connect Store to your project.
  4. Create an item catalog.

Xsolla side personalization

User flow

  1. Unauthorized user goes to the Xsolla store and sees items that haven’t been set up for personalized promotions.
  2. The user clicks Log in and authorizes through Xsolla Login.

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

  1. At the time of purchase, the Xsolla store requests the user's attributes again and compares them with the personalization rules:
    • If an item is no longer available to the user, the user receives a message that the item cannot be purchased.
    • If the item 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 item catalog

To use Xsolla's customization of the product catalog for players:

  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 giving discounts on purchases of virtual items to players who are at least a certain level in the 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 implement the decision logic (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 Xsolla store and sees all the products.
  2. The user clicks Log in and authorizes through Xsolla Login.

  1. The Xsolla store sends a webhook that requests products by user ID.
  2. The response from the partner returns a list of product SKUs available to this user.
  3. The user selects an item 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 items at the time of purchase:
    • If an item is no longer available to the user, the user receives a message that the item cannot be purchased.
    • If the item is available, the user proceeds to pay for the items

Setting up a personalized item catalog

  1. Contact the project account manager to connect the feature.
  2. Select a project in your 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 store.
    2. You should return a list of item_id or item 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 product a specified number of times. This feature allows you to control the number and type of products 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 product 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: October 28, 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!