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:

{
    "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 рабочих дней. Для создания и публикации лендинга используется Конструктор сайтов Иксоллы.

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

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

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