GShare — решение, позволяющее разработчикам игр получать доход с пользователей, которые обычно не делают внутриигровые покупки. Пользователи игры устанавливают на компьютер настольное приложение, использующее ресурсы компьютера в обмен на пополнение внутриигрового баланса, который можно тратить на внутриигровые покупки. Основные возможности:

• Поддержка Microsoft Windows 10 и выше
• Кастомизация приложения под бренд игры
• Локализация пользовательского интерфейса на 20 языков — RU/EN доступны по умолчанию, для добавления других языков обратитесь к аккаунт-менеджеру проекта
• Выбор конфигурации для оптимизации ресурсов компьютера (CPU и/или GPU)
• Настройка минимального размера вознаграждения пользователю
• Прямые начисления на баланс пользователя в игре

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

Возможны следующие варианты интеграции решения:

• Кастомизированное приложение
• Стандартное приложение

Кастомизированное приложение

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

• На лендинге Иксоллы
• На своем лендинге
• В баннере в платежном интерфейсе
• В аккаунте пользователя игры

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

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

1. В настройках продукта Платежи включите верификацию пользователей с помощью public user ID — идентификатора, который пользователь использует в игре и с которым будет авторизоваться в приложении GShare (например, email-адрес или никнейм).
2. Настройте обработку оповещения Поиск пользователя.

Подготовка кастомизированной сборки

Обратитесь к аккаунт-менеджеру или напишите на адрес 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 в платежном интерфейсе. Также передайте информацию о минимальном размере вознаграждения пользователю (соответствует стоимости единицы виртуальной валюты в настройках модуля Виртуальная валюта в Личном кабинете).