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 options de personnalisation suivantes 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. L'utilisateur non autorisé accède au catalogue des objets et voit les objets qui n'ont pas été configurés pour des promotions personnalisées.
2. L'utilisateur clique sur Se connecter et autorise l'accès via Xsolla Login.

3. Xsolla envoie une requête des attributs utilisateur via Xsolla Login.
4. Xsolla affiche un catalogue personnalisé en se basant sur les règles de disponibilité des objets et des promotions créées du côté de 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 pour l'utilisateur, celui-ci reçoit un message indiquant que l'objet ne peut pas être acheté ;
   • si l'objet est disponible, l'utilisateur peut procéder au paiement.

Configuration d'un catalogue des objets personnalisé

Pour utiliser une personnalisation du catalogue des objets pour les utilisateurs réalisée côté Xsolla :

1. Configurez les attributs utilisateur dans la solution Login.
2. Définissez les règles d’affichage du catalogue.

Règles d'affichage du catalogue

Les règles d’affichage du catalogue vous permettent de personnaliser l’affichage du catalogue en fonction des attributs de l’utilisateur.

Une règle peut contenir un nombre illimité de biens de types suivants :

• objet ;
• lot ;
• package de monnaie ;
• clés de jeu.

Vous pouvez créer plusieurs conditions avec le même attribut utilisateur dans une seule règle.

Création d'une règle d'affichage du catalogue

Pour créer une règle d’affichage du catalogue :

1. Ouvrez le projet dans votre Compte éditeur.
2. Cliquez sur Store dans le menu latéral.
3. Dans le volet Catalog Management, cliquez sur Configure.

4. Dans le volet Catalog display rules, cliquez sur Configure.

5. Cliquez sur Create rule.

6. Spécifiez le nom de la règle et définissez les conditions d'affichage de l'objet dans le catalogue.

7. Sélectionnez les objets auxquels la règle s'appliquera.

8. Vérifiez vos paramètres. Si nécessaire, cliquez sur le bouton Edit pour apporter des modifications.

9. Cliquez sur Save and Exit.

Pour modifier et supprimer des règles, cliquez sur l’icône ••• et sélectionnez l’élément correspondant du menu. Pour activer ou désactiver une règle, cliquez sur le commutateur et sélectionnez un élément.

Vous pouvez utiliser le Compte éditeur ou des méthodes API pour gérer les règles qui définissent l’affichage du catalogue. Vous pouvez spécifier la sélection et la quantité des objets ainsi que les conditions appliquées à ces objets.

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

Si vous souhaitez personnaliser le catalogue de votre côté, envoyez une demande à votre responsable de la réussite client ou un e-mail à csm@xsolla.com. Cette fonctionnalité est utile lorsque vous souhaitez implémenter une logique de personnalisation avancée de votre côté, sans avoir à définir de règles et spécifier des attributs du côté de Xsolla.

Flux utilisateur

1. L'utilisateur non autorisé accède au catalogue des objets et voit tous les objets.
2. L'utilisateur clique sur Se connecter et autorise l'accès via Xsolla Login.

3. Xsolla envoie un webhook avec une requête des objets par ID utilisateur.
4. La réponse du partenaire renvoie une liste des SKU des objets 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 script sont exécutées pour vérifier la disponibilité des objets au moment de l'achat :
   • si un objet n'est plus disponible pour l'utilisateur, celui-ci reçoit un message indiquant que l'objet ne peut pas être acheté ;
   • si l'objet est disponible, l'utilisateur peut procéder au paiement.

Configuration d'un catalogue des objets personnalisé

1. Contactez votre responsable de la réussite client ou envoyez un e-mail à csm@xsolla.com pour connecter la personnalisation.
2. Ouvrez le projet dans votre Compte éditeur, accédez à Settings > Webhooks et entrez l’URL pour envoyer des webhooks. Cette étape est facultative si vous avez déjà des webhooks configurés.
3. Configurez le traitement du webhook Personnalisation du catalogue côté partenaire :
   1. Xsolla envoie un webhook contenant les paramètres de l’utilisateur et du projet à l’URL du webhook chaque fois qu’un utilisateur interagit avec le catalogue des objets.
   2. En réponse, retournez la liste des UGS des objets disponibles à l’utilisateur. Vous pouvez également inclure des informations sur les limites d’achat d’un certain objet par un utilisateur particulier. Cette fonctionnalité vous permet de contrôler le nombre et le type d’objets que l’utilisateur peut ajouter au panier et acheter.

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.

Changer d'option de personnalisation

Dernière mise à jour: 3 Octobre 2024