Разовые уведомления

Разовые уведомления отправляются пользователю при возникновении какого-либо события в игре. Например, начале кампании или конкурса среди игроков, выдаче бонусов, достижении цели. Такие уведомления ещё называют ситуативными.

Для отправки разовых уведомлений используется API ВКонтакте.

Ограничения

•
Уведомления можно использовать в игре только после того, как она прошла модерацию и была опубликована в каталоге. Неопубликованные игры могут отсылать уведомления только своим администраторам.
•
Пользователю можно отправить 1 уведомление в час и не более 3 уведомлений в день.
•
Одному пользователю нельзя отправить подряд 2 уведомления с одинаковым текстом.
•
Для создания уведомлений состояние игры должно быть Включено.
•
Пользователь может получать уведомления только после выдачи разрешения.

Разрешение уведомлений

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

Запрос разрешения

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

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

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

Проверка разрешения

Пользователь может управлять уведомлениями из настроек ВКонтакте, поэтому важно проверять возможность отправки, даже если он не отключал или не включал уведомления напрямую из вашей игры. Для этого используйте метод apps.isNotificationsAllowed с сервисным ключом доступа игры.

Важно! Метод с сервисным ключом доступа можно вызывать только на сервере.

Пример вызова метода apps.isNotificationsAllowed с помощью POST-запроса.

POST https://api.vk.ru/method/apps.isNotificationsAllowed?user_id=ИДЕНТИФИКАТОР_ПОЛЬЗОВАТЕЛЯ&apps_id=ИДЕНТИФИКАТОР_МИНИ_ПРИЛОЖЕНИЯ&access_token=КЛЮЧ_ДОСТУПА&v=ВЕРСИЯ_API HTTP/1.1

Как отправить уведомление

Чтобы отправить разовое уведомление, в серверной части игры выполните API-запрос secure.sendNotification. Для отправки запроса используйте сервисный ключ доступа из настроек игры.

Важно! Метод использует сервисный ключ доступа и может быть вызван только на сервере.

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

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