PromptSurge

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 ограничена квотой и в отладочной сборке часто ничего не показывает, так что невидимая карточка там нормальна.

Смотреть документацию →

На телефоне

Что видит ваш пользователь: три шага

Те же пользователи, тот же момент. Разница в том, что сначала их просят, словами о вашем приложении.

  1. Поездка сохранена

    Доступно офлайн

    requestReview()

    Шаг 1

    Момент выбирает ваш код

    Вызовите requestReview() сразу после того, как что-то получилось: сохранена поездка или пройден уровень.

  2. Небольшая просьба

    Мы много работали над офлайн-картами. Короткий отзыв поможет другим путешественникам найти это приложение.

    Не сейчасКонечно

    Шаг 2

    Пре-промпт просит вашими словами

    Короткое сообщение, которое называет, что умеет ваше приложение. «Не сейчас» закрывает его, и больше ничего не происходит.

  3. Оцените приложение

    Нажмите на звезду, чтобы оценить

    Отзыв, в котором названа функция

    Офлайн-карты спасли мою поездку. Работает без связи.

    Шаг 3

    Окно оценки самого магазина

    «Да» открывает окно магазина без изменений. Только что прочитанное сообщение подсказывает, о чём именно написать.

Для чего это сделано

  1. Больше отзывов от тех же пользователей

    Просьба приходит в момент, который выбрали вы, и с причиной ответить.

  2. Больше текстовых отзывов

    Сообщение о функции приглашает написать слова, а не только поставить звёзды.

  3. Ваши ключевые слова в их словах

    Отзывы, в которых названо, что умеет приложение, говорят следующему посетителю, для кого оно.

  4. Сигнал, который читают магазины

    Apple и Google оба говорят, что оценки и отзывы влияют на позицию приложений в поиске.

Панель показывает, что изменилось у вашего приложения: текстовые отзывы в день, звёзды и упоминания ключевых слов, до пре-промпта и с ним.

Источники: Apple: поиск в App Store · Google Play: поиск и ранжирование приложений

Как это работает

  1. Добавьте SDK

    Установите пакет для iOS, Android или Unity и один раз вызовите initialize() при запуске. Затем вызывайте requestReview() в выбранный вами момент, например после пройденного уровня, сохранённого проекта или выполненного заказа.

  2. Сделайте предзапрос своим

    В панели управления напишите заголовок, сообщение и подписи двух кнопок или позвольте встроенному ИИ составить их по вашим отзывам. Выберите тему, добавьте изображение заголовка на плане Startup и выше и примите: текст переводится на 10 языков и доходит до устройств без обновления приложения.

  3. Сравнивайте с контрольной группой

    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 объясняет каждый ответ.

Два вызова в Android-приложении, остальное в панели управления

Бесплатный план, без кредитной карты. Создайте приложение, скопируйте его API-ключ и выпускайте.

Создать бесплатный аккаунт →

Уже есть аккаунт? Войти