Региональные ограничения продаж

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

Региональные ограничения на продажу игр позволяют:

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

Вы можете регулировать продажу игр в зависимости от отдельных стран или групп стран.

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

Для подключения опции обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com. По каждой платформе, для которой необходимо настроить региональные ограничения, вам потребуется следующая информация:

  • Тип ограничения:
    • на активацию — ключ может быть активирован только в определенных странах;
    • на запуск — ключ может быть активирован в любой стране, игра может быть запущена только в определенных странах;
    • на активацию и на запуск — активация ключа и запуск игры могут быть выполнены только в определенных странах.
  • Список групп стран, для которых стоимость ключа будет отличаться от базовых настроек.
  • Настройки для каждой группы стран:
    • Название группы.
    • Артикул — уникальный ID группы.
    • Список цен в разных валютах. Обязательно укажите цену в валюте, выбранной по умолчанию. Подробная информация о настройке региональных цен в реальной валюте приведена в документации.
    • Список стран, входящих в группу. Подробная информация о региональных ограничениях продаж приведена в документации.
  • Список стран, для которых продажа ключей должна быть запрещена (при необходимости).

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

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

Сценарий интеграции

Чтобы настроить региональные ограничения:

  1. Создайте регионы, в которых будет доступен пакет игровых ключей, с помощью метода API Создание региона.

Примечание
Код страны указывается в формате ISO 3166-1 alpha-2. Перед загрузкой CSV-файла проверьте список поддерживаемых Xsolla стран.

  1. Добавьте ID региона в массив regions с помощью методов API категории Admin группы Игровые ключи во время создания игры.

Пример запроса:

Copy
Full screen
Small screen
1"regions": [{
2     “id”: “123”
3  }, {
4     “id”: “456”
5  }
6]

Пирмер:

  1. Создайте регион Северная Америка, включающий в себя США и Канаду.

Copy
Full screen
Small screen
1{
2  "name": {
3     "en-US": "North America",
4   },
5  "countries": ["US", "CA"]
6}
  1. Добавьте ID региона в массив regions во время обновления артикула существующей игры с помощью метода API Обновление игры по артикулу.
Теперь игра доступна только пользователям из региона Северная Америка, включающего США и Канаду.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Последнее обновление: 3 июня 2025

Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

Сообщите о проблеме
Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
Укажите email-адрес, чтобы мы могли связаться с вами
Спасибо за обратную связь!
Не получилось отправить ваш комментарий
Попробуйте еще раз позже или напишите нам на doc_feedback@xsolla.com.