Android SDK
Отзывы в приложении на Android через In-App Review API от Google Play
PromptSurge для Android представляет собой Kotlin-библиотеку, которая показывает короткий предзапрос в фирменном стиле, а затем, когда пользователь подтверждает, запускает процесс In-App Review от Google Play. Два вызова в вашем коде; текст, тема, изображение заголовка и языки приходят с сервера.
Бесплатный план · minSdk 24 · JitPack
1 · Ваш предзапрос
Небольшая просьба
Мы много работали над офлайн-синхронизацией. Короткий отзыв поможет другим людям найти приложение.
2 · Нативное окно оценки
App Store или Google Play
Собственное окно Apple или Google, без изменений
Что Android SDK делает за вас
Собственная карточка отзыва Google Play
После подтверждения SDK вызывает requestReviewFlow() и launchReviewFlow() из ReviewManager. Карточка принадлежит Google и показывается как есть; предзапрос к этому моменту уже закрыт, а появится ли карточка, решает собственная квота Google Play.
Подходит к любой теме приложения
Диалог выполнен в Material 3. В теме Material он наследует ваш стиль; в темах AppCompat, платформенных или собственных игровых темах он переключается на свою встроенную тему, а не падает. Цвета из панели управления применяются поверх.
Безопасно в продакшн-приложениях
minSdk 24, никаких разрешений во время выполнения, ничего не добавляется в манифест, правила R8 поставляются в AAR. requestReview() ничего не делает, если activity завершается, её состояние уже сохранено или диалог уже открыт.
Все проверки условий показа встроены
Отказ (opt-out), 90-дневный интервал повтора на устройство, контрольная группа 10 %, прогрев на 50 устройствах и месячный лимит вашего плана проверяются в первую очередь. Если предзапрос не показывается из-за прогрева, контрольной группы или исчерпанного лимита, процесс отзыва Google Play всё равно запускается, так что момент не теряется.
Ответы для Data Safety в комплекте
Единственный идентификатор представляет собой SHA-256 от ANDROID_ID плюс имя вашего пакета, никогда не сам ID, и рекламный идентификатор не используется. В README точно перечислено, что указать в форме Data Safety в Google Play.
Интеграция
Добавьте JitPack и одну зависимость Gradle (координаты и текущая версия указаны в документации), инициализируйте SDK в своём Application, затем вызовите requestReview() в нужный момент.
Application.onCreate()
import com.promptsurge.sdk.PromptSurge
class MyApp : Application() {
override fun onCreate() {
super.onCreate()
PromptSurge.initialize(this, "ps_live_your_key_here")
}
}В нужный момент
// In an Activity (AppCompatActivity works)
PromptSurge.requestReview(this)
// Or from a Fragment
PromptSurge.requestReview(requireActivity())Во время интеграции PromptSurge.setLogLevel(PromptSurge.LogLevel.INFO) выводит по одной строке на каждое решение. Карточка Google Play ограничена квотой и в отладочной сборке часто ничего не показывает, так что невидимая карточка там нормальна.
Что видит ваш пользователь: три шага
Те же пользователи, тот же момент. Разница в том, что сначала их просят, словами о вашем приложении.
Поездка сохранена
Доступно офлайн
requestReview()
Шаг 1
Момент выбирает ваш код
Вызовите requestReview() сразу после того, как что-то получилось: сохранена поездка или пройден уровень.
Небольшая просьба
Мы много работали над офлайн-картами. Короткий отзыв поможет другим путешественникам найти это приложение.
Не сейчасКонечноШаг 2
Пре-промпт просит вашими словами
Короткое сообщение, которое называет, что умеет ваше приложение. «Не сейчас» закрывает его, и больше ничего не происходит.
Оцените приложение
Нажмите на звезду, чтобы оценить
Отзыв, в котором названа функция
Офлайн-карты спасли мою поездку. Работает без связи.
Шаг 3
Окно оценки самого магазина
«Да» открывает окно магазина без изменений. Только что прочитанное сообщение подсказывает, о чём именно написать.
Для чего это сделано
Больше отзывов от тех же пользователей
Просьба приходит в момент, который выбрали вы, и с причиной ответить.
Больше текстовых отзывов
Сообщение о функции приглашает написать слова, а не только поставить звёзды.
Ваши ключевые слова в их словах
Отзывы, в которых названо, что умеет приложение, говорят следующему посетителю, для кого оно.
Сигнал, который читают магазины
Apple и Google оба говорят, что оценки и отзывы влияют на позицию приложений в поиске.
Панель показывает, что изменилось у вашего приложения: текстовые отзывы в день, звёзды и упоминания ключевых слов, до пре-промпта и с ним.
Источники: Apple: поиск в App Store · Google Play: поиск и ранжирование приложений
Как это работает
Добавьте SDK
Установите пакет для iOS, Android или Unity и один раз вызовите initialize() при запуске. Затем вызывайте requestReview() в выбранный вами момент, например после пройденного уровня, сохранённого проекта или выполненного заказа.
Сделайте предзапрос своим
В панели управления напишите заголовок, сообщение и подписи двух кнопок или позвольте встроенному ИИ составить их по вашим отзывам. Выберите тему, добавьте изображение заголовка на плане Startup и выше и примите: текст переводится на 10 языков и доходит до устройств без обновления приложения.
Сравнивайте с контрольной группой
10 % устройств никогда не видят предзапрос и сразу получают нативное окно в те же моменты. Панель управления показывает обе группы рядом и каждый день записывает оценку и число оценок в магазине.
Измеряется по контрольной группе, а не предполагается
У каждого приложения есть контрольная группа. 10 % устройств попадают в неё навсегда и никогда не видят предзапрос: когда они доходят до выбранного вами момента, сразу срабатывает нативное окно, как было бы без PromptSurge. Новое приложение также начинает с прогрева на 50 устройствах только с нативным окном, чтобы до показа первого предзапроса уже существовал базовый уровень.
Панель управления сравнивает две группы по всем устройствам, которые дошли до вашего момента отзыва: сколько увидели предзапрос, сколько нажали, сколько нативных окон было запрошено. Она не выносит вердикт, пока в каждой группе не наберётся хотя бы 50 устройств.
Одно честное ограничение: Apple и Google никогда не сообщают приложению, поставил ли пользователь оценку и что он написал. Поэтому рядом с воронкой PromptSurge раз в день записывает оценку и число оценок в магазине и показывает изменения. Это общий показатель магазина, он не приписывается никакому отдельному запросу, и панель управления прямо об этом говорит.
Контрольная группа 10 %
Назначается каждому устройству навсегда. Нативное окно срабатывает сразу в те же моменты.
Прогрев на 50 устройствах
Новое приложение начинает только с нативного окна, поэтому сначала появляется базовый уровень.
Ежедневный снимок магазина
Ваша средняя оценка и число оценок в каждом магазине раз в день, для приложений со ссылкой на магазин.
Часто задаваемые вопросы
Какие версии Android поддерживаются?
minSdk 24 (Android 7.0) и новее, Kotlin 1.9 или новее, распространяется через JitPack. Диалогу нужен androidx.fragment, который уже подключает appcompat.
Как предзапрос соотносится с правилами Google Play для отзывов в приложении?
Google просит приложения показывать его карточку отзыва без изменений и ничем её не перекрывать, а также не задавать пользователю никаких вопросов до или во время её показа, и называет вопросы о мнении («Вам нравится приложение?») и вопросы-прогнозы («Вы бы оценили это приложение на 5 звёзд?»). PromptSurge никогда не изменяет карточку Google Play и ничего не показывает поверх неё, его диалог закрывается до того, как карточка откроется, а стандартные и сгенерированные тексты представляют собой утверждения с просьбой оставить отзыв и никогда не содержат вопросов. В руководстве Google также сказано, что приложениям не следует предлагать кнопку призыва к действию, которая запускает процесс отзыва, потому что из-за квоты карточка может не появиться; кнопка подтверждения в предзапросе как раз такая кнопка, поэтому взвесьте эту рекомендацию применительно к своему приложению. В текущих версиях SDK PromptSurge не показывает предзапрос на устройстве в течение 30 дней после последнего запроса карточки Google Play: это снижает риск, но не может его устранить, потому что Google не публикует свою квоту. Если вы пишете собственный текст, формулируйте заголовок как утверждение, как в примере на этой странице; панель управления предупредит вас о любом вопросе.
Что говорят магазины, и заметка для App Review (документация на английском) →Расходует ли «Не сейчас» квоту Google Play?
Нет. «Не сейчас» вообще не запускает процесс отзыва. In-App Review API вызывают только подтверждение или сценарии только с нативным окном: прогрев, контрольная группа и исчерпанный лимит плана.
Почему на моём тестовом устройстве ничего не появляется?
Обычно дело в прогреве: новое приложение показывает только карточку Google Play, пока до момента отзыва не дойдут 50 разных устройств. На время тестов отключите прогрев для приложения в панели управления. Собственная карточка Google Play тоже ограничена квотой и в отладочных сборках часто остаётся скрытой.
Что указать в Data Safety?
Device or other IDs и App activity > App interactions: собираются, не передаются, для аналитики, не связаны с пользователем, в дополнение к тому, что собирает остальная часть вашего приложения. README объясняет каждый ответ.
Похожие страницы
Начните бесплатно
План Indie бесплатен навсегда: одно приложение, 500 показов предзапросов в месяц, без кредитной карты. Собственные изображения заголовка доступны с плана Startup за 39 € за приложение в месяц. Цены в EUR, НДС включён.
Два вызова в Android-приложении, остальное в панели управления
Бесплатный план, без кредитной карты. Создайте приложение, скопируйте его API-ключ и выпускайте.
Создать бесплатный аккаунт →Уже есть аккаунт? Войти