SDK enterprise-уровня для Unity / Управление покупками

Управление покупками

Узнайте о дополнительных настройках из наших инструкций.

Как настроить платежи через Steam

Внимание
Используйте эту инструкцию для работы только с ассетом Game Commerce.
Иксолла может выступать платежным шлюзом при оплате внутриигровых покупок через Steam. При этом вам не требуется интегрировать Steam SDK и учитывать особенности оплаты через Steam при реализации внутриигрового магазина.

Чтобы настроить платежи через Steam:

  1. Подпишите дополнительное соглашение с Иксоллой.

Примечание
Иксолла взимает сниженный процент Revenue share при проведении платежей через Steam. Уточните условия у аккаунт-менеджера проекта.
  1. Настройте прямой аккаунт для Steam в Личном кабинете.
  2. Подключите нативную авторизацию через Steam.
  3. Откройте проект Unity.
  4. В главном меню выберите пункт Window > Xsolla > Edit Settings.
  5. В панели Inspector в поле Payments выберите значение Steam Gateway.

После изменения настроек проекта Unity, к запросу платежного токена добавится заголовок x-steam-userid.

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

Как работать с купонами

Внимание

Используйте эту инструкцию для работы только со следующими ассетами:

  • Game Commerce
  • Cross-Buy

Поддержка ассета Cross-Buy будет прекращена в апреле 2022. Вы можете продолжить использовать его, но он не будет обновляться и дополняться новыми возможностями. Рекомендуется перейти на использование ассета Game Commerce. Он содержит все классы и методы, необходимые для работы с продуктами Иксоллы.

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

Подробные сведения о возможностях и ограничениях купонных акций приведены в документации по продукту Внутриигровой магазин.

Для работы с купонными акциями:

  1. Выполните настройки в Личном кабинете согласно инструкции по настройке акционных кампаний с купонами.
  2. Реализуйте внутриигровую логику с помощью следующих методов SDK:

    • GetCouponRewards — получает список предметов, которые могут быть начислены пользователю при погашении купона. При этом используется метод API Get coupon rewards.
    • RedeemCouponCode — погашает код купона и начисляет вознаграждение пользователю. При этом используется метод API Redeem coupon code.
Примечание
Если для вашего приложения нежелательно реализовывать интерфейс и дополнительную логику работы с купонами, обратитесь к аккаунт-менеджеру проекта для настройки акционной кампании. В этом случае ввод и активация купона будут осуществляться не в интерфейсе корзины, а при оплате покупки в платежном интерфейсе.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Скрыть

Как работать с промокодами

Внимание
Используйте эту инструкцию для работы только с ассетом Game Commerce.
Чтобы привлечь внимание потенциальных пользователей к вашему приложению и повысить уровень продаж, вы можете проводить акции с промокодами. При погашении промокода пользователь может получить одно или несколько из следующих вознаграждений:
  • скидку, которая применяется к корзине пользователя;
  • бонусный предмет:
    • пакет виртуальной валюты;
    • игровой ключ;
    • виртуальный предмет, в том числе бандл или непродлеваемую подписку.

Подробные сведения о возможностях и ограничениях акций с промокодами приведены в документации по продукту Внутриигровой магазин.

Для работы с промокодами:

  1. Выполните настройки в Личном кабинете согласно инструкции по настройке кампаний с промокодами.
  2. Реализуйте внутриигровую логику с помощью следующих методов SDK:

    • GetPromocodeReward — получает вознаграждения по промокоду. Позволяет пользователям выбрать один из множества предметов в качестве бонуса. При этом используется метод API Get promo code reward.
    • RedeemPromocode — погашает промокод. После погашения промокода пользователь получает бесплатные товары и/или к стоимости корзины применяется скидка. При этом используется метод API Redeem promo code.
Примечание
Если для вашего приложения нежелательно реализовывать интерфейс и дополнительную логику работы с промокодами, обратитесь к аккаунт-менеджеру проекта для настройки акционной кампании. В этом случае ввод и активация промокода будут осуществляться не в интерфейсе корзины, а при оплате покупки в платежном интерфейсе.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Скрыть

Как работать с бандлами

Внимание
Используйте эту инструкцию для работы только с ассетом Game Commerce.
Чтобы привлечь внимание пользователей к вашему приложению и повысить уровень продаж, вы можете продавать наборы товаров в виде бандлов по цене ниже стоимости их содержимого.

В состав бандла могут входить:

  • виртуальная валюта (в том числе платформозависимая);
  • пакет виртуальной валюты;
  • игровые ключи для заранее выбранных DRM;
  • виртуальные предметы, включая непродлеваемые подписки;
  • бандлы.

Подробные сведения о возможностях и ограничениях бандлов приведены в документации по продукту Внутриигровой магазин.

Для работы с бандлами:

  1. Выполните настройки в Личном кабинете согласно инструкции по настройке бандла.
  2. Реализуйте внутриигровую логику с помощью следующих методов SDK:

    • GetBundles — возвращает список всех бандлов для построения каталога. При этом используется метод API Get list of bundles.
    • GetBundle — возвращает бандл по указанному артикулу. При этом используется метод API Get specified bundle.
Примечание
Для бандлов, которые содержат предметы, продаваемые за реальную валюту, суммарная стоимость этих предметов передается в параметре total_content_price. Вы можете использовать это значение, чтобы отобразить в вашем приложении выгоду от покупки бандла.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Скрыть

Как использовать сайт магазина внутриигровых товаров с SDK

Внимание

Используйте эту инструкцию для работы только со следующими ассетами:

  • Game Commerce
  • Cross-Buy

Поддержка ассета Cross-Buy будет прекращена в апреле 2022. Вы можете продолжить использовать его, но он не будет обновляться и дополняться новыми возможностями. Рекомендуется перейти на использование ассета Game Commerce. Он содержит все классы и методы, необходимые для работы с продуктами Иксоллы.

Реализуйте продажу виртуальных предметов и виртуальной валюты вне игры через сайт магазина. Купленные предметы и валюта будут доступны в инвентаре игрока.

Чтобы интегрировать сайт магазина с SDK:

  1. Создайте сайт магазина.
  2. Укажите адрес сайта магазина внутриигровых товаров в коде приложения.
  3. Реализуйте логику работы вашего приложения с сайтом магазина.

Создание сайта магазина

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

Внимание
По умолчанию при создании сайта в Личном кабинете создается новый вариант авторизации. При настройке Конструктора сайтов используйте тот же вариант авторизации, что и при настройке SDK.

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

Рекомендации по логике работы приложения с сайтом магазина

При разработке приложения следуйте рекомендациям:

  1. Синхронизируйте поля регистрации и авторизации пользователя в вашем приложении и в виджете авторизации на сайте магазина:
    • Если для регистрации и авторизации используется email-адрес пользователя и пароль, в приложении задайте имя пользователя равным email-адресу.

Примечание
В виджете для авторизации и регистрации по умолчанию используются email-адрес пользователя и пароль.
    • Если для регистрации и авторизации используется имя пользователя, email-адрес пользователя и пароль, обратитесь к аккаунт-менеджеру проекта для изменения полей виджета авторизации.
  1. При переходе на сайт магазина из клиента приложения реализуйте сквозную авторизацию пользователя. Для этого в параметрах URL необходимо передавать токен пользователя. Пример авторизации приведен в демосцене для ассета Cross-Buy.
Была ли статья полезна?
Спасибо!
Что может сделать страницу еще лучше? Сообщение
Жаль, что так произошло
Расскажите, почему статья не была полезна. Сообщение
Спасибо за обратную связь!
Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
Скрыть
Последнее обновление: 10 октября 2023

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

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