Personnalisation

Comment ça marche

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

Elle vous offre la possibilité de :

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.
Note
Vous ne pouvez utiliser qu’une seule variante de personnalisation. Pour la changer, suivez ces instructions.

Qui peut l'utiliser

Les partenaires qui souhaitent utiliser la personnalisation du catalogue des jeux côté Xsolla 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 jeux et voit les jeux 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.
  1. Xsolla envoie une requête des attributs utilisateur via Xsolla Login.
  2. Xsolla affiche un catalogue personnalisé en se basant sur les règles de disponibilité des jeux et des promotions créées côté Xsolla, ainsi que sur les attributs utilisateur obtenus à partir de Xsolla Login.
  3. L'utilisateur sélectionne un jeu dans le catalogue personnalisé et clique sur Acheter maintenant.
  1. Au moment de l'achat, Xsolla envoie une nouvelle requête des attributs utilisateur et les compare aux règles de personnalisation :
    • si un jeu n'est plus disponible pour l'utilisateur, celui-ci reçoit un message indiquant que le jeu ne peut pas être acheté ;
    • si le jeu est disponible, l'utilisateur peut procéder au paiement.
Note
Lorsque vous modifiez les attributs utilisateur, vous devez rapidement soumettre les données mises à jour à Xsolla Login.

Configuration d'un catalogue des jeux personnalisé

Pour utiliser une personnalisation du catalogue des jeux 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.
Note
Consultez le tutoriel étape par étape pour apprendre comment personnaliser le catalogue d’articles du côté de Xsolla.

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.

Note
Plusieurs règles peuvent être appliquées au même objet. Si aucune règle ne s’applique à un objet, il sera accessible à tous les utilisateurs.

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.
  1. Dans le volet Catalog display rules, cliquez sur Configure.
  1. Cliquez sur Create rule.
  1. Spécifiez le nom de la règle et définissez les conditions d'affichage de l'objet dans le catalogue.
  1. Sélectionnez les objets auxquels la règle s'appliquera.
  1. Vérifiez vos paramètres. Si nécessaire, cliquez sur le bouton Edit pour apporter des modifications.
  1. 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, comme une réduction de prix d’un DLC pour les utilisateurs qui possèdent déjà le jeu de base.

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.

Note
La configuration côté partenaire de promotions personnalisées n’est pas disponible. Vous pouvez seulement configurer des promotions personnalisées côté Xsolla.

Flux utilisateur

  1. L'utilisateur non autorisé accède au catalogue des jeux et voit tous les jeux.
  2. L'utilisateur clique sur Se connecter et autorise l'accès via Xsolla Login.
  1. Xsolla envoie un webhook avec une requête des jeux par ID utilisateur.
  2. La réponse du partenaire renvoie une liste des UGS des jeux disponibles pour cet utilisateur.
  3. L'utilisateur sélectionne un jeu dans le catalogue personnalisé et clique sur Acheter maintenant.
  1. Côté Xsolla, les étapes 3 et 4 de ce script sont exécutées pour vérifier la disponibilité des jeux au moment de l'achat :
    • si un jeu n'est plus disponible pour l'utilisateur, celui-ci reçoit un message indiquant que le jeu ne peut pas être acheté ;
    • si le jeu est disponible, l'utilisateur peut procéder au paiement.

Configuration d'un catalogue des jeux 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 :
    1. Xsolla enverra un webhook contenant les paramètres de l’utilisateur et du projet à l’URL du webhook lorsque l’utilisateur interagit avec le catalogue des jeux.
    2. En réponse à cette requête, vous devez renvoyer une liste d’UGS des jeux qui sont disponibles pour l’utilisateur. Cette liste peut également contenir des informations spécifiant le nombre d’achats possibles d’un jeu particulier pour un utilisateur spécifique. Cette fonctionnalité vous permet de contrôler le nombre et le type de jeux 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.

Avis
Vous devez vous assurer que les webhooks sont traités en moins de 3 secondes. Si le temps de réponse dépasse cette limite, les utilisateurs recevront un message d’erreur.
Pour tester le webhook, interrogez le catalogue des jeux. En réponse, vous recevrez un webhook à l’URL configurée.

Changer d'option de personnalisation

Cet article vous a été utile ?
Merci !
Que pouvons-nous améliorer ? Message
Nous sommes désolés de l'apprendre
Dites-nous pourquoi vous n'avez pas trouvé cet article utile. Message
Merci pour votre commentaire !
Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.
Dernière mise à jour: 8 Novembre 2024

Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.

Signaler un problème
Nous améliorons continuellement notre contenu grâce à vos commentaires.
Indiquez votre adresse e-mail pour un suivi
Merci pour votre commentaire !