Мобильные игры - Instant Games

Платформа игр Одноклассников поддерживает возможность интеграции и запуска HTML5-приложений на всех мобильных платформах, доступных в нашей социальной сети - мобильный веб, нативные приложения Одноклассников на платформах Android и IOS.

     

Создание и настройка приложения

Для подключения поддержки вашей игры на мобильных платформах необходимо его правильно настроить. Для этого надо создать новое или отредактировать уже существующее веб-приложение, подключив у него платформу HTML (Mobile).

Если у вас вдруг всё еще нет приложения, то создать его можно по этой инструкции.

После создания приложения, либо если оно у вас уже есть, остается лишь включить платформу следующим образом:

Интеграция с Одноклассниками

После того, как вы успешно настроили приложение, оно будет доступно по прямой ссылке вида https://m.ok.ru/game/gameId.

ID приложения можно получить из письма, которое приходило вам после создания приложения. В нём так же содержаться публичный и секретный ключи приложения, необходимые для взаимодействия с API Одноклассников. То есть письмо будет примерно таким:

Ваше приложение НАЗВАНИЕ ПРИЛОЖЕНИЯ успешно зарегистрировано на Одноклассниках.

Application ID: 1234567890. - id приложения, который вы можете использовать для идентификации приложения и досупа к нему по ссылке

Публичный ключ приложения: CBANANNANANANANA. - публичный ключ приложения, который используется для взаимодействия с API

Секретный ключ приложения: ABCDE1234567890ABCDE12345. секретный ключ приложения, который используется для взаимодействия с API. Никому не давайте его

Ссылка на приложение: https://ok.ru/game/1234567890 - ссылка на приложение на Одноклассниках. Для доступа к мобильной версии используйте домен m.ok.ru

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

Полный список параметров вы можете найти здесь.

Чтобы определить, что игра была открыта на мобильной платформе, передается особый параметр mob=true.

Подключение SDK

Для реализации взаимодействия с API Одноклассников со стороны HTML5-приложения надо использовать JS SDK для внешних и мобильных приложений

Возможности API и SDK

После подключения JS SDK вы можете делать следующее:

Примеры приложений, которые реализуют это функционал:

  • приложение, реализующее вызов REST-API доступно по ссылке;
  • приложение, реализующее механики инвайтов в игру и создания записей в ленту пользователей доступно здесь

Платежная система и монетизация

Для платформы Instant Games предусмотрено две возможности монетизации игры:

  • с помощью стандартных игровых покупок. Для этого используется виджет проведения платежа в JS SDK;
  • с помощью показа видеорекламы.

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

  • приложение с примером проведения платежа вы можете посмотреть здесь;
  • приложение с примером показа видеорекламы располагается тут.

Для корректной работы платежной системы в настройках игры необходимо указать callback url для обработки платежей

Тестирование приложения

В любое время вы можете проверить, как хорошо работает ваше приложение.

Изначально оно доступно супервизору приложения (пользователь, создавший приложение на Одноклассниках). Для того, чтобы к приложению мог получить доступ другой пользователь, надо выполнить два простых шага:

После этого пользователь должен иметь доступ к игре по прямой ссылка вида https://m.ok.ru/game/gameId. Эту ссылку можно открыть как в мобильном браузере (тогда приложение откроется на мобильной версии Одноклассников), так и внутри приложения Одноклассников на плафтормах Android и IOS.

Требования к приложениям

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

В дополнение к общим требованиям у HTML5-игр есть ряд характерных только для них требований:

  • быть играбельным (не тормозить) на телефонах iPhone 5s и Nexus 5;
  • корректно работать на современных веб браузерах и на мобильных браузерах операционных систем Android и iOS;
  • На всех неподдерживаемых браузерах игра должна показывать заглушку с просьбой обновиться до последней версии текущего браузера или установить другой современный браузер;
  • иметь оранжевую адресную строку (цвет #E57704) в Chrome на Android (тут показано, как это сделать);
  • использовать и показывать мобильный виджет для сессий, запущенных через мобильный браузер, и скрывать его для сессий, запущенных в Android приложении Одноклассники.

Важно: для мобильного виджета следует использовать свой скин, соответствующий графическому стилю игры, который будет хорошо выглядеть на retina дисплеях. Пример виджета из игры «Морской бой»:
Пример скина мобильного виджета в игре "Морской бой", изображение"

Модерация

Когда ваше приложение готово к публикации на Одноклассниках (разработка завершена и приложение удовлетворяет всем требования платформы), требуется отправить его на модерацию через специальную форму

В пункте формы Платформа надо выбрать вариант HTML мобильное приложение. Если вы всё заполнили верно, то вскоре вам придет письмо с доступами к нашей внутренней Jira, где с вами продолжат общение наши специалисты по модерации приложений.

ЧаВо

Если у вас появился какой-либо вопрос по платформе мобильных игр и его не оказалось в списке ниже, то можете задать его по почтовому адресу api-support@ok.ru.

Можно ли использовать одно приложение для нескольких платформ

Да, если у вас уже есть игра, доступная в веб-версии Одноклассников, то рекомендуется использовать это же приложение для реализации мобильной его версии. В таком случае это приложение будет иметь общую пользовательскую базу и настройки, что и веб-версия игры. Например, после прохождения модерации мобильной версией приложения оно автоматически появится в списке моих игр на Одноклассниках.

Можно ли указать для мобильной версии приложения другой URL

Вручную в настройках приложения - нет, нельзя. Но возможность иметь разные URL для разных версий приложения имеется, так что при необходимости надо писать заявку на почтовый адрес api-support@ok.ru.

Как мне попасть в список зафичеренных игр

Правила попадания игр в фичеринг описаны здесь.

Доступны ли в мобильной версии игровые подписки

Нет, пока что такой возможности на платформе Instant Games нет