Importer le catalogue des objets depuis des plateformes externes

Importez des objets et des abonnements depuis des plateformes externes et synchronisez l’inventaire utilisateur.

Importer un catalogue depuis Google Play

Avis

Avant de commencer l’importation, vérifiez que Google Play Android Developer API est activée dans votre projet Google Play. Pour ce faire, accédez à https://console.developers.google.com/apis/api/androidpublisher.googleapis.com/overview?project={project_id}, où project_id correspond à l’ID de votre projet dans Google Play. Si cette API est désactivée, activez-la. Notez que les paramètres prennent un certain temps à s’appliquer, donc l’importation peut échouer si vous essayez immédiatement après avoir activé les paramètres. Attendez quelques minutes et réessayez.

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 Integration with external platforms, cliquez sur Configure.
5. Dans le volet Google Play, cliquez sur Configure.
6. Spécifiez Application ID, c'est-à-dire l'identifiant de votre application sur Google Play.

7. Téléchargez un fichier JSON avec la clé privée.

8. Accédez à Google Play Console, dans le menu latéral, cliquez sur Users and permissions et ajoutez un compte de service en tant que nouvel utilisateur avec le rôle Android Management User. Pour ce faire, vous devez avoir le rôle de Project IAM admin.

9. Cliquez sur Save.
10. Cliquez sur Start import. L'importation du catalogue démarre automatiquement.

11. 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.
12. Pour afficher les images des objets, téléchargez-les vers votre Compte éditeur.

Importer un catalogue depuis App Store

• ID d’application à partir de la section App Information dans App Store Connect ;
• Clé API et Issuer ID à partir de la section Users and Access dans App Store Connect.

Obtenir l'ID de l'application

1. Connectez-vous à App Store Connect.
2. Accédez à la section Apps.
   
   

   

3. Ouvrez la page de votre application.
4. Naviguez vers General Information > App Information.
5. Dans General Information, copiez l’ID d’application dans le champ Apple ID.
   
   

   

Obtenir la clé API et l'Issuer ID

L’Issuer ID dans App Store Connect sert à interagir avec Apple API, y compris App Store Connect API. Il est indispensable pour configurer les clés API et automatiser des tâches comme la gestion des applications, la récupération des données analytiques et d’autres opérations sur App Store Connect.

La clé API est un identifiant unique utilisé pour authentifier les requêtes API dans App Store Connect API et garantir un accès sécurisé aux données et fonctionnalités du compte Apple Developer.

Pour obtenir l’Issuer ID et la clé API dans App Store Connect :

1. Connectez-vous à App Store Connect et accédez à la section Users and Access.
2. Ouvrez l’onglet Integrations.
3. Dans le menu latéral Keys, cliquez sur App Store Connect API.
4. Accédez à l’onglet Team Keys. Cliquez sur l’icône + pour créer une nouvelle clé API.
   
   

   

5. Dans la fenêtre Generate API Key, attribuez un nom à la clé et définissez son niveau d’accès.
6. Cliquez sur Generate.
   
   

   

7. La clé nouvellement créée apparaîtra dans la liste des clés API actives. Téléchargez-la en tant que fichier P8 et copiez le Key ID.
   
   

   

8. Dans l’onglet Team Keys, copiez l’Issuer ID.
   
   

   

Importer un catalogue depuis l'App Store

1. Ouvrez le Compte éditeur et accédez à Store > Catalog management > Integration with external platforms > App Store.
2. Fournissez les données obtenues dans App Store Connect :
   • ID d’application ;
   • Fichier de clé privée (P8) ;
   • Issuer ID ;
   • Key ID.
3. Cliquez sur Démarrer l’importation. L’importation du catalogue commence automatiquement.
   
   

   

Pour vendre des objets virtuels dans le magasin en ligne créé à l’aide de Site Builder, créez des groupes d’objets dans le Compte éditeur et assignez un ou plusieurs groupes à chaque objet virtuel.

Pour afficher les images des objets, téléchargez-les et modifiez l’objet importé dans Store > Virtual Items.

Importer un catalogue depuis PlayFab

PlayFab propose aux développeurs de jeux des solutions serveur prêtes à l’emploi pour gérer les catalogues et la monétisation. Après l’intégration de PlayFab, vous pouvez importer un catalogue depuis PlayFab vers Store pour utiliser les solutions Xsolla.

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 Integration with external platforms, cliquez sur Configure.
5. Dans le volet PlayFab, cliquez sur Configure.
6. Dans l'onglet Item import, spécifiez :
   • Title ID — l'ID du projet dans PlayFab ;
   • Secret key — la clé du projet dans PlayFab.
7. Cliquez sur Save.
8. Synchronisez l'inventaire utilisateur avec PlayFab (facultatif) :
   1. Accédez à Inventory synchronization et spécifiez :
      • Title ID — l'ID du projet dans PlayFab ;
      • Secret key — la clé du projet dans PlayFab.
   2. Réglez la bascule Synchronize user inventory with PlayFab sur On.
   3. Cliquez sur Save.
9. Accédez à l'onglet Item import et cliquez sur Start import. L'importation du catalogue démarre automatiquement.
10. 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.
11. 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 Virtual currency, Virtual items et Bundles.

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.

Étapes suivantes

1. Implémentez l'octroi des achats à l'utilisateur.
2. Implémentez l'obtention des informations d'abonnement.

Liens utiles

• Flux d'intégration
• Configuration manuelle du catalogue