Создание виртуальной валюты

Виртуальная валюта — это виртуальные деньги, которые используются для приобретения и продажи виртуальных товаров. В зависимости от использования виртуальная валюта влияет на экономический баланс игры или связана с монетизацией приложения. Также вы можете создавать премиум-валюту — виртуальную валюту, которая привязана к платформе, где осуществляется покупка. Премиум-валюта продается только за реальную валюту.

Вы можете продавать виртуальную валюту в заранее установленном количестве — пакетами. Цена пакета валюты задается отдельно и может отличаться от стандартной цены аналогичного количества этой же валюты.

Подробная информация о виртуальной валюте и ее видах доступна в разделе Виртуальная валюта.

Чтобы создать виртуальную валюту:

1. В проекте в Личном кабинете перейдите в раздел Каталог товаров > Виртуальная валюта.
2. Нажмите Новая виртуальная валюта.
3. Добавьте:
   • изображение (опционально);
   • артикул;
   • название;
   • цены в реальной и (или) виртуальной валюте;
   • валюту по умолчанию;
   • атрибут (опционально).

4. Вы можете определить виртуальную валюту как премиум-валюту. Это валюта, которая привязана к платформе, где осуществляется покупка, и которая продается только за реальную валюту. Чтобы настроить хранение премиум-валюты раздельно по платформам, установите переключатель Премиум-валюта в положение Вкл.

Создание пакета виртуальной валюты

Чтобы создать пакет виртуальной валюты:

1. В проекте в Личном кабинете перейдите в раздел Каталог товаров > Виртуальная валюта > Пакеты.
2. Нажмите Новый пакет.

3. Добавьте:
   • изображение пакета (опционально);
   • артикул пакета;
   • название пакета;
   • краткое описание пакета;
   • виртуальную валюту в составе пакета;
   • цены пакета в реальной и (или) виртуальной валюте;
   • валюту по умолчанию;
   • атрибут (опционально).

4. Чтобы задать ограничение на покупку пакетов виртуальной валюты, установите переключатель Ограничивать покупку пакетов виртуальной валюты пользователем в положение Вкл и и укажите количество, доступное для покупки пользователем.
5. Чтобы установить ограничение времени отображения пакета в магазине, в поле Показывать предмет в магазине выберите Период времени и укажите часовой пояс, начало и конец периода. Чтобы не указывать конец периода отображения пакета, установите флажок Без даты окончания.
6. Проверьте настройки и нажмите Создать пакет.

Создание виртуальных предметов

Виртуальные предметы — это внутриигровой контент, который можно продавать за реальную или виртуальную валюту.

Виртуальные предметы делятся на три типа:

• Расходуемые — предметы, которые можно начислить или купить множество раз. После использования их количество уменьшается.
• Нерасходуемые — предметы, которые можно начислить или купить только один раз. Они хранятся в инвентаре пользователя в единственном экземпляре и могут быть изъяты из инвентаря только серверным методом.
• Предмет с ограниченным сроком действия — нерасходуемый предмет, у которого есть период доступности. По окончании этого периода предмет становится неактивным в инвентаре пользователя. Пользователь должен купить предмет снова, чтобы активировать его.

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

Перед настройкой виртуальных предметов создайте группы. Группы позволяют создавать многоуровневый каталог, а также управлять отображением предметов в магазине.

Чтобы создать группу:

1. В проекте в Личном кабинете перейдите в раздел Каталог товаров > Виртуальные предметы.
2. Нажмите + и в раскрывающемся списке выберите Создать группу.

3. Задайте необходимые параметры:
   • код группы;
   • название группы.
4. Если вы хотите, чтобы группа отображалась в каталоге, установите переключатель Показывать группу в магазине в положение Вкл.

5. Нажмите Создать группу.

Чтобы создать виртуальный предмет:

1. В проекте в Личном кабинете перейдите в раздел Каталог товаров > Виртуальные предметы.
2. Нажмите + и в раскрывающемся списке выберите Создать предмет.

