用户属性

运行机制

属性是以键值对形式存储的用户特征。通过属性可以：

细分用户
在网页商城中为不同用户群体准备个性化店面
在不同发布平台间传输用户信息

用户属性有两种：

用户可编辑属性。此类属性的值由用户根据客户端侧的游戏内逻辑输入或指定，例如名字、角色属性、游戏难度等。

只读属性。此类属性的值在应用程序的服务器侧输入或编辑。建议将此类属性用于配置不常更改的游戏角色属性或用户参数，例如获得某个奖励的机会、游戏角色关键参数、用户类别等。

如需要，为确保传输数据的完整性，您可以在发布商帐户中以JSON机制的格式设置属性验证规则。您可以用Login API方法或Webhook管理属性。您也可以在发布商帐户中编辑属性值。

如何获取

要设置用户属性：

在您的发布商帐户中打开项目，然后前往登录管理器部分。
在登录管理器项目的面板中单击配置。
前往用户数据库区块，然后选择用户属性机制部分。

以JSON机制的格式指定属性验证规则：

要启用游戏内商店个性化，请将所有用户属性添加到JSON机制。

- 在properties对象中，指定一组用户属性。允许的数据类型：string、number、integer、或boolean。对象深度：1.
- 在additionalProperties对象中，指定是否可以创建未在properties对象中列出的其他字段。如要允许其他字段，请将值设置为true，否则设置为false。
- 在required数组中，指定必需属性的列表。
- 将type字段的值设置为object。

单独指定每个用户属性。不支持正则表达式、掩码和patternProperties属性。
如未在JSON机制中指定用户属性类型，则更新属性时type字段默认指定为值data_type。

JSON机制示例：

Copy

Full screen

Small screen

{
	"$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"
}