5 месяцев назад
История
README.md
react-native-rustore-review
React Native RuStoreSDK для отзывов
Общее
Пример реализации
Для того, чтобы узнать как правильно интегрировать отзывы, рекомендуется ознакомиться с приложением-примером в папке example
.
Условия корректной работы SDK
Для работы SDK оценок и отзывов необходимо соблюдение следующих условий:
- ОС Android версии 7.0 или выше.
- На устройстве пользователя установлено приложение RuStore.
- Версия RuStoreApp на устройстве пользователя актуальная.
- Пользователь авторизован в приложении 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);
}