Attributs utilisateur

Comment ça marche

Les attributs sont des caractéristiques de l’utilisateur qui sont stockées sous forme de paires clé-valeur. À l’aide des attributs, vous pouvez :

• segmenter les utilisateurs ;
• préparer des vitrines personnalisées pour chaque groupe d’utilisateurs dans votre Web Shop ;
• transférer des informations sur les utilisateurs entre différentes plateformes de publication.

Il existe deux types d’attributs utilisateur :

• Modifiable par l'utilisateur. Les valeurs de ce type d'attributs sont saisies par l'utilisateur ou spécifiées selon la logique du jeu côté client. Par exemple, le nom et les statistiques de personnage, le niveau de difficulté du jeu, etc.

• En lecture seule. Les valeurs de ce type d'attributs sont saisies et modifiées côté serveur de votre application. Nous vous recommandons de les utiliser pour configurer les statistiques des personnages du jeu ou les paramètres utilisateur qui ne devraient pas changer régulièrement. Par exemple, les chances d'obtenir un bonus, les paramètres clés des personnages du jeu, les catégories d'utilisateurs, etc.

Si nécessaire, pour garantir l’intégrité des données passées, définissez des règles de validation des attributs au format JSON Schema dans le Compte éditeur. Pour gérer les attributs, utilisez les méthodes Login API ou les webhooks. Vous pouvez également modifier les valeurs des attributs dans votre Compte éditeur.

Comment configurer

Pour configurer les attributs utilisateur :

1. Ouvrez votre projet dans le Compte éditeur et accédez à la section Login.
2. Dans le volet du projet de connexion, cliquez sur Configure.
3. Accédez au bloc User database et sélectionnez la section User attributes schema.

4. Spécifiez les règles de validation des attributs au format JSON Schema (facultatif) :

1. • Dans le champ properties, spécifiez un ensemble d'attributs utilisateur et leurs propriétés. Types de données autorisés : string, number, integer ou boolean. Profondeur de l'objet :
   • Dans l'objet additionalProperties, spécifiez s'il est possible de créer des champs supplémentaires non répertoriés dans properties. Définissez la valeur sur true si vous souhaitez autoriser des champs supplémentaires ou sur false pour interdire ;
   • Dans le tableau required, spécifiez la liste des attributs obligatoires ;
   • Définissez la valeur du champ type sur object.

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

5. Sur votre site web ou votre application, utilisez les méthodes Login API suivantes pour implémenter la logique de fonctionnement des attributs utilisateur :
   • pour gérer le schéma JSON :
     • Delete Schema
     • Get Schema
     • Update Schema
     • Update user’s attributes from server
     • Update user’s read-only attributes from server
     • Update user’s attribute from client

1. • pour la mise à jour des données dans le stockage :
     • Update user’s attributes from server
     • Update user’s read-only attributes from server
     • Auth by custom ID
     • Update user’s attribute from client

1. • pour obtenir des données depuis le stockage :
     • Get user’s attributes from client
     • Get user’s read-only attributes from client
     • Get users by attribute from server
     • Get user’s attributes from server
     • Get user’s read-only attributes from server

Comment modifier les valeurs des attributs utilisateur

Pour modifier les valeurs des attributs :

1. Ouvrez votre projet dans le Compte éditeur et accédez à la section Login.
2. Dans le volet du projet de connexion, cliquez sur Configure.
3. Accédez au bloc User database et sélectionnez la section Users.

4. Trouvez l'utilisateur dans le tableau et cliquez sur Attributes dans la chaîne correspondante.

5. Dans la fenêtre contextuelle, sélectionnez l'attribut que vous souhaitez modifier, cliquez sur le symbole de crayon pour modifier la valeur et cliquez sur Save.