Импорт каталога товаров из внешних платформ

Вы можете импортировать товары из внешних платформ и синхронизировать инвентарь пользователя.

Импорт каталога из Google Play

Внимание

Перед началом импорта проверьте, включен ли Google Play Android Developer API в вашем проекте в Google Play. Для этого перейдите по ссылке: /apis/api/androidpublisher.googleapis.com/overview?project={project_id}, где project_id — ID вашего проекта в Google Play. Если этот API выключен, включите его. Применение настроек занимает время, поэтому сразу после включения настроек импорт может не удаться. Подождите несколько минут и повторите попытку.

Чтобы импортировать товары из Google Play:

1. В проекте в Личном кабинете перейдите в раздел LiveOps > Canvas.
2. В панели управления нажмите значок .
3. В области со списком товаров нажмите значок + и выберите пункт Import from platforms.

4. Выберите Google Play и нажмите Import.
5. Укажите Application ID — ID вашего приложения в Google Play.

Примечание

Вы можете найти ID приложения в консоли администратора Google. В боковом меню нажмите All apps. Найдите в таблице нужное приложение. Его ID будет указан в столбце App рядом с логотипом и названием.

6. Загрузите JSON-файл с приватным ключом.

7. Перейдите в Google Play Console, в боковом меню нажмите Users and permissions и добавьте сервисный аккаунт как нового пользователя с ролью Android Management User. Для этого у вас должна быть роль Project IAM admin.
8. Нажмите Start import. Импорт каталога начнется автоматически.
9. Нажмите Save.

Примечание

Артикул товара соответствует Product ID в источнике импорта.

10. Чтобы продавать товары через веб-магазин, созданный с помощью Site Builder, настройте группы товаров в Личном кабинете и назначьте одну или несколько групп каждому товару.
11. Если вы хотите, чтобы у товаров были изображения, добавьте их в настройках товаров.

Импорт каталога из App Store

Перед импортом каталога из App Store необходимо получить следующие данные:

• Application ID в разделе App Information в App Store Connect.
• Ключ API и Issuer ID в разделе Users and Access в App Store Connect.

Получение ID приложения

Чтобы получить Application ID в App Store Connect:

1. Войдите в App Store Connect.
2. Перейдите в раздел Apps.

3. Откройте страницу вашего приложения.
4. Перейдите в раздел General Information > App Information.
5. В блоке General Information скопируйте Application ID в поле Apple ID.

Получение ключа API и Issuer ID

Issuer ID в App Store Connect используется для взаимодействия с Apple API, включая App Store Connect API. Он необходим для настройки ключей API для автоматизации задач, таких как управление приложениями, загрузка данных аналитики и других операций в App Store Connect.

Ключ API — это уникальный идентификатор, который используется для аутентификации API-запросов в App Store Connect API и обеспечения безопасного доступа к данным и функциям Apple Developer Account.

Для получения Issuer ID и ключа API в App Store Connect:

1. Перейдите на сайт App Store Connect в раздел Users and Access.
2. Перейдите на вкладку Integrations.
3. В боковом меню Keys нажмите App Store Connect API.
4. Перейдите на вкладку Team Keys. Для создания ключа-API Нажмите значок +.

5. В окне Generate API Key задайте имя ключа и установите уровень доступа к этому ключу.
6. Нажмите Generate.

7. В таблице активных ключей API появится ваш ключ. Скачайте его в виде файла с расширением P8 и скопируйте Key ID.

8. На вкладке Team Keys скопируйте Issuer ID.

Импорт каталога из App Store

Чтобы импортировать товары из App Store:

1. В проекте в Личном кабинете перейдите в раздел LiveOps > Canvas.
2. В панели управления нажмите значок .
3. В области со списком товаров нажмите значок + и выберите пункт Import from platforms.

4. Выберите App Store и нажмите Import.
5. Укажите данные, которые вы получили в App Store Connect:
   • ID приложения;
   • файл с Private Key (P8);
   • Issuer ID;
   • Key ID.
6. Нажмите Start import. Импорт каталога начнется автоматически.
7. Нажмите Save.

Примечание

Артикул товара соответствует Product ID в источнике импорта.

8. Чтобы продавать товары через веб-магазин, созданный с помощью Site Builder, настройте группы товаров в Личном кабинете и назначьте одну или несколько групп каждому товару.
9. Если вы хотите, чтобы у товаров были изображения, добавьте их в настройках товаров.

Импорт каталога из PlayFab

Чтобы импортировать товары из PlayFab:

1. В проекте в Личном кабинете перейдите в раздел LiveOps > Canvas.
2. В панели управления нажмите значок .
3. В области со списком товаров нажмите значок + и выберите пункт Import from platforms.

4. Выберите PlayFab и нажмите Import.
5. Укажите данные, которые вы получили в PlayFab:
   • Title ID;
   • секретный ключ проекта.
6. Нажмите Start import. Импорт каталога начнется автоматически.
7. Нажмите Save.
8. Чтобы продавать товары через веб-магазин, созданный с помощью Site Builder, настройте группы товаров в Личном кабинете и назначьте одну или несколько групп каждому товару.
9. Если вы хотите, чтобы у товаров были изображения, добавьте их в настройках товаров.

Синхронизация инвентаря с PlayFab

Чтобы настроить синхронизацию инвентаря пользователя в Xsolla с инвентарем PlayFab:

1. В проекте в Личном кабинете перейдите в раздел LiveOps > Canvas.
2. В панели управления нажмите значок .
3. В области со списком товаров нажмите значок + и выберите пункт Import from platforms.

4. Выберите PlayFab и нажмите Import.
5. Выберите Inventory synchronization.
6. Укажите данные, которые вы получили в PlayFab:
   • Title ID;
   • секретный ключ проекта.
7. Установите переключатель Synchronize user inventory with PlayFab в активное положение.
8. Нажмите Save.

Повторный импорт каталога

При повторном импорте каталога вам необходимо учитывать следующее:

• Товары, которые уже есть в каталоге на стороне Xsolla, будут обновлены.
• Товары, которые отсутствуют в каталоге на стороне Xsolla, будут добавлены.
• Товары, которые уже были удалены из источника импорта, останутся в каталоге на стороне Xsolla. Вы можете удалить их вручную или с помощью API.