GShare

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

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

Note: Для интеграции GShare необходимо подключить продукты Платежи и Buy Button с модулем Виртуальная валюта.

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

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

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

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

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

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

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

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

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

Обратитесь к аккаунт-менеджеру или напишите на адрес am@xsolla.com и укажите следующую информацию:

  • Минимальный размер вознаграждения пользователю (соответствует стоимости единицы виртуальной валюты в настройках модуля Виртуальная валюта в Личном кабинете).
  • Файл UIStyle.json с кастомизированными стилями для приложения.
  • Тексты для интерфейса приложения, которые вы хотите изменить.
  • Иконка приложения в формате ICO размером 32x32 px и 128x128 px.
  • Изображение для экрана загрузки приложения в формате SVG.

Пример стандартного файла UIStyle.json:

Copy
Full screen
Small screen
{
    "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 — цвет полей ввода

Info: Подготовка кастомизированной сборки приложения занимает 3-5 рабочих дней.

Передайте аккаунт-менеджеру следующую информацию:

  • Тексты для лендинга, которые вы хотите изменить. Посмотреть пример стандартного лендинга.
  • URL собственного домена (опционально). По умолчанию лендинг публикуется на домене Иксоллы с URL вида <landing_name>.xsollasitebuilder.com. Для корректного отображения лендинга по вашему URL необходимо добавить запись типа CNAME со значением <landing_name>.xsollasitebuilder.com в настройках DNS вашего домена.

Info: Подготовка лендинга осуществляется на стороне Иксоллы и занимает 3-5 рабочих дней. Для создания и публикации лендинга используется Конструктор сайтов Иксоллы.

Подключите на лендинг следующий скрипт:

Copy
Full screen
Small screen
<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 в платежном интерфейсе Иксоллы и настроить переход на ваш лендинг. Пользователь увидит баннер приложения на странице статуса платежа.

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

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

Note: Если у вас есть несколько стандартных сборок, работающих с разными играми, вы можете включить отображение баннера для всех платежных интерфейсов Иксоллы, подключенных в этих играх. Пользователь сможет скачивать и устанавливать несколько сборок и выбирать игру из списка при запуске приложения.
Была ли статья полезна?
Спасибо!
Что может сделать статью еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.