Importer le catalogue des objets depuis des plateformes externes

Vous pouvez importer des objets depuis des plateformes externes et synchroniser l’inventaire utilisateur.

Importer le catalogue depuis Google Play

Avis

Avant de commencer l’importation, vérifiez que l’API Google Play Android Developer est activée dans votre projet Google Play. Visitez /apis/api/androidpublisher.googleapis.com/overview?project={project_id}, où project_id — votre ID de projet dans Google Play. Si cette API est désactivée, activez-la. Les paramètres prendront du 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.

Pour importer des objets depuis Google Play :

1. Dans votre projet dans le Compte éditeur, allez dans la section LiveOps > Canvas.
2. Dans la barre d’outils, cliquez sur l’icône  .
3. Dans la zone de liste des objets, cliquez sur l’icône + et sélectionnez Import from platforms.

4. Sélectionnez Google Play et cliquez sur Import.
5. Spécifiez l’Application ID — l’ID de votre application depuis Google Play.

Note

Vous pouvez trouver l’ID d’application sur la Google Play Console. Dans le menu latéral, cliquez sur All apps. Trouvez l’application nécessaire dans le tableau. Son ID sera spécifié dans la colonne App, à côté du nom et du logo.

6. Téléchargez le JSON avec une clé privée.

7. Allez sur la 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 de Android Management User. Cela nécessite que vous ayez le rôle de Project IAM admin.
8. Cliquez sur Start import. L’importation du catalogue commencera automatiquement.
9. Cliquez sur Save.

Note

SKU correspond à l’ID du produit dans la source d’importation.

10. Pour vendre des objets dans le magasin web créé par Site Builder, configurez des groupes d’objets dans le Compte éditeur et assignez un ou plusieurs d’entre eux à chaque objet.
11. Pour afficher les images des objets, téléchargez-les dans votre Compte éditeur.

Importer le catalogue depuis l’App Store

Avant d’importer un catalogue depuis l’App Store, vous devez obtenir les données suivantes :

• ID d’application depuis la section App Information dans App Store Connect.
• Clé API et ID de l’émetteur depuis la section Users and Access dans App Store Connect.

Obtenir l'ID de l'application

Pour obtenir votre ID d’application dans App Store Connect :

1. Connectez-vous à App Store Connect.
2. Allez dans la section Apps.

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

Obtenir la clé API et l'Issuer ID

L’ID de l’émetteur dans App Store Connect est utilisé pour interagir avec l’API Apple, y compris l’API App Store Connect. Il est requis pour configurer les clés API afin d’automatiser des tâches telles que la gestion des applications, la récupération de données analytiques et d’autres opérations dans App Store Connect.

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

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

1. Connectez-vous à App Store Connect et allez dans la section Users and Access.
2. Ouvrez l’onglet Integrations.
3. Dans le menu latéral Keys, cliquez sur App Store Connect API.
4. Allez dans 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 le niveau d’accès pour cette clé.
6. Cliquez sur Generate.

7. La nouvelle clé créée apparaîtra dans la liste des clés API actives. Téléchargez-la sous forme de fichier P8 et copiez l’ID de la clé.

8. Dans l’onglet Team Keys, copiez l’ID de l’émetteur.

Importer un catalogue depuis App Store

Pour importer des objets depuis l’App Store :

1. Dans votre projet dans le Compte éditeur, allez dans la section LiveOps > Canvas.
2. Dans la barre d’outils, cliquez sur l’icône  .
3. Dans la zone de liste des objets, cliquez sur l’icône + et sélectionnez Import from platforms.

4. Sélectionnez App Store et cliquez sur Import.
5. Fournissez les données que vous avez obtenues dans App Store Connect :
   • ID d’application
   • Fichier de clé privée (P8)
   • ID de l’émetteur
   • ID de la clé
6. Cliquez sur Start import. L’importation du catalogue commencera automatiquement.
7. Cliquez sur Save.

Note

SKU correspond à l’ID du produit dans la source d’importation.

8. Pour vendre des objets dans le magasin web créé par Site Builder, configurez des groupes d’objets dans le Compte éditeur et assignez un ou plusieurs d’entre eux à chaque objet.
9. Pour afficher les images des objets, téléchargez-les dans votre Compte éditeur.

Importer le catalogue depuis PlayFab

Pour importer des objets depuis PlayFab :

1. Dans votre projet dans le Compte éditeur, allez dans la section LiveOps > Canvas.
2. Dans la barre d’outils, cliquez sur l’icône  .
3. Dans la zone de liste des objets, cliquez sur l’icône + et sélectionnez Import from platforms.

4. Sélectionnez PlayFab et cliquez sur Import.
5. Entrez les données que vous avez obtenues dans PlayFab :
   • Title ID
   • Clé secrète du projet
6. Cliquez sur Start import. L’importation du catalogue commencera automatiquement.
7. Cliquez sur Save.
8. Pour vendre des objets dans le magasin web créé par Site Builder, configurez des groupes d’objets dans le Compte éditeur et assignez un ou plusieurs d’entre eux à chaque objet.
9. Pour afficher les images des objets, téléchargez-les dans votre Compte éditeur.

Synchroniser l’inventaire avec PlayFab

Pour synchroniser l’inventaire d’un utilisateur dans Xsolla avec son inventaire dans PlayFab :

1. Dans votre projet dans le Compte éditeur, allez dans la section LiveOps > Canvas.
2. Dans la barre d’outils, cliquez sur l’icône  .
3. Dans la zone de liste des objets, cliquez sur l’icône + et sélectionnez Import from platforms.

4. Sélectionnez PlayFab et cliquez sur Import.
5. Sélectionnez Inventory synchronization.
6. Entrez les données que vous avez obtenues dans PlayFab :
   • Title ID
   • Clé secrète du projet
7. Activez la bascule Synchronize user inventory with PlayFab.
8. Cliquez sur Save.

Réimporter le catalogue

Lors de la réimportation du catalogue, vous devez prendre en compte que :

• Les objets déjà présents dans le catalogue Xsolla seront mis à jour.
• Les objets non présents dans le catalogue Xsolla seront ajoutés.
• Les objets qui ont été supprimés de la source d’importation resteront dans le catalogue Xsolla. Vous pouvez les supprimer manuellement ou via API.