Personalization

Personalization allows you to specify the conditions of a promotion that applies to certain authorized users. When setting up a promotion, you can define which user attributes are used as a condition(s). For example, players with a certain level or number of transactions can receive a discount when purchasing virtual items.

User flow

1. The user goes to the landing page with personalized content.

2. The user clicks Log in and authorizes through User ID or Xsolla Login.
3. User sees additional personal offers.

4. The user clicks Buy now and pays for items.

Set up attributes

The sequence of attribute settings depends on the user authorization option used in the Web Shop.

User attribute validation rules

To create user attribute validation rules:

1. Open your project in Publisher Account.
2. In the side bar click Login.
3. Click Configure in the pane of a Login project.
4. Go to the User database block and select the User attributes schema section.

4. Specify the attribute validation rules in JSON Schema format (optional):

1. • In the properties object, specify a set of user attributes and their properties. Allowed data types: string, number, integer, or boolean. The object’s depth: 1.
   • In the additionalProperties object, specify whether it is possible to create additional fields not listed in the properties object. Set the value to true if you want to allow additional fields or false to disallow.
   • In the required array, specify a list of required attributes.
   • Set the value of the type field to object.

JSON Schema example:

{
	"$schema": "https://json-schema.org/draft/2020-12/schema",
	"properties": {
		"game": {
			"description": "Name of the game played by user.",
			"type": "string"
		},
		"age": {
			"description": "User's age.",
			"type": "integer"
		},
		"had_ban": {
                 "description": "Whether the user was banned.",
			"type": "boolean"
		},
		"last_purchase": {
                 "description": "Date of user's last purchase.",
			"type": "string",
		}
	},
	"additionalProperties": false,
	"required": [
		"age",
		"game",
		"last_purchase"
	],
	"type": "object"
}

Catalog display rules

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

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

• item
• bundle
• package of currencies
• game keys

You can create, modify, delete, activate, or deactivate rules. You can create multiple conditions with the same user attribute in one 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.
4. In the Catalog display rules pane, click Configure.
5. Click Create rule.

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

7. Set the items to which the rule will be applied.
8. Check the settings.
9. Click Save.

Setting up personalized promotions

You can set up personalized promotions, such as giving discounts on purchases of virtual items to users 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.