Игровые пуши

Игры в ОК могут отправлять пользователям мобильные пуши от лица приложения ОК играющих в них пользователей.

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

Пуши будут показываться пользователям, которые имеют установленное приложение ОК на платформах android или iOS и выглядят следующим образом:

SDK игровых пушей

Для работы с пушами платформа игр ОК предоставляет API и SDK методы, которые позволят вам:

• проверять статус подписки на пуши (и оповещения) пользователя от игр через API - apps.getUserSubscriptions;
• проверять статус подписки на пуши на устройстве пользователя через FAPI SDK - FAPI.UI.getPushNotificationsStatus;
• предлагать пользователю включить пуши от вашей игры на устройстве пользователя через FAPI SDK - FAPI.UI.suggestToEnablePushNotifications;
• отправлять пуши пользователям от игры через API - apps.sendGamePush.

Проверка статуса подписки через API

Предварительно вы можете проверить, включены или не включены пуши (и оповещения) у пользователя с помощью метода apps.getUserSubscriptions. Этот метод нужно вызывать на сервере, а не в рамках сессии пользователя, и через него вы можете получить статус подписки для любого пользователя, который является активных игроком в вашей игре.

Метод доступен всем играм по умолчанию и не требует дополнительных прав.

Проверка статуса подписки на устройстве

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

Для этого вам доступен метод в FAPI SDK - FAPI.UI.getPushNotificationsStatus. С помощью этого метода вы можете узнать статус подписки на пуши на устройстве пользователя и, если они выключены, предложить пользователю включить их (с помощью метода, описанного ниже).

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

Предложение включить пуши на устройстве

Для случая, когда пользователь отключил пуши либо от вашей игры, либо вообще все пуши от приложения ОК, то у вас есть возможность предложить пользователю включить пуши с помощью метода FAPI SDK - FAPI.UI.suggestToEnablePushNotifications.

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

Отправка пуша пользователю через API

Если пользователь разрешил игре отправку пушей, то их можно отправлять с помощью метода apps.sendGamePush. Поскольку пуш - это очень инвазивная механика, то на этот метод возложен ряд ограничений и проверок, которые надо пройти перед тем, как пуш будет отправлен пользователю.

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

Данный метод требует прохождения модерации и недоступен играм по умолчанию.

Модерация

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

Если прав на отправку пушей у вашего приложения нет, то метод вернет ошибку:

Для прохождения модерации вам надо предоставить команде ОК следующие данные:

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

При необходимости вы также можете запросить:

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

Для изменения этих настроек вашему приложению требуется аргументировать эту необходимость.