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) выводит по одной строке на каждое решение во время интеграции.
Что видит ваш пользователь: три шага
Те же пользователи, тот же момент. Разница в том, что сначала их просят, словами о вашем приложении.
Поездка сохранена
Доступно офлайн
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 устройствах
Новое приложение начинает только с нативного окна, поэтому сначала появляется базовый уровень.
Ежедневный снимок магазина
Ваша средняя оценка и число оценок в каждом магазине раз в день, для приложений со ссылкой на магазин.
Часто задаваемые вопросы
Какие версии 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, НДС включён.
Похожие страницы
Начните бесплатно
План Indie бесплатен навсегда: одно приложение, 500 показов предзапросов в месяц, без кредитной карты. Собственные изображения заголовка доступны с плана Startup за 39 € за приложение в месяц. Цены в EUR, НДС включён.
Один вызов после уровня, остальное в панели управления
Бесплатный план, без кредитной карты. Создайте игру, скопируйте её API-ключ и соберите проект на устройство.
Создать бесплатный аккаунт →Уже есть аккаунт? Войти