Personnalisation

Comment ça marche

La personnalisation permet de définir les conditions d’affichage du catalogue des objets et celles d’application des promotions uniquement pour certains utilisateurs autorisés.

Elle vous offre la possibilité de :

• afficher à l’utilisateur des promotions et des objets plus pertinents pour lui ;
• inciter les utilisateurs à effectuer leur premier achat dans le jeu.

Les types de personnalisation suivants sont disponibles :

• Personnalisation côté Xsolla. Les règles et la logique de personnalisation sont configurées et stockées du côté de Xsolla. Le partenaire passe les attributs utilisateur à Xsolla, qui crée ensuite le catalogue en fonction de la logique configurée.
• Personnalisation côté partenaire. Les règles et la logique de personnalisation sont configurées et stockées par le partenaire lui-même, qui passe ensuite un catalogue pour un utilisateur spécifique à Xsolla.

Qui peut l'utiliser

• Les partenaires qui ont intégré In-Game Store et configuré au moins un des types de biens suivants :
  • monnaie virtuelle ;
  • objets virtuels ;
  • lots.
• Les partenaires qui souhaitent utiliser la personnalisation du catalogue des objets de Xsolla pour les utilisateurs, ou leur propre personnalisation.

Prérequis

Avant de personnaliser le catalogue des objets, intégrez le produit In-Game Store.

Personnalisation côté Xsolla

Flux utilisateur

1. Un utilisateur non autorisé accède au catalogue des objets. En fonction de la position de la bascule Afficher les objets aux utilisateurs non autorisés, l'utilisateur voit :
   • les objets sans règles de personnalisation ;
   • tous les objets, y compris ceux avec des règles de personnalisation.
2. L'utilisateur clique sur Log in et s'autorise via Xsolla Login.

3. Xsolla envoie une requête des attributs utilisateur depuis Xsolla Login.
4. Xsolla affiche un catalogue personnalisé en se basant sur les règles de disponibilité des objets, des promotions définies côté Xsolla, ainsi que sur les attributs utilisateur obtenus à partir de Xsolla Login.
5. L'utilisateur sélectionne un objet dans le catalogue personnalisé et clique sur Acheter maintenant.

6. Au moment de l'achat, Xsolla envoie une nouvelle requête des attributs utilisateur et les compare aux règles de personnalisation :
   • si un objet n'est plus disponible à l'achat, l'utilisateur reçoit un message indiquant que l'objet ne peut pas être acheté ;
   • si l'objet est disponible à l'achat, l'utilisateur peut procéder au paiement.

Configuration d'un catalogue des objets personnalisé

Pour utiliser la personnalisation du catalogue des objets implémentée côté Xsolla :

1. Configurez les attributs utilisateur dans le produit Login.
2. Activez la personnalisation.
3. Définissez les règles d’affichage du catalogue. Vous pouvez le faire soit lors de l’activation de la personnalisation, soit dans le projet dans le Compte éditeur dans la section Store > Gestion de catalogue > Règles d’affichage du catalogue.

Pour activer la personnalisation :

1. Ouvrez votre projet dans le Compte éditeur et accédez à la section Store > Personnalisation.
2. Si la personnalisation n’est pas configurée, cliquez sur Configurer la personnalisation.
3. Sélectionnez le type Personnalisation côté Xsolla.
4. Cliquez sur Suivant.

5. Créez une règle d’affichage du catalogue :
   • S’il n’existe pas encore de règles d’affichage du catalogue, la fenêtre de création de règles s’ouvre automatiquement ;
   • Si des règles d’affichage du catalogue existent déjà, dans la section Règles d’affichage du catalogue, cliquez sur Créer une règle.

6. Spécifiez le nom de la règle et définissez les conditions d’affichage des objets dans le catalogue.

7. Pour que les objets auxquels des règles ont été appliquées soient visibles à l’utilisateur non autorisé, réglez la bascule Afficher les objets affectés aux utilisateurs non connectés sur On.

8. Cliquez sur Suivant.
9. Sélectionnez les objets auxquels la règle s’appliquera.

10. Cliquez sur Suivant.
11. Vérifiez les paramètres. Si nécessaire, cliquez sur le bouton Modifier pour apporter des modifications.

12. Cliquez sur Enregistrer et quitter.

Pour modifier ou supprimer des règles, accédez à la page Règles d’affichage du catalogue, cliquez sur l’icône ••• dans la ligne de la règle et sélectionnez l’option de menu souhaitée. Pour activer ou désactiver une règle, modifiez son statut.

Configuration des promotions personnalisées

Vous pouvez configurer des promotions personnalisées, telles que l’attribution de remises sur les achats d’objets virtuels aux utilisateurs qui ont atteint un certain niveau de jeu.

Vous pouvez définir une ou plusieurs conditions. Notez que ces conditions ne peuvent pas être modifiées tant que la promotion est active. Consultez Configurer des campagnes promotionnelles pour plus d’informations sur les types de promotions et les paramètres associés.