3. Укажите:
   • изображение (опционально);
   • артикул;
   • одну или несколько групп, которым должен принадлежать предмет;
   • название предмета;
   • описание предмета (опционально);

• свойство предмета — расходуемый, нерасходуемый или непродлеваемая подписка;
• цены в реальной и виртуальной валюте.

4. Чтобы задать ограничение на покупку предмета (опционально). Для этого установите переключатель Ограничивать покупку предметов пользователем в положение Вкл и и укажите количество, доступное для покупки пользователем.
5. Чтобы установить ограничение времени отображения предмета в магазине, в поле Показать предмет в магазине выберите Период времени и укажите часовой пояс, начало и конец периода. Чтобы не указывать конец периода отображения предмета, установите флажок Без даты окончания.
6. Проверьте настройки и нажмите Создать предмет.

Создание бандлов

Бандл — это комплект, состоящий из нескольких товаров, которые продаются как единое целое. Вы можете добавить в состав бандла товары следующих типов:

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

Подробная информация о бандлах доступна в разделе Бандлы.

Чтобы создать бандл:

1. В проекте в Личном кабинете перейдите в раздел Каталог товаров > Бандлы.
2. Нажмите + и в раскрывающемся списке выберите пункт Создать бандл.

3. Добавьте:
   • изображение (опционально);
   • артикул;
   • название бандла;
   • описание бандла (опционально);
   • содержимое бандла.
4. Настройте цену бандла. Задайте цены или создайте бесплатный бандл:
   1. Чтобы создать бесплатный бандл, в поле Платно или бесплатно выберите Бесплатный бандл.
   2. Чтобы задать цену, в поле Платно или бесплатно выберите Платный бандл и укажите цену в одной или нескольких валютах в реальной или виртуальной валютах. При необходимости настройте региональные цены.

5. Задайте ограничение на покупку бандла (опционально). Для этого установите переключатель Ограничивать покупку бандлов пользователем в положение Вкл и укажите количество бандлов, доступное для покупки пользователем.
6. Нажмите Далее.
7. Настройте отображение бандла в магазине:
   • Измените статус на Доступен.
   • Настройте ограничение времени отображения бандлов (опционально). Для этого выберите пункт Период времени и укажите часовой пояс, начало и конец периода. Чтобы не указывать конец периода отображения бандла, установите флажок Без даты окончания.
8. Нажмите Далее.
9. Проверьте настройки и нажмите Сохранить.

Вы можете автоматизировать создание и обновление каталога, используя методы Shop Builder API. Благодаря автоматизации вы сможете поддерживать каталог в актуальном состоянии, не тратя на это много времени. Автоматизация каталога позволяет создавать и обновлять товары и акции и импортировать данные из внешних систем.

Методы API создания и обновления товаров и акций требуют базовой аутентификации. Передайте в запросе параметр Authorization:Basic <your_authorization_basic_key>, где <your_authorization_basic_key> — пара ID продавца:ключ API, закодированная по стандарту Base64. Значения параметров вы можете найти в Личном кабинете:

• ID продавца указан:
  • В разделе Настройки компании > Компания.
  • Aдресной строке браузера на любой странице Личного кабинета. URL-адрес имеет вид https://publisher.xsolla.com/<merchant_id>/.

• Ключ API отображается в Личном кабинете только при создании и должен храниться на вашей стороне. Создать ключ можно в разделах:
  • Настройки компании > Ключи API;
  • Настройки проекта > Ключи API.

Чтобы создать товары с помощью API:

1. Выгрузить данные о товарах из вашей системы.
2. Преобразуйте выгруженные данные в формат, который соответствует формату данных в методе API нужного типа товара.
3. Создайте скрипт, который для каждого товара в выгрузке вызовет нужный метод API:
   • Создание виртуального предмета — для виртуальных предметов.
   • Создание виртуальной валюты — для виртуальной валюты.
   • Создание пакета виртуальной валюты — для пакетов виртуальной валюты.
   • Создание бандла — для бандлов.

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

