Unity WebGL + Яндекс.Игры (обновлено)
Этот пакет оболочки для платформы Яндекс.Игры, поможет быстро сделать связку между самой игрой и SDK Яндекса. В наборе присутствует набор скриптов со всеми базовыми функциями, плагин для коммуникации между игрой и сдк. Дополнительно, также мы добавили свой шаблон для сборки игры, где уже вшиты необходимые JS функции. Разработчику остается только сделать нужные настройки в консоли яндекса, а всё остальное можно делать через скрипт-менеджера.
Итак, набор нашей оболочки SDK для платформы https://games.yandex.ru/
Для начала вам нужно пройти регистрацию в рекламной сети Яндекса РСЯ https://partner.yandex.ru/ заполнить все документы и заключить договор, когда всё будет оформлено, можно переходить в Яндекс.Игры и добавлять свои игры.
Чтобы открыть все разделы для игры, вам в начале нужно заполнить черновик, загрузить туда билд игры и сохранить черновик и после проверки, через некоторое время, когда появится ссылка на черновик билда, после этого можно переходить к настройкам других разделов.
Далее, можно настроить покупки, добавить товары и потом вам будет доступен секретный ключ:
Секретный ключ, понадобится добавить в настройки нашей оболочки или для создания другого способ проверки подлинности покупок.
В разделе рекламы нужно подключить реворд ролики:
И дополнительно добавить таблицу лидеров:
Тип таблицы в настройках, ставим — numeric.
Наша оболочка + плагин, поддерживает следующие функции:
- Диалоговое окно аутентификации пользователя (опционально).
- Полноэкранные объявления.
- Реклама с вознаграждением.
- Sticky баннеры.
- Оценка игры.
- Запись / получение данных лидерборда.
- Запись / получение данных игрока.
- Внутриигровые покупки.
- Встроена своя система сохранения, аналог PlayerPrefs.
- HTML шаблон поддерживает как широкий формат, так и портрет.
- Добавлен менеджмент таблицы лидеров.
- Добавлена обработка флагов.
Примечание насчет аутентификации: наш плагин сделан так, что система идентифицирует пользователя в фоновом режиме, а если пользователь зашел с другого устройства и/или не находится в системе Яндекса, то будет работать реклама как обычно, но для работы всех остальных функций, нужно запросить аутентификацию, вызвав диалоговое окно Яндекса. Наш менеджер позволяет всё это делать и определять статус пользователя.
Рассмотрим HTML шаблон подробнее:
Здесь мы видим несколько дополнительных опций, их состояние по умолчанию = false.
- Optimize for pixel art — оптимизация для пиксельной графики.
- Portret — включить режим портрета, если в настройках яндекса вы выбрали тоже портретный вид.
- Expand on portret — растянуть экран игры в доступный размер на смартфоне, в ином случае, картинка будет масштабирована так, чтобы сохранить соотношение сторон.
- Expand on widescreen — растянуть экран игры в доступный размер на десктопе, в ином случае, картинка будет масштабирована так, чтобы сохранить соотношение сторон.
UPD
Добавлены скрипты для менеджмента лидербордом. Улучшена общая структура и логика. Добавлена функция «незавершенные покупки на сервисе Яндекса», если в процессе покупки, когда пользователь уже заплатил, но по какой-то причине связь с сервисом оборвалась, покупка может оказаться не завершенной, деньги уплачены, а товар не получен, чтобы исправить такую ситуацию, при каждом запуске, игра делает проверку, есть ли на сервисе неоформленные товары. Если игра находит незавершенные товары, то вызывается событие OnConsumePurchase, где можно получить список ID товаров и предоставить их пользователю, автоматически эти товары будут оформлены должны образом и удалятся с сервисов Яндекса.
Минимальная поддерживаемая версия Unity для нашего плагина: 2021.1 and higher
Публикация игры на платформах
Статья посвящена добавлению новой игры и интеграциям с платформами. Вы можете обращаться к ней каждый раз, когда нужно добавить новую игру на платформы.
Добавляем игру в панели управления
- Для использования возможностей SDK нужно добавить игру в панели. Заполните имя проекта и нажмите добавить игру. Вас перенаправит на только что созданный проект.
- В разделе Project Settings вы можете выбрать генератор аватарок по умолчанию, можно пропустить этот шаг. Здесь же можно добавить счетчик Яндекс.Метрики или Google Analytics.
Игры Вконтакте
Для начала нужно добавить платформу в проект.
Пролистайте до блока платформы и нажмите добавить платформу. Выберите VK Games.
- Вам нужно заполнить App ID и Secret Key, для этого перейдите в список приложений VK и выберите ваше приложение. Заполните поля данными, отмеченными на скриншоте.
Секретный код нужен, чтобы подтвердить владельца игрока и его действия — вход, покупку, запрос к API платформы. Без него аккаунт игрока потенциально мог бы забрать любой желающий.
- Вконтакте требует чтобы игра была залита на ваш хостинг. Мы предоставляем свой хостинг. Более 200 серверов по всему миру и сжатие ресурсов игры обеспечат максимальную скорость загрузки. Перейдите в раздел Game Hosting вашего проекта и загрузите архив с игрой, сервис автоматически создаст черновик. Для публикации нажмите «Опубликовать».
- Осталось подключить рекламу. Реклама Вконтакте реализована на стороне сервиса AppsCentrum.
- Войдите в аккаунт и подключите игру, для этого выберите пункт Медиареклама, перейдите во вкладку Приложения.
- Выберите тип приложения VK Mini App или игра на Direct Games.
- Нажмите Добавить.
На этом настройка платформы VK Games закончена.
Яндекс.Игры
По аналогии с VK в панели управления GamePush нужно добавить платформу Yandex.Games. Во вкладке Подключение укажите ID игры и Секретный ключ .
Получить App ID можно просто из URL игры.
Получить Secret Key сложнее. На текущий момент есть только костыль-хак с покупками. Вам нужно перейти в раздел Покупки и добавить любую покупку.
Затем обновите страницу, только после этого появится поле Secret Key .
После получения ключа нужно удалить покупку, иначе игра не пройдет модерацию.
Добавьте данные и сохраните платформу.
Добавляем cтики баннер в Яндекс.Игры
Стики баннер — это баннер в нижней части экрана или справа (десктоп). Он находится всегда во вьюпорте. Баннеру можно выставить частоту автообновления, чтобы менять рекламу:
Баннер может генерировать до 70% дохода от всей рекламной монетизации. Крайне рекомендуем его добавить.
Как добавить Sticky баннер:
- Перейдите черновик игры в Яндекс Играх;
- Проскрольте до блока Sticky баннеры;
- Включите баннеры как показано на скриншоте или подстройте под себя.
Не забываем сохранить. Поздравляем — баннер добавлен!
Баннер будет автоматически показываться при старте игры, а так же автоматически обновляется с интервалом 30-60 секунд.
OK Games
Платформа ведет работу только с юр лицами или ИП. Физ. лица и самозанятые не могут опубликовать игру.
- Вам нужно заполнить App ID и Secret Key. Они отправляются на почту при регистрации приложения в Одноклассниках.
- Одноклассники требуют, чтобы игра была залита на ваш хостинг. Мы предоставляем свой хостинг. Более 200 серверов по всему миру и сжатие ресурсов игры обеспечат максимальную скорость загрузки. Перейдите в раздел Game Hosting вашего проекта и загрузите архив с игрой, сервис автоматически создаст черновик. Для публикации нажмите «Опубликовать».
- Реклама OK Games реализована на стороне сервиса и в панели ничего добавлять не нужно.
На этом настройка платформы OK Games закончена.
GameMonetize
- Вам нужно заполнить только App ID. Он виден сразу при создании игры.
- На этом настройка платформы GameMonetize закончена.
GameDistribution
- Вам нужно заполнить только App ID. Он виден сразу при создании игры.
- На этом настройка платформы GameDistribution закончена.
CrazyGames
- Зарегистрироваться на портале для разработчиков.
- Добавить игру на портале.
- Выбрать «Game type» — HTML5.
- Добавить платформу в список.
- На этом настройка платформы CrazyGames закончена.
GamePix
- Нужно просто добавить платформу в список, ничего заполнять не нужно.
- На этом настройка платформы GamePix закончена.
WG Playground
- Подайте заявку на сотрудничество: https://www.wgplayground.com/developers.
- Добавьте площадку в список, ничего заполнять не нужно.
- На этом настройка платформы WG Playground закончена.
Kongregate
- Отправьте запрос на сотрудничество:
- Через Google Forms;
- По электронной почте [email protected] или [email protected] ;
- Через Telegram @saweliewa3.
- Добавьте платформу в список в GamePush Panel. Вам нужно заполнить ID приложения и секретный ключ.
Добавьте /api к ссылке на вашу игру, чтобы увидеть ID игры и API-ключ:
https://www.kongregate.com/games/your_nikname/your_game_name_preview/api 
Также вы можете проверить аутентификацию, используя Guest access URL с этой страницы.
- Настройка платформы Kongregate завершена.
POKI
- Нужно просто добавить платформу в список, ничего заполнять не нужно.
- На этом настройка платформы POKI закончена.
SmartMarket
Монетизировать игру через покупки и рекламу могут только юр лица или ИП.
- Создайте проект на сайте developers.sber.ru. Для этого в панели управления нажмите Создать проект и выберите HTML5 игры.
- Добавьте Webhook смартапа в разделе Параметры.
Если вам нужна только реклама в приложении, воспользуйтесь хуком ниже:
https://smartapp-code.sberdevices.ru/chatadapter/chatapi/webhook/sber_nlp2/TAQKYcCq:fc53e1440f90ee439af4af4f6c6d1d62730228ab Если вам нужна реклама и внутриигровые покупки, воспользуйтесь хуком от GamePush:
https://gamepush.com/api/smartmarket/webhook - Если вы используете ссылку на хостинг, то необходимо к ней добавить query-параметр с явным указанием платформы, чтобы обеспечить распознавание платформы в том числе и на портале sber.ru:
?_platform=SMARTMARKET 
- Добавьте платформу в GamePush и укажите ID смартапа.
Его можно узнать следующим способом:
Дальнейшая инструкция для тех, кто хочет подключить платежи
- Добавьте проект SmartPay
- Получите тестовый токен и Service_id :
- Укажите их в настройках платформы GamePush, а так же укажите НДС:
В списке НДС (Tax type) доступны 2 значения: None — НДС не платится (УСН) и Vat 20% — 20% НДС. Если у вас другая ставка НДС, пожалуйста, сообщите нам.
На этом настройка платформы SmartMarket закончена.
После прохождения модерации не забудьте изменить тестовые токен и service_id на эксплуатационные.
VK Play
Вам нужно подать заявку на подключение кабинета разработчика, чтобы получить доступ к публикации на VK Play. Сделать это можно перейдя по ссылке https://developers.vkplay.ru/welcome в кабинет разработчика.
После принятия заявки вам откроется доступ в личный кабинет, теперь вы можете добавить игру. После заполнения формы добавления игры, вы попадете в панель управления игрой.
В разделе Системные свойства есть информация об ID и секретном ключе.
Используйте их, чтобы добавить площадку в GamePush:
Для настройки покупок воспользуйтесь инструкцией.
На этом настройка платформы VK Play закончена.
Подключаем SDK к игре
Вы используете Construct 3? Вместо этого раздела добавьте плагин C3 Plugin — GamePush. И укажите в нём ID проекта и публичный токен из раздела Public Zone.
Для встраивания SDK в свою игру необходимо добавить скрипт в index.html игры. Скрипт можно найти на странице проекта в разделе Install Code .
Затем объявите функцию-callback, в которую будет передан экземпляр SDK. А дальше дело за вами. Код ниже дан в качестве примера, можно настроить на свой вкус.
window.onGPInit = async (gp) => const player, ads > = gp; // Wait while the player syncs with the server await player.ready; // Show the ad preloader and wait until it ends await ads.showPreloader(); // Show the sticky banner (then it will update itself) ads.showSticky(); // You can start the game :) /** * Below you can see examples of functions for work with ads */ // Call a fullscreen banner when the level is over // onLevelEnd(); function onLevelEnd() ads.showFullscreen(); > // Player wants to get x5 reward for watching video // getX5Reward(500); async function getX5Reward(basicReward) const success = await ads.showRewardedVideo(); if (success) // See out the video player.add('gold', 5 * basicReward); > else // Doesn’t want to player.add('gold', basicReward); > > >; Осталось только залить игру на платформы и наслаждаться результатом.
Оставайтесь на связи
С другими разделами документации вы можете ознакомиться здесь. Для начала работы вы можете ознакомиться с нашими туториалами.
Сообщество GamePush в Telegram : @gs_community.
Для ваших обращений e-mail : [email protected]
Желаем вам успехов!
- Добавляем игру в панели управления
- Игры Вконтакте
- Яндекс.Игры
- Добавляем cтики баннер в Яндекс.Игры
- OK Games
- GameMonetize
- GameDistribution
- CrazyGames
- GamePix
- WG Playground
- Kongregate
- POKI
- SmartMarket
- VK Play
- Подключаем SDK к игре
Подключение интернет-эквайринга CloudPayments
С интернет-эквайрингом CloudPayments вы можете легко получать платежи онлайн как на сайте, так и в приложении. CloudPayments позволит вашим клиентам оплатить покупки банковской картой и методами быстрой оплаты: СБП, Яндекс Пэй, Tinkoff Pay, Mir Pay, по ссылке или QR-коду. Подключите интернет-эквайринг с готовыми модулями для CMS и мобильных SDK. Также партнерам СloudPayments доступна облачная онлайн-касса и способ фискализации без кассы Cloud-чеки.
Подключить
Порядок подключения
Пошаговая инструкция по подключению интернет-эквайринга
- Шаг 1. Оставьте заявку на сайте
- Шаг 2. Дождитесь ответа менеджера
- Шаг 3. Получите логин и пароль для тестового доступа
- Шаг 4. Заполните необходимые документы для получения платежного терминала
- Шаг 5. Интегрируйте интернет-эквайринг в ваш сайт
- Шаг 6. Проверьте прием и вывод платежей в режиме теста
- Шаг 7. Сообщите менеджеру об успешном тесте и получите полный доступ к интернет-эквайрингу
- Шаг 8. Получайте онлайн-платежи с карты и другими способами оплаты в один клик.
Как подключить интернет-эквайринг на сайт или в мобильное приложение?
Платежный виджет или платежный конструктор
Это инструмент, который позволяет совершать покупки онлайн на сайте или в приложении. Он выглядит как окно на экране, где клиент вводит данные банковской карты, чтобы оплатить заказ. Встроенный виджет оплаты для сайта сам определяет тип карты и адаптируется для использования на всех устройствах и в любом браузере. Благодаря виджету для интернет-магазина клиент можете сделать покупку без перехода на другой сайт или приложение. Платежный конструктор позволяет создать кастомизированную платежную форму.
Checkout – платежный скрипт оплаты
Checkout — это скрипт приема платежей. Он обрабатывает данные, введенные клиентом, и взаимодействует с сервером, чтобы совершить транзакцию. Скрипт сокращает время оформления заказов, что повышает вероятность их завершения. Также скрипт оплаты уменьшает количество ошибок, связанных с неправильным введением данных клиентом.
Прием платежей по ссылке или QR-коду
Платежную ссылку можно разместить в онлайн-трансляции или отправить в личном сообщении.
В личном кабинете CloudPayments можно самостоятельно создавать и настраивать QR-код для оплаты. Размещайте его где угодно — на сайте, в приложении или на листовках, буклетах и билбордах.
Мобильные SDK
Готовые наборы инструментов, которые помогают безопасно принимать платежи в мобильных приложениях на Android и iOS.
API
Программный интерфейс Cloudpayments, который взаимодействует с вашим сайтом и помогает выполнять платежи, проводить отмену оплаты, возврат денежных средств, завершать платежи, создавать и отменять подписки на рекуррентные платежи, а также отправлять счета по e-mail.
Модули для CMS
Готовые платежные решения, совместимые с большинством CMS. С помощью наших модулей можно проводить одностадийные или двухстадийные оплаты с поддержкой онлайн-касс, отправлять чеки, выбирать дизайн и локализировать виджет.
Библиотека для мобильных приложений
Наши мобильные SDK легко встраиваются в приложения на iOS и Android. Интерфейс уже готов — несколько строчек кода, и вы сможете принимать платежи в приложении.
Доступные способы оплаты
Оплата внутри приложения
Пользователь никуда не уходит: платёжные формы встраиваются в приложение и выглядят, как его часть.
Платежи в одно касание
Покупатель подтверждает, что согласен заплатить, из его кошелька ЮMoney списываются деньги.
Простая интеграция
Вы загружаете библиотеку, добавляете несколько строк в код приложения и получаете готовый к работе механизм оплаты.
Карты без PCI DSS
В запросе на оплату банковской картой используется одноразовый токен — его можно получить через мобильный SDK.
Установите демо-приложение, чтобы посмотреть на интерфейсы и процесс платежа через мобильный SDK
Нажимая на кнопку, вы принимаете лицензионное соглашение
Чтобы установить демо-приложение для iOS, нажмите на кнопку с вашего iPhone или iPad. По ней загрузите и установите Testflight, согласитесь с лицензионным соглашением, а затем установите приложение mSDK.