Import item catalog from external platforms

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

Import catalog from Google Play

注意

Before you start importing, check that Google Play Android Developer API is enabled in your Google Play project. Visit /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.

To import items from Google Play:

1. In your project in Publisher Account, go to the LiveOps > Canvas section.
2. In the control panel, click the  icon.
3. In the item list area, click the + icon and select Import from platforms.

4. Select Google Play and click Import.
5. Specify Application ID — your application’s ID from Google Play.

注：

You can find Application ID on the Google Play Console. In the side menu, click All apps. Find the needed application in the table. Its ID will be specified in the App column, next to the name and logo.

6. Upload JSON with a private key.

7. Go to the Google Play Console, in the side menu, click Users and permissions and add a service account as a new user with the role of Android Management User. This requires you to have the Project IAM admin role.
8. Click Start import. The catalog import will start automatically.
9. Click Save.

注：

SKU corresponds to Product ID in the source of import.

10. To sell 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.

Import catalog from App Store

Before importing a catalog from App Store, you need to obtain the following data:

• 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

To get your Application ID in App Store Connect:

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 catalog from App Store

To import items from App Store:

1. In your project in Publisher Account, go to the LiveOps > Canvas section.
2. In the control panel, click the  icon.
3. In the item list area, click the + icon and select Import from platforms.

4. Select App Store and click Import.
5. Provide the data you got in App Store Connect:
   • Application ID
   • Private key file (P8)
   • Issuer ID
   • Key ID
6. Click Start import. The catalog import will begin automatically.
7. Click Save.

注：

SKU corresponds to Product ID in the source of import.

8. To sell 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.
9. To display item images, upload them to your Publisher Account.

Import catalog from PlayFab

To import items from PlayFab:

1. In your project in Publisher Account, go to the LiveOps > Canvas section.
2. In the control panel, click the  icon.
3. In the item list area, click the + icon and select Import from platforms.

4. Select PlayFab and click Import.
5. Enter the data you obtained in PlayFab:
   • Title ID
   • Project secret key
6. Click Start import. The catalog import will begin automatically.
7. Click Save.
8. To sell 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.
9. To display item images, upload them to your Publisher Account.

Synchronize inventory with PlayFab

To synchronize a user’s inventory in Xsolla with their inventory in PlayFab:

1. In your project in Publisher Account, go to the LiveOps > Canvas section.
2. In the control panel, click the  icon.
3. In the item list area, click the + icon and select Import from platforms.

4. Select PlayFab and click Import.
5. Select Inventory synchronization.
6. Enter the data you obtained in PlayFab:
   • Title ID
   • Project secret key
7. Set the Synchronize user inventory with PlayFab toggle to active.
8. Click Save.

Reimport catalog

When reimporting the catalog, you need to consider that:

• Items that are already in the Xsolla catalog will be updated.
• Items not present in the Xsolla catalog will be added.
• Items that have been removed from the import source will remain in the Xsolla catalog. You can delete them manually or via API.