Intégration avec PlayFab

Comment ça marche

PlayFab offre aux développeurs de jeux des solutions serveur prêtes à l’emploi pour gérer le catalogue des objets et la monétisation. Après l’intégration avec PlayFab, vous pouvez :

• Importer un catalogue de PlayFab dans In-Game Store pour utiliser les solutions Xsolla ;
• Transférer automatiquement des objets qu’un utilisateur achète dans In-Game Store vers PlayFab.

Qui peut l'utiliser

• Partenaires ayant intégré PlayFab et souhaitant augmenter la zone de distribution des biens (monnaie virtuelle et objets virtuels) par le biais des solutions Xsolla.
• Partenaires ayant intégré les solutions Xsolla et souhaitant monétiser leurs biens dans PlayFab (vendre des biens contre des devises réelles).

Règles d'importation

Lors de l’importation de biens depuis PlayFab, la logique suivante s’applique :

• Les biens Durable dans PlayFab sont importés en tant qu’objets virtuels (pas de monnaie virtuelle ni de lots).
• Tous les biens, ainsi que les packages de monnaie virtuelle et les biens d’un lot PlayFab, sont importés en tant que consommables (paramètre consumable = true ou non spécifié).
• La monnaie virtuelle est importée avec le statut Partiellement disponible et sans prix spécifié (indicayeurs API :is_show_in_store = false, is_enabled = true,is_free = true ).
• Un lot contenant un seul type de monnaie virtuelle est importée en tant que package de monnaie virtuelle.
• Un lot contenant plusieurs types de monnaie virtuelle est importée en tant que packages de monnaie virtuelle distincts. Pour chaque combinaison unique d’UGS et de quantité, un package de monnaie virtuelle gratuit est créé avec le statut Partiellement disponible (indicateurs API : is_show_in_store = false, is_enabled = true,is_free = true ).
• Un lot contenant différents types de biens est importé en tant que lot.
• Si le champ Description d’un bien n’est pas rempli dans PlayFab, le champ Name est utilisé comme description du bien ; s’il n’y a pas de champ Name, l’UGS est utilisée.

Limites d'importation

Limites de In-Game Store

• Les containers et les bundles contenant des containers ne sont pas importés.
• Les DropTables et les bundles contenant des DropTables ne sont pas importés.
• Les paramètres spécifiques à PlayFab, tels que isStackable,isTradable,UsageCount,UsagePeriod,UsagePeriodGroup sont ignorés.
• Les consommables sont créés sans tenir compte de la quantité (l'objet disparaît de l'inventaire après la première utilisation).

Limites de PlayFab

• PlayFab ne stocke pas les prix en devises réelles. Seule la monnaie virtuelle préconfigurée codée RM (Real money) est utilisée, équivalente à la devise réelle : 1 cent (100 RM = 1 USD). Par conséquent, vous ne pouvez fixer les prix des biens qu'en monnaie virtuelle ou en RM.
• Les UGS des biens doivent être uniques et se composer de chiffres, de lettres latines, de tirets et de tirets bas.

Comment configurer

Importer un catalogue depuis PlayFab

Si vous n’avez pas encore configuré PlayFab, procédez comme suit :

• Créez votre compte PlayFab.
• Créez votre jeu.
• Obtenez votre Title ID unique de jeu.
• Obtenez votre PlayFab Secret Key.

Accédez au Compte éditeur et importez le catalogue des objets de PlayFab vers In-Game Store.

1. Ouvrez votre projet dans le Compte éditeur et accédez à Store > Gestion de catalogue > Intégration des plateformes externes > PlayFab.
2. Dans l'onglet Importation de biens, spécifiez :
   • Title ID — l'ID du projet dans PlayFab ;
   • Clé secrète — la clé du projet dans PlayFab.
3. Cliquez sur Enregistrer.
4. Synchronisez l'inventaire utilisateur avec PlayFab (facultatif) :
   1. Accédez à Synchronisation d'inventaire et spécifiez :
      • Title ID — l'ID du projet dans PlayFab ;
      • Clé secrète — la clé du projet dans PlayFab.
   2. Réglez la bascule Synchroniser l'inventaire utilisateur avec PlayFab sur On.
   3. Cliquez sur Enregistrer.
5. Accédez à l'onglet Importation de biens et cliquez sur Démarrer l'importation. L'importation du catalogue démarre automatiquement.
6. Pour vendre des objets virtuels dans le magasin en ligne créé par Site Builder, configurez les groupes d'objets dans le Compte éditeur et attribuez-en un ou plusieurs à chaque objet.
7. Pour afficher les images des objets, téléchargez-les vers votre Compte éditeur.

Pour vérifier si l’importation s’est terminée correctement, accédez à la section Store du menu latéral et assurez-vous que les objets, la monnaie et les lots sont activés dans les onglets Monnaie virtuelle, Objets virtuels et Lots.

Réimporter le catalogue

Lors de la réimportation du catalogue, vous devez prendre en compte les points suivants :

• les objets déjà présents dans Store seront mis à jour ;
• les objets qui ne sont pas disponibles dans Store seront ajoutés ;
• les objets qui ont été supprimés de la source d’importation resteront dans Store. Vous pouvez les supprimer dans votre Compte éditeur ou via API.

Ajouter des objets à l'inventaire PlayFab

Vous pouvez configurer l’ajout des objets achetés dans Xsolla In-Game Store à votre inventaire PlayFab de la manière suivante :

• En synchronisant l’inventaire utilisateur avec PlayFab.
• En intégrant le stockage PlayFab avec Xsolla Login. Dans ce cas, l’ID PlayFab est spécifié dans le jeton. En cas de retour d’objets côté Xsolla, une requête est envoyée à PlayFab dans le jeton.

Pour synchroniser l’inventaire utilisateur avec PlayFab :

1. Ouvrez votre projet dans le Compte éditeur et accédez à Store > Gestion de catalogue > Intégration des plateformes externes > PlayFab.
2. Accédez à Synchronisation d’inventaire et spécifiez :
   • Title ID — ID unique du jeu dans PlayFab ;
   • Clé secrète — clé du projet dans PlayFab.
3. Réglez la bascule Synchroniser l’inventaire utilisateur avec PlayFab sur On.
4. Cliquez sur Enregistrer.

Désormais, les informations sur les objets achetés dans In-Game Store sont automatiquement transférées à PlayFab.

Dernière mise à jour: 27 Décembre 2024