1. Откройте проект в Личном кабинете и в разделе Каталог товаров перейдите к типу товаров, которые вы хотите настроить:
   • Виртуальная валюта
   • Виртуальные предметы
   • Игровые ключи
   • Бандлы
2. В раскрывающемся списке Управление каталогом нажмите Импортировать товары (JSON).

3. Выберите нужное действие:
   • Добавить новые товары — будут добавлены только товары с новыми артикулами.
   • Добавить новые товары и обновить существующие — будут добавлены товары с новыми артикулами и обновлены данные существующих товаров.
   • Добавить новые, обновить существующие и отключить недостающие товары — товары с артикулами из файла будут добавлены/обновлены. Если товар есть в каталоге, но товара с таким артикулом нет в файле, статус товара в Личном кабинете будет изменен на Частично доступен. Такой товар нельзя приобрести отдельно, но он доступен в составе бандла или в качестве бонуса.

4. Заполните файл для импорта:
   • Скачайте шаблон файла в окне загрузки и заполните его по примеру ниже.
   • Сделайте экспорт товаров и используйте экспортированный файл как шаблон.
   • Создайте свой JSON-файл и заполните его по примеру ниже.

Пример заполненного JSON-файла:

  1{
  2    "virtual_currency": [
  3        {
  4            "sku": "Gem_test_import",
  5            "name": {
  6                "en": "Gem_test_import"
  7            },
  8            "type": "virtual_currency",
  9            "description": {
 10                "en": "my test imported currency"
 11            },
 12            "image_url": "https://cdn3.xsolla.com/img/misc/merchant/default-dc-image.png",
 13            "description": {
 14                "en": "my test imported currency",
 15                "de": "meine importierte Testwährung"
 16            },
 17            "attributes": [],
 18            "is_free": false,
 19            "order": 1,
 20            "groups": [],
 21            "regional_prices": [],
 22            "prices": [
 23                {
 24                    "amount": 2,
 25                    "currency": "USD",
 26                    "is_default": true,
 27                    "is_enabled": true
 28                }
 29            ],
 30            "media_list": [],
 31            "vc_prices": [],
 32            "is_enabled": true,
 33            "is_show_in_store": true,
 34            "regions": [],
 35            "limits": {
 36                "per_user": null,
 37                "per_item": null,
 38                "recurrent_schedule": null
 39            },
 40            "periods": [],
 41            "inventory_options": {
 42                "consumable": true,
 43                "expiration_period": null
 44            },
 45            "is_hard": false
 46        }
 47    ],
 48    "virtual_items": [
 49        {
 50            "sku": "event_access_test_import",
 51            "name": {
 52                "en": "Special Event Access_test_import"
 53            },
 54            "type": "virtual_good",
 55            "description": {
 56                "en": "Get special event access as a bonus only on your first purchase. Find the right doggy at the Robo-Dog Exhibition!"
 57            },
 58            "image_url": "https://cdn3.xsolla.com/img/misc/images/1e3ef1a96cc9dd8d98bc124d5d6fad79.png",
 59            "long_description": null,
 60            "attributes": [],
 61            "is_free": false,
 62            "order": 1,
 63            "groups": [
 64                "my_test_group"
 65            ],
 66            "regional_prices": [],
 67            "prices": [
 68                {
 69                    "amount": 35,
 70                    "currency": "USD",
 71                    "is_default": true,
 72                    "is_enabled": true
 73                }
 74            ],
 75            "media_list": [],
 76            "vc_prices": [],
 77            "is_enabled": true,
 78            "is_show_in_store": true,
 79            "regions": [],
 80            "limits": {
 81                "per_user": null,
 82                "per_item": null,
 83                "recurrent_schedule": null
 84            },
 85            "periods": [],
 86            "inventory_options": {
 87                "consumable": true,
 88                "expiration_period": null
 89            }
 90        }
 91    ],
 92    "virtual_currency_packages": [
 93        {
 94            "item_id": 441982,
 95            "sku": "small_gold_pack_test_import",
 96            "type": "bundle",
 97            "name": {
 98                "en": "Small gold pack"
 99            },
100            "bundle_type": "virtual_currency_package",
101            "description": {
102                "en": "Gold x100"
103            },
104            "image_url": "https://cdn3.xsolla.com/img/misc/images/ba43c46ea75fd5713c210f5736993a92.png",
105            "vc_prices": [],
106            "regional_prices": [],
107            "prices": [
108                {
109                    "amount": 5,
110                    "currency": "USD",
111                    "is_default": true,
112                    "is_enabled": true
113                }
114            ],
115            "is_enabled": true,
116            "is_show_in_store": true,
117            "regions": [],
118            "limits": {
119                "per_user": null,
120                "per_item": null,
121                "recurrent_schedule": null
122            },
123            "periods": [],
124            "attributes": [],
125            "long_description": null,
126            "media_list": [],
127            "order": 100000000,
128            "is_free": false,
129            "groups": [],
130            "content": [
131                {
132                    "sku": "Gem_test_import",
133                    "quantity": 100
134                }
135            ]
136        }
137    ],
138    "bundles": [
139        {
140            "item_id": 684024,
141            "sku": "start_pack_test_import_test_import",
142            "type": "bundle",
143            "name": {
144                "en": "Legendary Start Pack"
145            },
146            "bundle_type": "standard",
147            "description": {
148                "en": "Crystal x 1\nGem x 1"
149            },
150            "image_url": "https://cdn3.xsolla.com/img/misc/merchant/default-dc-image.png",
151            "regional_prices": [],
152            "prices": [
153                {
154                    "amount": 20,
155                    "currency": "USD",
156                    "is_default": true,
157                    "is_enabled": true
158                }
159            ],
160            "virtual_prices": [],
161            "is_enabled": true,
162            "is_show_in_store": true,
163            "regions": [],
164            "limits": {
165                "per_user": null,
166                "per_item": null,
167                "recurrent_schedule": null
168            },
169            "periods": [],
170            "attributes": [],
171            "long_description": null,
172            "media_list": [],
173            "order": 5,
174            "is_free": false,
175            "groups": [
176                "my_test_group"
177            ],
178            "content": [
179                {
180                    "sku": "Gem_test_import",
181                    "quantity": 1
182                },
183                {
184                    "sku": "event_access_test_import",
185                    "quantity": 1
186                }
187            ]
188        }
189    ]
190}

