Catalog import

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.

Note

You’ll need a project ID and a secret project key in PlayFab. Also, the catalog you want to import to Xsolla, should be set up in PlayFab as basic (Base).

Open your project in Publisher Account.
Click Store in the side menu.
In the Catalog Management pane, click Configure.
In the Integration with external platforms pane, click Configure.
In the PlayFab pane, click Configure.
In the Item import tab specify:
- Title ID — project ID in PlayFab.
- Secret key — the key of the project in PlayFab.
Click Save.
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.
Go to the Item import tab and click Start import. Catalog import will start automatically.
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.
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.

Notice

When you check the import results, please consider that a virtual currency package is a bundle containing only one currency. PlayFab uses virtual currency RM (Real money) which is equivalent to real currency — 1 cent (100 RM = 1 USD). For example, if you import 400 RM from PlayFab, you will see 4 USD in your Publisher Account.

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

Note

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

Upload JSON with a private key.

Note

A private key is generated when you create your service account.

Go to the Google Play Console, in the side menu click Users and permissions and add service account as a new user.

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

Note

SKU corresponds to Product ID in the source of import.

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

Note

For Bangladesh users, catalog prices will be displayed in the default currency (USD), rather than in BDT.

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.

Was this article helpful?

Thank you!

Is there anything we can improve? Message

We’re sorry to hear that

Please explain why this article wasn’t helpful to you. Message

Thank you for your feedback!

We’ll review your message and use it to help us improve your experience.

Rate this page

Is there anything we can improve?

Don’t want to answer

Thank you for your feedback!

Last updated: January 22, 2024

Found a typo or other text error? Select the text and press Ctrl+Enter.

Your browser is not supported. Please try a different browser

Payments

Catalog import

Reimport catalog

Was this article helpful?

Rate this page

Thank you for your feedback!