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

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

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

Внимание

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

1. Откройте проект в Личном кабинете.
2. Нажмите Store в боковом меню.
3. В панели Управление каталогом нажмите Настроить.
4. В панели Интеграция с внешними платформами нажмите Настроить.
5. В панели Google Play нажмите Настроить.
6. Укажите ID приложения — ID вашего приложения в Google Play.

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

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

9. Нажмите Сохранить.
10. Нажмите Начать импорт. Импорт каталога начнется автоматически.

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

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

• ID приложения в разделе App Information.
• Ключ API и Issuer ID в разделе Users and Access.

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

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

   

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

   

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

Issuer ID в App Store Connect — это ID, который используется для взаимодействия с Apple API, включая App Store Connect API. Этот ID необходим для настройки ключей 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

1. В вашем проекте в Личном кабинете перейдите в раздел Store > Управление каталогом > Интеграция с внешними платформами > App Store.
2. Укажите данные, которые вы получили в App Store Connect:
   • ID приложения;
   • Файл с Private key; 
   • Issuer ID;
   • Key ID.
3. Нажмите Начать импорт. Импорт каталога начнется автоматически.
   
   

   

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

Если вы хотите, чтобы у товаров были изображения, отредактируйте импортированный товар в разделе Store > Виртуальные предметы.

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

PlayFab предоставляет разработчикам игр готовые серверные решения для управления каталогом и для монетизации. После интеграции сервиса PlayFab вы можете импортировать каталог из PlayFab в магазин, чтобы пользоваться решениями Xsolla.

1. Откройте проект в Личном кабинете.
2. Нажмите Store в боковом меню.
3. В панели Управление каталогом нажмите Настроить.
4. В панели Интеграция с внешними платформами нажмите Настроить.
5. В панели PlayFab нажмите Настроить.
6. На вкладке Импорт товаров укажите:
   • Title ID — ​​ID проекта в PlayFab.
   • Секретный ключ — ключ проекта в PlayFab.
7. Нажмите Сохранить.
8. Синхронизируйте инвентарь пользователя с PlayFab (опционально):
   1. Перейдите на вкладку Синхронизация инвентаря и укажите:
      • Title ID — ​​ID проекта в PlayFab.
      • Секретный ключ — ключ проекта в PlayFab.
   2. Установите переключатель Синхронизировать инвентарь пользователя с PlayFab в положение Вкл.
   3. Нажмите Сохранить.
9. Перейдите на вкладку Импорт товаров и нажмите Начать импорт. Импорт каталога начнется автоматически.
10. Если вы хотите продавать виртуальные предметы через веб-магазин, созданный с помощью Site Builder, в Личном кабинете создайте группы и укажите для каждого виртуального предмета одну или несколько групп.
11. Если вы хотите, чтобы у товаров были изображения, необходимо добавить изображения в Личном кабинете.

Чтобы проверить, успешно ли прошел импорт каталога, перейдите в раздел Store в боковом меню и убедитесь, что предметы, валюта и бандлы доступны на вкладках Виртуальная валюта, Виртуальные предметы и Бандлы.

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

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

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

Следующие шаги

1. Реализуйте начисление покупок пользователю.
2. Реализуйте получение информации о подписках.

Полезные ссылки

• Сценарий интеграции
• Настройка каталога вручную