ОК — большая и популярная социальная сеть. Причем она не только про общение, но и про развлечения: на платформе доступно огромное количество игр и мини-приложений, с которыми аудитория активно взаимодействует. Внутренние приложения и игры ОК использует почти 20 млн человек, и вовлеченность пользователей постоянно растет.

Доступ к этой аудитории есть практически у любого разработчика — разместить свое приложение на платформе ОК и сделать его доступным большой аудитории можно быстрее, чем приготовить завтрак.

Меня зовут Михаил Мосин. Я инженер-программист в ОК. В этой статье я подробно и пошагово расскажу, как зарелизить свое приложение на платформе ОК.

Почему стоит размещать приложения в ОК

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

• В ОК понятный алгоритм размещения и разработки приложений, а также прозрачная система управления ими. Благодаря этому, платформа будет одинаково удобной как для разработчиков-новичков, так и для опытных команд разработки.

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

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

• Ежемесячная аудитория ОК в России — около 35 млн человек. Внутренние приложения ОК использует почти 20 млн человек. Это люди разных возрастов, интересов и предпочтений. Поэтому в ОК гарантированно есть целевая аудитория под любое приложение. 

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

Правила размещения приложений

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

Например:

• версия для публикации должна быть полной, работающей и протестированной;

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

• приложение должно соответствовать правилам платформы.

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

Полный чеклист для запуска приложений на платформе OK.ru можно найти здесь, для запуска в мобильной версии — здесь.

Размещение приложения в ОК

Теперь к самому важному — непосредственно размещению приложения и всем нюансам этого процесса.

Примечание: В статье я буду использовать уже готовое приложение — https://mosinpower.github.io/password-game/. Это простое приложение, которое я сделал исключительно для описания алгоритма размещения, его функционал значения не имеет. Отдельно отмечу, что приложение размещено на Github Pages, но для реальной игры/приложения стоит выбрать нормальный хостинг или воспользоваться хостингом приложений на ОК.

Для добавления приложения на сайт Одноклассники надо зарегистрироваться на сайте OK.ru и привязать к своему аккаунту почту — на нее будут приходить письма, содержащие регистрационные данные приложений.

Примечание: Оптимально регистрироваться в ОК через VK ID — это позволит получить единую точку входа не только в Одноклассники, но и во все сервисы и платформы VK, которые полезны для разработчиков.

Далее надо получить права разработчика тут или по ссылке https://ok.ru/devaccess.

После получения прав разработчика переходим раздел «Приложения».

В верхнем меню выбираем пункт «В разработке».

В поле «Мои загруженные» выбираем «Добавить приложение». После этого откроется раздел «Основные настройки приложения». Здесь заполняем форму, указывая:

• название — имя приложения в каталоге;

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

• имя в ссылке (короткий URL-идентификатор);

• которое описание приложения, которое нужно для потенциальных пользователей и рекламы;

• размеры фрейма с приложением на вебе (ширина от 100 до 760px, высота от 100 до 4000px). На мобильных платформах приложение всегда открывается в полный экран;

• данные группы (официальная группа, ID темы в группе, ID видео в группе);

• ссылку на службу поддержки;

• ссылку callback;

• IP адреса сервера.

Подключение других платформ

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

• OAuth — для приложений, которые предназначены для OAuth-авторизации и автопостинга в группу / ленту пользователей;

• Web — для приложений, предназначенных для запуска в десктопной версии ОК (ok.ru);

• Мобильное — в случае, если приложение рассчитано на запуск на мобильных устройствах (mobile Web, android, iOS);

• Группа  — вспомогательная платформа, которая подключается только для групповых приложений, работающих на платформах Web и Мобильное. 

В рамках примера рассмотрим кейс, при котором нам важно, чтобы пользователь мог открыть приложение в web и mobile web версиях OK. Добавляем соответствующие платформы.

Настройки приложения

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

В рамках нашего примера для Web указываем:

• подтип приложения;

• ссылку на приложение;

• настройки баннерной рекламы.

Для mobile web:

• ссылку на приложение;

• настройки баннерной рекламы.

Здесь же можно подключить и сам режим разработчика. 

Примечание: Указанный в настройках URL будет основным для всех пользователей с правами разработчика, независимо от их роли — разработчики, тестировщики, продакты или другие специалисты. Кроме того, надо понимать, что включение режима разработчика, помимо прочего, дает возможность указывать отдельные URL приложения для разных платформ. Указать отдельный URL можно в поле «Ссылка на приложение для разработчиков».

Примечание: Отдельно оговорюсь, что настройки можно будет менять и после релиза приложения — это можно сделать как напрямую по ссылке https://ok.ru/game/{application_id}, так и через меню «Приложения» - «В разработке». Во втором случае для доступа к настройкам достаточно нажать «Изменить настройки приложения» и далее ввести секретный ключ приложения, который приходит в письме с данными.

Далее предлагается задать права доступа. Среди прочего можно настроить:

• доступ к личной информации через OAuth;

• получение e-mail-адреса пользователя;

• получение длинных токенов OAuth;

• установку статусов;

• управление группами;

• изменение фотографий и фотоальбомов.

В рамках обзорного кейса оставим эти настройки без изменений — мы размещаем простое приложение и дополнительные права доступа ему не нужны.

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

Работа с приложением

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

Для проверки находим его и запускаем. 

Всё работает.

Аналогично и в мобильной версии.

Теперь дело остается за малым — отправить приложение на модерацию. Только после этого его смогут увидеть другие пользователи.

Примечание: Стоит отметить, что пока приложение на модерации, к нему можно дать доступ другим пользователям, добавив их в разработчики/тестировщики.

Модерация приложения

В ОК довольно лояльная система модерации приложений, поэтому нет замудренных и необоснованных требований.

Как правило, всё сводится к паре небольших действий.

Так, выбираем свое приложение из каталога и отправляем его на модерацию.

В самой заявке указываем всю запрашиваемую информацию:

• название;

• тип приложения;

• ID приложения на сайте ОК;

• описание;

• платформы размещения;

• логин владельца приложения в ОК;

• данные контактного лица;

• адрес электронной почты;

• телефон;

• название компании-разработчика (если есть).

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

Обычно модерация занимает несколько дней. О результатах проверки разработчика оповещают по почте и с помощью внутренних уведомлений в ОК.

После этого приложение будет доступно всем пользователям ОК. Profit!

Что в итоге

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

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

Поэтому, если вы хотели разместить свое приложение в ОК, но не решались — самое время это сделать. 

Еще полезные материалы по теме

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

Поэтому на платформе есть много документации и решений для многих кейсов и задач. Среди прочего, выделил самые полезные материалы.

• Об игровой платформе. 

• О расширенных возможностях игровой платформы.

• О платформе приложений.

• О доступных SDK.

• О поддерживаемых методах.

• Об API, обработке ошибок и ограничениях приложений.