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

Общая информация

Вы можете импортировать товары из внешних платформ и синхронизировать каталоги. Если импорт каталога невозможен, настройте каталог товаров и подписок в Личном кабинете или с помощью методов API.

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

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

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

Настройка в Google Play

Перед началом импорта:

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

2. Создайте приватный ключ для аутентификации:

1. Откройте ваш аккаунт в Google Cloud Console.
2. Перейдите в ваш сервисный аккаунт, который вы используете для работы с Google Cloud API. Если у вас нет этого аккаунта, создайте его.
3. Создайте приватный ключ в формате JSON, следуя инструкции.

3. Добавьте ваш сервисный аккаунт как нового пользователя в аккаунт Google Play Console и выдайте ему разрешение на просмотр информации о приложении.

Настройка в Личном кабинете

1. В проекте в Личном кабинете перейдите в раздел Каталог товаров > Импорт каталога > Google Play.
2. В поле ID приложения укажите ID вашего приложения из Google Play Console.

3. Загрузите JSON-файл с приватным ключом.
4. Нажмите Начать импорт. Импорт каталога начнется автоматически.

После окончания импорта вы можете проверить товары в общем списке в Личном кабинете.

Особенности товаров, импортированных из Google Play:

• Товары будут добавлены в группу Imported. Чтобы продавать их через веб-магазин, созданный с помощью конструктора сайтов Xsolla, вам необходимо перенести их группы, которые вы настроили для продажи товаров.
• Если вы хотите, чтобы у товаров были изображения, загрузите их в Личном кабинете или через API.
• Для пользователей из Бангладеш цены в каталоге будут отображаться не в валюте BDT, а в базовой валюте USD.
• Артикул товара соответствует Product ID в источнике импорта.

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

Глоссарий

ID приложения

Apple ID приложения. Чтобы его найти:

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

Issuer ID

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

Чтобы найти значение ID в вашем аккаунте в App Store Connect:

1. Перейдите в раздел Users and access.
2. Перейдите на вкладку Integrations.
3. В боковом меню Keys нажмите App Store Connect API.
4. Перейдите на вкладку Team keys.

Ключ API

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

Для импорта каталога вам понадобятся файл ключа в формате P8 и его ID. Вы можете найти эти данные в вашем аккаунте в App Store Connect:

1. Перейдите в раздел Users and access.
2. Перейдите на вкладку Integrations.
3. В боковом меню Keys нажмите App Store Connect API.
4. Перейдите на вкладку Team keys.
5. В строке необходимого ключа вы можете скопировать его ID и скачать файл.

Настройка в Личном кабинете

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

После окончания импорта вы можете проверить товары в общем списке в Личном кабинете.

Особенности товаров, импортированных из App Store:

• Товары будут добавлены в группу Imported. Чтобы продавать их через веб-магазин, созданный с помощью конструктора сайтов Xsolla, вам необходимо перенести их группы, которые вы настроили для продажи товаров.
• Если вы хотите, чтобы у товаров были изображения, загрузите их в Личном кабинете или через API.
• Импортированные товары отображаются в статусе Частично доступно. Чтобы товары отображались в магазине, поменяйте их статус на Доступно.
• Артикул товара соответствует Product ID в источнике импорта.

Импорт каталога и синхронизация с инвентарем PlayFab

Правила импорта

При импорте товаров из PlayFab применяется следующая логика:

