GShare — решение, позволяющее разработчикам игр получать доход с пользователей, которые обычно не делают внутриигровые покупки. Пользователи игры устанавливают на компьютер настольное приложение, использующее ресурсы компьютера в обмен на пополнение внутриигрового баланса, который можно тратить на внутриигровые покупки. Основные возможности:
- Поддержка Microsoft Windows 10 и выше
- Кастомизация приложения под бренд игры
- Локализация пользовательского интерфейса на 20 языков — RU/EN доступны по умолчанию, для добавления других языков обратитесь к аккаунт-менеджеру проекта
- Выбор конфигурации для оптимизации ресурсов компьютера (CPU и/или GPU)
- Настройка минимального размера вознаграждения пользователю
- Прямые начисления на баланс пользователя в игре
Сценарий интеграции
Возможны следующие варианты интеграции решения:
Кастомизированное приложение
Выберите данный вариант интеграции, если вы хотите кастомизировать стандартное приложение GShare под свою игру. Вы можете разместить ссылку на сборку:
Предварительные действия
Если вы размещаете ссылку на сборку на лендинге Иксоллы, на своем лендинге или в аккаунте пользователя игры, необходимо предварительно выполнить следующие действия:
- В настройках продукта Платежи включите верификацию пользователей с помощью public user ID — идентификатора, который пользователь использует в игре и с которым будет авторизоваться в приложении GShare (например, email-адрес или никнейм).
- Настройте обработку оповещения Поиск пользователя.
Подготовка кастомизированной сборки
Обратитесь к аккаунт-менеджеру или напишите на адрес am@xsolla.com и укажите следующую информацию:
- Минимальный размер вознаграждения пользователю (соответствует стоимости единицы виртуальной валюты в настройках модуля Виртуальная валюта в Личном кабинете).
- Файл UIStyle.json с кастомизированными стилями для приложения.
- Тексты для интерфейса приложения, которые вы хотите изменить.
- Иконка приложения в формате ICO размером 32x32 px и 128x128 px.
- Изображение для экрана загрузки приложения в формате SVG.
Пример стандартного файла UIStyle.json:
{
"common": {
"background_color": "#121217",
"card_background_color": "#1b1b24",
"prime_color": "#0096d1",
"text_color": "#ffffff",
"input_color": "#2e2e3a"
}
}Описания полей:
- background_color — цвет фона приложения
- card_background_color — цвет фона блоков и диалоговых окон
- prime_color — акцентный цвет для элементов интерфейса (например, для кнопок Call-to-Action)
- text_color — цвет текста
- input_color — цвет полей ввода
Размещение ссылки на лендинге Иксоллы
Передайте аккаунт-менеджеру следующую информацию:
- Тексты для лендинга, которые вы хотите изменить. Посмотреть пример стандартного лендинга.
- URL собственного домена (опционально). По умолчанию лендинг публикуется на домене Иксоллы с URL вида <landing_name>.xsollasitebuilder.com. Для корректного отображения лендинга по вашему URL необходимо добавить запись типа CNAME со значением <landing_name>.xsollasitebuilder.com в настройках DNS вашего домена.
Размещение ссылки на своем лендинге
Подключите на лендинг следующий скрипт:
<script>
function downloadGShare() {
let partnerId = 1;
let userId = 'some_user_id';
let link = 'https://api-generator.xsolla.com/gshare-dists?partner_id=' + partnerId + '&user_login=' + userId;
window.open(link, "_top");
}
</script>
<input value="Download GShare" onclick="downloadGShare()" type="button">В параметре partner_id передается ID партнера в базе данных GShare. Обратитесь к аккаунт-менеджеру, чтобы получить информацию о partner_id.
В запросе можно дополнительно передавать ID пользователя (v1) в параметре user_login. Если параметр не передается, для скачивания приложения пользователю необходимо ввести свой public user ID.
Размещение ссылки в баннере в платежном интерфейсе
Обратитесь к аккаунт-менеджеру или напишите на адрес am@xsolla.com, чтобы включить отображение баннера GShare в платежном интерфейсе Иксоллы и настроить переход на ваш лендинг. Пользователь увидит баннер приложения на странице статуса платежа.
Размещение ссылки в аккаунте пользователя игры
Разместите в аккаунте пользователя игры следующий скрипт:
<script>
function downloadGShare() {
let partnerId = 1;
let userId = 'some_user_id';
let link = 'https://api-generator.xsolla.com/gshare-dists?partner_id=' + partnerId + '&user_login=' + userId;
window.open(link, "_top");
}
</script>
<input value="Download GShare" onclick="downloadGShare()" type="button">В параметре partner_id передается ID партнера в базе данных GShare. Обратитесь к аккаунт-менеджеру, чтобы получить информацию о partner_id.
В запросе можно дополнительно передавать ID пользователя (v1) в параметре user_login. Если параметр не передается, для скачивания приложения пользователю необходимо ввести свой public user ID.
Стандартное приложение
Выберите данный вариант интеграции, если вы используете стандартное приложение GShare с настройками по умолчанию. Размещение ссылки на сборку возможно только в баннере в платежном интерфейсе.
Баннер приложения отображается на странице статуса платежа. Когда пользователь кликает на баннер, он переходит на лендинг со ссылкой на скачивание стандартного приложения GShare. При скачивании генерируется идентификатор — Xsolla-номер, по которому после установки и запуска приложения пользователь может выбрать из списка сборку, работающую с данной игрой. Посмотреть пример интеграции.
Обратитесь к аккаунт-менеджеру или напишите на адрес am@xsolla.com чтобы включить отображение баннера GShare в платежном интерфейсе. Также передайте информацию о минимальном размере вознаграждения пользователю (соответствует стоимости единицы виртуальной валюты в настройках модуля Виртуальная валюта в Личном кабинете).