VKWebAppRecommend

VKWebAppRecommend вызывает модальное окно с предложением порекомендовать мини-приложение друзьям и отправляет уведомления, если пользователь нажал Рекомендовать.

Важно! Порекомендовать можно только мини-приложения из каталога.

Если мини-приложения нет в каталоге, то при вызове события VKWebAppRecommend модальное окно не будет показано и вернётся сообщение об ошибке.

Модальное окноМодальное окно

Пример

JavaScript
bridge.send('VKWebAppRecommend') .then((data) => { if (data.result) { // Мини-приложение порекомендовано } }) .catch((error) => { // Ошибка console.log(error); });

Платформы

Android, iOS, Mobile Web, Web

Параметры

—

Результат

Проверить результат можно:

  • •

    Используя объект Promise, который возвращается вызовом bridge.send(...).

  • •

    С помощью событий VKWebAppRecommendResult и VKWebAppRecommendFailed.

Подробнее о проверке результатов при вызовах VK Bridge.

Объект Promise

Если обращение к платформе прошло успешно, управление будет передано в then-обработчик объекта Promise. В качестве ответа платформа возвращает объект со следующим полем:

Поле
Тип
Описание
result
boolean
true, если мини-приложение рекомендовано.

Если при обращении к платформе произошла ошибка, управление передаётся в метод catch. В качестве ответа платформа возвращает объект с информацией об ошибке, общий для всех событий VK Bridge.

События

VKWebAppRecommendResult

Сигнализирует, что мини-приложение рекомендовано. В обработчик события на стороне пользователя передаются следующие данные:

JavaScript
{ detail: { type: "VKWebAppRecommendResult", data: { result: true } } }

Передаваемый объект подобен объекту, возвращаемому при успешном выполнении промиса.

VKWebAppRecommendFailed

Информирует об ошибке, если пользователь уже порекомендовал мини-приложение, или произошла другая ошибка при взаимодействии с платформой, или окно не появилось.

В обработчик события на стороне пользователя передаётся объект с информацией об ошибке, общий для всех методов VK Bridge.

Пример обработки событий

Подробнее — в разделе Обработка результата.

Рекомендации

  • •
    Не показывайте окно с предложением рекомендовать мини-приложение слишком часто. Продумайте алгоритм показа, чтобы не надоедать пользователю.
  • •
    Учитывайте значение параметра запуска vk_is_recommended, чтобы не показывать окно тем пользователям, которые уже порекомендовали приложение.
  • •
    Отслеживайте значение catalog_friends_recommendations параметра запуска vk_ref, чтобы сделать приложение более дружественным: предусмотреть специальное приветствие или ознакомительные экраны.

Материалы по теме