Интеграция с PlayFab

Как это работает

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

• Импорт каталога товаров из PlayFab в In-Game Store, чтобы пользоваться решениями Xsolla.
• Автоматическая передача товаров, которые пользователь приобретет через In-Game Store, в PlayFab.

Для кого подходит

• Для партнеров, у которых уже интегрирован PlayFab и которые хотят расширить область распространения товаров (виртуальной валюты, виртуальных предметов) через решения Xsolla.
• Для партнеров, которые уже используют решения Xsolla и хотят монетизировать товары в 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.

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

Ограничения на стороне In-Game Store

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

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

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

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

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

Если у вас еще не настроен PlayFab:

• Создайте PlayFab-аккаунт.
• Создайте игру.
• Получите уникальный ID игры Title ID.
• Получите PlayFab Secret key.

Перейдите в Личный кабинет и импортируйте каталог товаров из PlayFab в In-Game Store.

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

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

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

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

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

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

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

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

Если вы хотите синхронизировать инвентарь пользователя с инвентарем PlayFab:

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

Теперь информация о купленных во Внутриигровом магазине товарах будет автоматически передаваться в PlayFab.

Последнее обновление: 27 декабря 2024