5. Загрузите заполненный файл в соответствующее поле в окне импорта.
6. Если при импорте возникнут ошибки, в окне импорта отобразится список этих ошибок и рекомендаций по исправлению. Внесите необходимые изменения в файл и загрузите его снова.

После успешной загрузки товары с указанными артикулами будут созданы, обновлены или отключены.

Вы также можете импортировать товары с помощью метода API Импорт товаров из JSON-файла.

Если вы создаете сайт с помощью шаблона Web Shop или Магазин игр, блок добавляется на сайт автоматически.

Если вы создаете сайт с помощью других шаблонов, чтобы добавить блок Магазин на сайт:

1. В проекте в Личном кабинете перейдите в раздел Каналы продаж > Веб-сайты.
2. Нажмите Открыть Site Builder.

3. Нажмите Добавить блок в шаблоне сайта.
4. В списке выберите блок Магазин.

5. В раскрывающемся списке выберите тип и группу товара, который вы хотите продавать на сайте.

6. Чтобы продавать разные типы товаров, добавьте разделы магазина. Для этого в меню блока Магазин нажмите Добавить раздел магазина.
7. Чтобы продавать товары в разных частях сайта, добавьте дополнительные блоки Магазин.

Вы можете добавить кнопку для быстрой продажи товаров в любом шаблоне в блоках:

• Карточки;
• Хедер;
• Call-to-action;
• Игровые издания;
• Рекламный слайдер.

В шаблоне Страница игры кнопка также располагается в блоке Заглавный блок.

Чтобы настроить кнопку:

1. Перейдите к одному из указанных блоков.
2. В правой части конструктора сайтов перейдите к кнопке.
3. В раскрывающемся списке Действие выберите Купить товар.
4. В раскрывающемся списке Предмет выберите товар.