How to import catalog

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 In-Game Store for using Xsolla solutions.

Note
To work with PlayFab, you’ll need a project ID and a secret project key in PlayFab.

  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 Connectors pane, click Configure.
  5. In the PlayFab pane, click Configure.
  6. Go to the Import tab and specify:
  7. Click Save.
  8. Go to the Delivery tab and specify:
  9. Click Save.
  10. Go to the Common tab and set the Import disabled and Delivery disabled togglers to ON.
  11. Click Start import. Catalog import will start automatically.

Note
There is no progress bar for the import process.

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.

Import catalog from App Store

  1. Add the Xsolla user with the Marketing role.
  2. Get Application ID.
  3. Import catalog from the App Store.

Add the Xsolla user with the Marketing role

Before importing a catalog from the App Store, you need to add the Xsolla user with the Marketing role to your Apple account.

  1. Log in to App Store Connect.
  2. Go to the Users and Access section.

  1. Click the + icon.
  2. Set up parameters:
    • First name and Last name — This is arbitrary, enter anything you want.
    • Email — Enter igs@xsolla.com.
    • Roles — Select Marketing.
    • Apps — Specify the app you want to import the catalog for (optional).

  1. Click Invite.

Get Application ID

To get your application ID in App Store Connect:

  1. Go to App Store Connect.
  2. Go to the My Apps section.

  1. Open your app’s page.
  2. Go to General > App information.
  3. In the General Information block, copy application ID under Apple ID title.

  1. Click Save.

Import catalog from App Store

  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 Connectors pane, click Configure.
  5. In the App Store pane, click Configure.
  6. Go to the Import tab.
  7. Specify Application ID — your app’s ID from App Store Connect.
  8. Go to the Common tab and set the Import disabled and Delivery disabled toggles to On.
  9. Click Start import. Catalog import will begin immediately.

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

Note
There is no progress bar for the import process. SKU corresponds to Product ID in the source of import.

Import catalog from Google Play

  1. Open your project in Publisher Account.
  2. Click Store in the side menu.
  3. In the Catalog Management pane, click Configure.
  4. In theConnectors pane, click Configure.
  5. In the Google Play pane, click Configure.
  6. Go to the Import tab.

  1. Specify Application ID — your app’s ID from Google Play.

Note
You can find Application ID on the Google Play Console in the All apps side menu > application’s grid.

  1. Upload JSON with a private key.

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

  1. Go to the Common tab and set the Import disabled and Delivery disabled toggles to On.
  2. Click Start import. Catalog import will begin immediately.

Note
SKU corresponds to Product ID in the source of import.

  1. 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.
  2. 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
Rate this page
Is there anything we can improve?

Don’t want to answer

Thank you for your feedback!
Last updated: December 28, 2021

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

Report a problem
We always review our content. Your feedback helps us improve it.
Provide an email so we can follow up
Thank you for your feedback!