• Нерасходуемые предметы (durable goods) из PlayFab импортируются как виртуальные предметы (не виртуальная валюта и не бандлы).
• Все товары, а также пакеты виртуальной валюты и товары внутри PlayFab бандла, импортируются как потребляемые (параметр consumable = true или не передается).
• Виртуальная валюта импортируется в статусе Частично доступно и без указания цены (состояние флагов для API: “is_show_in_store”: false, “is_enabled”: true, “is_free”: true).
• Бандл, содержащий только виртуальную валюту одного типа, импортируется как пакет виртуальной валюты.
• Бандл, содержащий только виртуальную валюту нескольких типов, импортируется в виде нескольких пакетов виртуальной валюты. Для каждой уникальной комбинации артикула и количества создается отдельный бесплатный пакет виртуальной валюты со статусом Частично доступно (состояние флагов для API: “is_show_in_store”: false, “is_enabled”: true, “is_free”: true).
• Бандл, содержащий разные типы товаров импортируется как бандл.
• Если в PlayFab для товара не заполнено поле Description, в качестве описания товара используется Name; если нет Name, используется SKU.

Ограничения при импорте

Ограничения на стороне Xsolla

• Контейнеры и бандлы, содержащие контейнеры, не импортируются.
• DropTables и бандлы, содержащие DropTables, не импортируются.
• Игнорируются параметры, специфичные для PlayFab: isStackable, isTradable, UsageCount, UsagePeriod, UsagePeriodGroup.
• Расходуемые предметы создаются без учета количества использований (предмет исчезает из инвентаря после первого использования).

Ограничения на стороне PlayFab

• PlayFab не хранит цены в реальных валютах. Используется только предустановленная виртуальная валюта с кодом RM (Real money), которая приравнивается к реальной валюте — 1 цент (100 RM = 1 USD). Поэтому у товара можно задать цену либо в виртуальной валюте, либо в RM.
• Артикулы товаров должны быть уникальными и содержать только цифры, латинские буквы, подчеркивания и дефисы.

Как настроить

Настройка в Личном кабинете

Предварительные действия в PlayFab:

• Создайте аккаунт в PlayFab.
• Создайте игру.
• Получите уникальный ID игры.
• Получите секретный ключ PlayFab.

Чтобы импортировать каталог:

1. В проекте в Личном кабинете перейдите в раздел Каталог товаров > Импорт каталога > PlayFab.
2. На вкладке Импорт товаров укажите:
   • Title ID — ​​ID проекта в PlayFab.
   • Секретный ключ — ключ проекта в PlayFab.
3. Нажмите Начать импорт. Импорт каталога начнется автоматически.

После окончания импорта вы можете проверить товары в общем списке в Личном кабинете.

Особенности товаров, импортированных из PlayFab:

• Товары будут добавлены в группу Imported. Чтобы продавать их через веб-магазин, созданный с помощью конструктора сайтов Xsolla, вам необходимо перенести их группы, которые вы настроили для продажи товаров.
• Если вы хотите, чтобы у товаров были изображения, загрузите их в Личном кабинете или через API.
• Пакетом виртуальной валюты считается бандл, который содержит в себе только одну валюту. PlayFab использует виртуальную валюту RM (Real money), эквивалентную 1 центу USD (100 RM = 1 USD). Например, если вы импортируете из PlayFab 400 RM, в Личном кабинете вы увидите 4 USD.
• Импортированные товары отображаются в статусе Частично доступно. Чтобы товары отображались в магазине, поменяйте их статус на Доступно.
• Артикул товара соответствует Item ID в источнике импорта.

Начисление товаров в инвентарь PlayFab

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

• Через синхронизацию инвентаря Xsolla с PlayFab.
• Через интеграцию хранилища пользователей PlayFab с Xsolla Login. В этом случае в токене указывается ID пользователя PlayFab. В случае возврата товара на стороне Xsolla в токене отправляется соответствующий запрос в PlayFab.

Чтобы синхронизировать инвентарь Xsolla с PlayFab:

1. В проекте в Личном кабинете перейдите в раздел Каталог товаров > Импорт каталога > PlayFab.
2. На вкладке Синхронизация инвентаря укажите:
   • Title ID — ​​уникальный ID игры в PlayFab.
   • Секретный ключ — ключ проекта в PlayFab.
3. Активируйте переключатель Включите синхронизацию инвентаря пользователя с PlayFab. Настройка применится автоматически.

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

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

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