Сигнатура метода
Метод позволяет предложить пользователю установить оценку игре:
FAPI.UI.showRatingDialog();
Пример вызова
function showRatingDialog() {
FAPI.UI.showRatingDialog();
}
API для проверки оценки игры
Кроме данного SDK-метода платформа API OK также позволяет несколько других возможностей для работы с оценками игр:
- метод apps.getAppUserRating - получить текущую оценку пользователя вашей игре;
- метод apps.getAppRating - получить текущий рейтинг вашей игры и количество оценок.
Пример коллбека
В результате выполнения этого метода пользователю будет показано предложение установить оценку игре. В зависимости от действия пользователя может быть возвращен один из следующих результатов
Коллбек для случая успешной установки оценки
method: “showRatingDialog”
result: “ok”
data: “5”
Коллбек для случая, когда пользователь отказался ставить оценку
method: “showRatingDialog”
result: “error”
data: “dismissed without rating”
Коллбек для случая, когда предложение уже активно
method: “showRatingDialog”
result: “error”
data: “layer already exists”
Коллбек для случая, когда метод не поддерживается на клиенте
method: “showRatingDialog”
result: “error”
data: “not_supported”
Получение событий о новых отзывах
Для удобства мониторинга появления новых отзывов у игры вы можете подписаться на события о появлении нового отзыва
Включив подписку на события в настройках игры, вы будете получать на свой webhook события такого вида:
{
"prevComment": "",
"webhookType": "APP",
"prevRating": 0,
"appId": "app:123123123",
"type": "RATING_COMMENT",
"timestamp": 1691947736017,
"rating": 5,
"userName": "Имя Фамилия",
"comment": "Отличная игра!",
"userId": "user:123123123"
}
Они будут приходить вам как в случае, если пользователь написал новый отзыв, так и при редактировании текущего отзыва.