SDK для Cocos Creator / Бесплатные товары
 На главную

SDK для Cocos Creator

  • Руководство по интеграции

  • Демопроект

  • Аутентификация

  • Каталог

  • Акции

  • Подписки

  • Покупка товара

  • Инвентарь игрока

  • Личный кабинет и атрибуты пользователя


  • Бесплатные товары

    Бесплатные товары — это вид товаров, которые пользователь может получить, не тратя виртуальную или реальную валюту. К ним относятся:

    • виртуальные предметы;
    • бандлы;
    • пакеты виртуальной валюты.

    Бесплатные товары доступны для получения только авторизованным пользователям. Неавторизованные пользователи могут только просматривать каталог бесплатных товаров.

    Примеры использования:

    • Вы можете раздавать бесплатные товары в значимые для вашего проекта даты, например в день основания проекта, чтобы вознаградить пользователей за их лояльность.
    • Вы можете раздавать бесплатные стартовые пакеты для игры в интернет-магазине, чтобы привлечь в игру новых пользователей.

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

    Чтобы настроить бесплатные товары:

    1. Добавьте бесплатные товары в каталог.
    2. Реализуйте логику приобретения пользователем бесплатного товара.
    3. Реализуйте логику начисления бесплатных товаров пользователю.

    Добавление бесплатных товаров в каталог

    Подробные инструкции по созданию товаров приведены в разделах:

    Для бесплатных товаров требуется при создании или редактировании товара в разделе Платно или бесплатно выбрать Бесплатный предмет, Бесплатный пакет или Бесплатный бандл.

    Приобретение бесплатного товара пользователем

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

    • В один клик (не используя корзину) — подходит для приобретения одного артикула товара, но в любом количестве. Например, 100 одинаковых зелий.
    • Через корзину — подходит для приобретения любого типа товара в любом количестве.

    Приобретение бесплатного товара в один клик

    Для реализации этого способа вызовите метод SDK createOrderWithSpecifiedFreeItem при нажатии в каталоге на кнопку приобретения товара.

    Начисление товара в инвентарь на стороне Иксоллы происходит сразу после успешного вызова этого метода, без необходимости открывать платежный интерфейс.

    Приобретение бесплатного товара через корзину

    Если пользователь использует покупку через корзину:

    • Если в корзине пользователя находятся и платные, и бесплатные товары:
      1. Получите платежный токен и идентификатор заказа с помощью метода SDK fetchCartPaymentToken.
      2. Реализуйте ​​открытие платежного интерфейса. Для этого вызовите метод SDK openPurchaseUI, передайте в него платежный токен и идентификатор заказа.

    • Если в корзине пользователя находятся только бесплатные товары, используйте метод SDK createOrderWithFreeCart или createOrderWithSpecifiedFreeItem. Начисление товара в инвентарь на стороне Иксоллы происходит сразу после успешного вызова этого метода, без необходимости открывать платежный интерфейс.

    Начисление бесплатных товаров пользователю

    Вы можете отслеживать статус приобретения бесплатного товара с помощью вызова по таймеру метода SDK checkOrder.

    В случае успешного приобретения используйте методы SDK для отображения инвентаря, чтобы обновить данные в клиентской части приложения.

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

    В другой раз

    Спасибо за обратную связь!

    Полезные ссылки

    Последнее обновление: 6 апреля 2023

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

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