Pour configurer des promotions personnalisées :

1. Configurez les attributs utilisateur dans la solution Login.
2. Configurez une campagne promotionnelle avec des bonus ou une campagne avec des réductions. Réglez la bascule Trigger promotion only for specific users sur On et spécifiez les conditions.

Personnalisation côté partenaire

Choisissez ce type si vous utilisez une logique de personnalisation avancée implémentée de votre côté et que vous préférez ne pas définir de règles ni spécifier des attributs côté Xsolla.

Pour utiliser la personnalisation du catalogue des objets implémentée de votre côté :

1. Créez un catalogue des objets côté Xsolla et synchronisez-le avec le vôtre. Chaque objet dans votre système doit avoir un item_id ou une ugs correspondante dans Xsolla.
2. Activez la personnalisation dans le Compte éditeur.
3. Configurez le traitement du webhook Personnalisation du catalogue côté partenaire.

Flux utilisateur

1. Un utilisateur non autorisé accède au catalogue des objets. En fonction de la position de la bascule Afficher les objets pertinents aux utilisateurs non connectés, l’utilisateur voit :
   • tous les objets du catalogue ;
   • les objets que vous renvoyez en réponse au webhook Personnalisation du catalogue côté partenaire.

L'ordre dans lequel les objets s'affichent à l'utilisateur dépend du paramètre de la bascule Obtenir l'ordre des UGS via la réponse au webhook.

2. L’utilisateur clique sur Log in et s’autorise.

3. Xsolla envoie un webhook qui demande des objets par ID utilisateur.
4. La réponse du partenaire renvoie une liste des UGS disponibles pour cet utilisateur.
5. L’utilisateur sélectionne un objet dans le catalogue personnalisé et clique sur Acheter maintenant.

6. Côté Xsolla, les étapes 3 et 4 de ce flux sont exécutées pour vérifier la disponibilité des objets au moment de l’achat :
   • Si un objet n’est plus disponible à l’achat, l’utilisateur reçoit un message indiquant que l’objet ne peut pas être acheté ;
   • Si l’objet est disponible, l’utilisateur procède au paiement.

Configuration d'un catalogue des objets personnalisé

Pour activer la personnalisation :

1. Ouvrez votre projet dans le Compte éditeur et accédez à la section Store > Personnalisation.
2. Si la personnalisation n’est pas configurée, cliquez sur Configurer la personnalisation.
3. Sélectionnez le type Personnalisation côté partenaire.

4. Cliquez sur Suivant.
5. Configurer l’affichage des objets. Pour ce faire, activez les bascules correspondantes :
   • Afficher les objets pertinents aux utilisateurs non connectés — pour afficher aux utilisateurs non autorisés uniquement les objets renvoyés en réponse au webhook Personnalisation du catalogue côté partenaire. Si la bascule est inactive, les utilisateurs non autorisés verront tous les objets du catalogue ;
   • Obtenir l’ordre des UGS via la réponse au webhook — pour afficher les objets à l’utilisateur dans l’ordre que vous passez en réponse au webhook Personnalisation du catalogue côté partenaire. Si la bascule est inactive, les objets s’affichent à l’utilisateur dans l’ordre défini côté Xsolla. Pour définir ou récupérer l’ordre d’affichage des objets côté Xsolla, utilisez le paramètre ordre dans la sous-section Administrateur du groupe Objets et monnaie virtuels

6. Cliquez sur Enregistrer les modifications.

Configuration du traitement des webhooks

Xsolla enverra un webhook Personnalisation du catalogue côté partenaire qui contient les paramètres de l’utilisateur et du projet à l’URL du webhook lorsqu’un utilisateur interagit avec le catalogue des objets. Configurer le traitement des webhooks :

1. Dans votre projet dans le Compte éditeur, accédez à Paramètres du projet > Webhooks et entrez l’URL pour envoyer les webhooks. Cette étape est facultative si vous avez déjà configuré des webhooks.
2. Vous devez renvoyer une liste des UGS des objets disponibles pour l’utilisateur. Vous pouvez également préciser si un objet spécifique est achetable un nombre limité de fois ou uniquement pendant une période donnée. Cette fonction vous permet de gérer le nombre et le type d’objets accessibles à l’utilisateur.

Chaque requête à Xsolla pour récupérer le catalogue déclenche une nouvelle requête vers le serveur de jeu. Xsolla utilise la mise en cache des données pour minimiser les requêtes au serveur de jeu et envoie le webhook partner_side_catalog à l’expiration de la durée de vie du cache.

Si le cache n’est pas encore complet, le webhook partner_side_catalog est envoyé avec chaque requête à Xsolla. Par exemple, Xsolla reçoit plusieurs requêtes de catalogue simultanément et le serveur de jeu répond avec un délai.

Pour tester le webhook, interrogez le catalogue des objets. En réponse, vous recevrez un webhook à l’URL configurée.

Modifier le type de personnalisation

Dernière mise à jour: 19 Mars 2025