Import item catalog from external platforms

You can import items and subscriptions from external platforms and synchronize user inventory.

Import catalog from Google Play

Notice

Before you start importing, check that Google Play Android Developer API is enabled in your Google Play project. Visit https://console.developers.google.com/apis/api/androidpublisher.googleapis.com/overview?project={project_id}, where project_id — your project ID in Google Play. If this API disabled, enable it. The settings will take time to apply, so the import may fail if you try immediately after enabling the settings. Wait a few minutes and retry.

1. Open your project in Publisher Account.
2. Click Store in the side menu.
3. In the Catalog Management pane, click Configure.
4. In the Integration with external platforms pane, click Configure.
5. In the Google Play pane, click Configure.
6. Specify Application ID — your app’s ID from Google Play.

7. Upload JSON with a private key.

8. Go to the Google Play Console, in the side menu click Users and permissions and add service account as a new user with the role of Android Management User. This requires you to have the Project IAM admin role.

9. Click Save.
10. Click Start import. Catalog import will begin immediately.

11. To sell virtual items in the web store created by Site Builder, configure item groups in Publisher Account and assign one or more of them to each item.
12. To display item images, upload them to your Publisher Account.

Import catalog from App Store

• Application ID from the App Information section in App Store Connect.
• API Key and Issuer ID from the Users and Access section in App Store Connect.

Get Application ID

1. Log in to App Store Connect.
2. Go to the Apps section.
   
   

   

3. Open your application’s page.
4. Navigate to General Information > App Information.
5. In the General Information copy Application ID in Apple ID field.
   
   

   

Get API Key and Issuer ID

Issuer ID in App Store Connect is used for interaction with Apple API, including the App Store Connect API. It is required for setting up API keys to automate tasks such as app management, analytics data retrieval, and other operations in App Store Connect.

API Key is a unique identifier used to authenticate API requests in App Store Connect API and ensure secure access to Apple Developer Account data and functionality.

To get the Issuer ID and API Key in App Store Connect:

1. Log in to App Store Connect and go to the Users and Access section.
2. Open the Integrations tab.
3. In the side menu Keys click App Store Connect API.
4. Go to the Team Keys tab. Click the + icon to create a new API key.
   
   

   

5. In the Generate API Key window, assign a name to the key and set the access level for this key.
6. Click Generate.
   
   

   

7. The newly created key will appear in the list of active API keys. Download it as a P8 file and copy the Key ID.
   
   

   

8. In the Team Keys tab, copy the Issuer ID.
   
   

   

Import a catalog from the App Store

1. Open your Publisher Account and go to Store > Catalog management > Integration with external platforms > App Store.
2. Provide the data got in App Store Connect:
   • Application ID
   • Private key file (P8)
   • Issuer ID
   • Key ID.
3. Click Start import. The catalog import will begin automatically.
   
   

   

To sell virtual items in the web store created using Site Builder, create item groups in your Publisher Account and assign one or more groups to each virtual item.

To display item images, you need to upload them by editing the imported item in Store > Virtual Items.

Import catalog from PlayFab

PlayFab offers game developers ready-to-use server solutions to manage catalogs and monetization. After integration with PlayFab, you can import a catalog from PlayFab to Store for using Xsolla solutions.

1. Open your project in Publisher Account.
2. Click Store in the side menu.
3. In the Catalog Management pane, click Configure.
4. In the Integration with external platforms pane, click Configure.
5. In the PlayFab pane, click Configure.
6. In the Item import tab specify:
   • Title ID — project ID in PlayFab.
   • Secret key — the key of the project in PlayFab.
7. Click Save.
8. Synchronize user inventory with PlayFab (optionally):
   1. Go to the Inventory synchronization and specify:
      • Title ID — project ID in PlayFab.
      • Secret key — the key of the project in PlayFab.
   2. Set the Synchronize user inventory with PlayFab toggle to On.
   3. Click Save.
9. Go to the Item import tab and click Start import. Catalog import will start automatically.
10. To sell virtual items in the web store created by Site Builder, configure item groups in Publisher Account and assign one or more of them to each item.
11. To display item images, upload them to your Publisher Account.

To check if the import completed successfully, go to the Store section in the side menu and make sure that items, currency, and bundles are enabled on the Virtual currency, Virtual items, and Bundles tabs.

Reimport catalog

When reimporting the catalog, you need to consider that:

• Items that are already in the Store will be updated.
• Items that are not available in the Store will be added.
• Items that have already been removed from the source of import will remain in the Store. You can delete them in your Publisher Account or via API.

Next steps

1. Implement granting of purchases to the user.
2. Implement getting subscription information.

Useful links

• Integration flow
• Set up catalog manually