SDK отзывов и оценок для React (версия 6.0.0)

Общие сведения

RuStore In-app Review SDK предлагает пользователю оставить оценку и отзыв о вашем приложении в RuStore, не выходя из приложения.

Пользовательский сценарий оценки и отзыва может быть запущен в любое время на протяжении всего пути пользователя в вашем приложении. Пользователь может оценить ваше приложение по шкале от 1 до 5 и оставить отзыв. Отзыв является опциональным.

Пример реализации

Ознакомьтесь с приложением-примером чтобы узнать, как правильно интегрировать SDK отзывов и оценок.

Пример пользовательского сценария

Условия корректной работы SDK

Для работы SDK оценок и отзывов необходимо соблюдение следующих условий.

Загружены данные о приложении в разделе Push-уведомления > Проекты из Консоль RuStore.

Важно

Подпись и package name различных типов сборок вашего приложения (debug, release и т.д.) могут отличаться друг от друга. В таком случае вы должны создать в разделе Push-уведомления > Проекты из Консоль RuStore проект под каждый тип сборки..

ОС Android версии 7.0 или выше.
На устройстве пользователя установлена актуальная версия RuStore.
Пользователь авторизован в RuStore.
Приложение должно быть опубликовано в RuStore.

Когда запрашивать оценку и отзыв

Следуйте рекомендациям, чтобы решить, в какой момент запросить оценку и отзыв о приложении у пользователя (см. ниже).

Запускайте процесс после того, как пользователь достаточно использовал ваше приложение.
Не запускайте процесс слишком часто — это ухудшит опыт пользователя вашего приложения и ограничит использование SDK оценок.
Не используйте призывы к действию, например, кнопку «Оценить приложение» — пользователь уже мог исчерпать лимит запуска процесса.
Ваше приложение не должно задавать какие-либо вопросы пользователю перед запуском или во время процесса, в том числе вопросы об их мнении (например, «Вам нравится приложение?») или прогнозирующие вопросы (например, «Вы бы поставили этому приложению 5 звёзд?»).

Подключение в проект

Для подключения пакета к проекту выполните следующую команду.

// HTTPS
npm install git+https://git@gitflic.ru/project/rustore/react-native-rustore-review-sdk.git

// SSH
npm install git+ssh://git@gitflic.ru/project/rustore/react-native-rustore-review-sdk.git

Работа с оценками

Подготовка к работе с оценками

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

RustoreReviewClient.init();

Запуск оценки приложения

После инициализации можно делать запрос и показ формы.

try {
    const isRequested = await RustoreReviewClient.requestReviewFlow();
    if (isRequested) {
        await RustoreReviewClient.launchReviewFlow();
    }
} catch (err) {
    console.log(err);
}

信息

Список возможных ошибок

Обработка ошибок

Возможные ошибки

RuStoreNotInstalledException — на устройстве пользователя не установлен RuStore;
RuStoreOutdatedException — версия RuStore, установленная на устройстве пользователя, не поддерживает данный SDK;
RuStoreUserUnauthorizedException — пользователь не авторизован в RuStore;
RuStoreRequestLimitReached — с момента последнего отображения процесса прошло слишком мало времени;
RuStoreReviewExists — этот пользователь уже оценил ваше приложение;
RuStoreInvalidReviewInfo — проблемы с ReviewInfo;
RuStoreException — базовая ошибка RuStore, от которой наследуются остальные ошибки.

SDK отзывов и оценок для React (версия 6.0.0)

Общие сведения​

Пример реализации​

Пример пользовательского сценария​

Условия корректной работы SDK​

Когда запрашивать оценку и отзыв​

Рекомендации к дизайну​

Подключение в проект​

Работа с оценками​

Подготовка к работе с оценками​

Запуск оценки приложения​

Обработка ошибок​