PromptSurge

Unity SDK

Запрос отзыва в Unity для iOS и Android одним вызовом C#

PromptSurge для Unity представляет собой UPM-пакет, который показывает в вашей игре короткий предзапрос в фирменном стиле, а затем открывает нативное окно отзыва: StoreKit на iOS, Google Play In-App Review на Android. Вызовите RequestReview() после уровня; текст, тема, изображение заголовка и языки приходят с сервера.

Бесплатный план · Unity 2022.3 LTS+ · iOS и Android

1 · Ваш предзапрос

Ваше изображение заголовка

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

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

Не сейчасОставить отзыв

2 · Нативное окно оценки

App Store или Google Play

Собственное окно Apple или Google, без изменений

«Не сейчас» закрывает диалог и больше ничего не показывает.

Что Unity SDK делает за вас

Оба магазина, один вызов

PromptSurge.RequestReview() открывает SKStoreReviewController на iOS и In-App Review от Google Play на Android через небольшие нативные прослойки. Зависимость Google Play подключается автоматически через External Dependency Manager, а без него одной строкой Gradle.

Сделан для игровых интерфейсов

Диалог представляет собой оверлей UGUI, собранный в коде, с вашими цветами и изображением заголовка. Он создаёт EventSystem, если в сцене его нет, закрывается по нажатию вне карточки или кнопкой «Назад» на Android и остаётся скрытым, пока не будет готов, так что медленно загружающееся изображение никогда не блокирует ввод.

В редакторе ничего не происходит

Каждый вызов в Play Mode намеренно ничего не делает: ни диалога, ни нативного окна, ни тарифицируемых событий, ничего не записывается в PlayerPrefs. Чтобы увидеть результат, соберите проект на устройство.

Готов к IL2CPP

Пакет поставляется с link.xml и атрибутами [Preserve], поэтому вырезание управляемого кода (managed code stripping) на уровне Medium или High не удаляет то, что нужно SDK.

Все проверки условий показа встроены

Отказ (opt-out), 90-дневный интервал повтора на устройство, контрольная группа 10 %, прогрев на 50 устройствах и месячный лимит вашего плана проверяются в первую очередь. Если предзапрос не показывается из-за прогрева, контрольной группы или исчерпанного лимита, нативное окно всё равно открывается, так что момент не теряется.

Интеграция

Добавьте пакет через Window > Package Manager > + > Add package from git URL, используя URL с зафиксированной версией из документации. Затем инициализируйте SDK один раз и вызовите RequestReview() в нужный момент.

GameManager.cs

using PromptSurgeSDK;

public class GameManager : MonoBehaviour {
    void Start() {
        PromptSurge.Initialize("ps_live_your_key_here");
        PromptSurge.Prefetch();   // warms the cache in the background
    }
}

LevelManager.cs

using PromptSurgeSDK;

public class LevelManager : MonoBehaviour {
    void OnLevelComplete() {
        PromptSurge.RequestReview();
    }
}

На Android библиотека отзывов Google Play подключается через EDM4U автоматически; без EDM4U добавьте implementation 'com.google.android.play:review:2.0.1' в mainTemplate.gradle. PromptSurge.SetLogLevel(LogLevel.Info) выводит по одной строке на каждое решение во время интеграции.

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

На телефоне

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

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

  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 устройствах

Новое приложение начинает только с нативного окна, поэтому сначала появляется базовый уровень.

Ежедневный снимок магазина

Ваша средняя оценка и число оценок в каждом магазине раз в день, для приложений со ссылкой на магазин.

Часто задаваемые вопросы

Какие версии Unity поддерживаются?

Unity 2022.3 LTS и новее. Более старые LTS-версии могут работать, но сборка на них не проверялась, и они не поддерживаются. Для сборок Android нужны распространение через Play Store и minSdkVersion 21; для сборок iOS нужна iOS 14.

Почему в редакторе ничего не происходит?

Так задумано. Каждая точка входа в Play Mode ничего не делает, чтобы тесты никогда не тарифицировали показы и не заполняли PlayerPrefs. Соберите проект на устройство; в новом приложении также учитывайте прогрев на 50 устройствах, который можно отключить в панели управления на время тестов.

Может ли QA видеть диалог больше одного раза?

Да. PromptSurge.SetRateLimitBypass(true) отключает интервалы повтора на этом устройстве. Настройка сохраняется в PlayerPrefs и, пока включена, выводит предупреждение при каждой проверке, поэтому никогда не вызывайте её в сборке, которую выпускаете.

Разрешён ли предзапрос в обоих магазинах?

Оба магазина требуют, чтобы сама оценка ставилась в их собственном окне, и SDK открывает только эти окна: StoreKit на iOS, Play In-App Review на Android, оба без изменений. Правило Apple 5.6.1 не допускает кастомные запросы отзывов, а Google просит приложения не задавать пользователям никаких вопросов перед его карточкой. Предзапрос никогда не спрашивает, как игрок относится к игре или какую оценку он бы поставил, а заголовок в форме утверждения вообще не содержит вопроса. Оба магазина также не рекомендуют открывать их окно по нажатию кнопки, потому что из-за лимитов оно может не появиться; текущие версии SDK пропускают предзапрос там, где этот лимит, скорее всего, уже исчерпан, отдельно для iOS и Android. Как каждый магазин проверит конкретную игру, решает сам магазин.

Что говорят магазины, и заметка для App Review (документация на английском) →

Сколько это стоит?

План Indie бесплатен навсегда: одно приложение и 500 показов предзапросов в месяц, без кредитной карты. Startup стоит 39 € за приложение в месяц (31 € при годовой оплате) и включает 10 000 показов в месяц и собственное изображение заголовка. Growth стоит 99 €, а Unlimited 249 € за приложение в месяц. У каждого приложения свой план; от плана зависит, сколько приложений может создать ваша организация. Показом считается каждый показанный предзапрос; нативные окна оценки и устройства контрольной группы не учитываются. Цены в EUR, НДС включён.

Один вызов после уровня, остальное в панели управления

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

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

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