iOS SDK
Запрос отзыва и оценки в iOS для SKStoreReviewController и requestReview
PromptSurge для iOS представляет собой Swift-пакет, который показывает короткий предзапрос в фирменном стиле, а затем, когда пользователь подтверждает, вызывает собственный запрос отзыва StoreKit. Два вызова в вашем коде; текст, тема, изображение заголовка и языки приходят с сервера.
Бесплатный план · iOS 14+ · Swift Package Manager
1 · Ваш предзапрос
Небольшая просьба
Мы много работали над офлайн-синхронизацией. Короткий отзыв поможет другим людям найти приложение.
2 · Нативное окно оценки
App Store или Google Play
Собственное окно Apple или Google, без изменений
Что iOS SDK делает за вас
Собственное окно отзыва StoreKit
После подтверждения SDK запрашивает у StoreKit окно отзыва с вашей сценой окна (window scene): текущие версии SDK вызывают AppStore.requestReview(in:) на iOS 16 и новее и SKStoreReviewController.requestReview(in:) на более ранних версиях. iOS решает, появится ли окно, не более трёх раз в год на устройстве; SDK никогда не рисует звёзды и не собирает оценку сам.
UIKit и SwiftUI
Передайте любой view controller, который будет показывать диалог; в SwiftUI передайте корневой view controller. Диалог представляет собой программную карточку UIKit, которая учитывает safe area и прокручивает длинный текст.
Все проверки условий показа встроены
Отказ (opt-out), 90-дневный интервал повтора на устройство, контрольная группа 10 %, прогрев на 50 устройствах и месячный лимит вашего плана проверяются до того, как что-либо появится. Если предзапрос не показывается из-за прогрева, контрольной группы или исчерпанного лимита, нативный запрос всё равно срабатывает, так что момент не теряется.
Без запроса ATT, манифест конфиденциальности в комплекте
Единственный идентификатор представляет собой хеш SHA-256 с солью от identifierForVendor и вашего bundle ID; IDFA не используется, и запроса App Tracking Transparency нет. PrivacyInfo.xcprivacy поставляется в пакете, а в README есть ответы для App Privacy.
Показ без ожидания
Вызовите prefetch() при запуске, и текст закешируется на устройстве, так что requestReview(in:) сможет показать диалог без обращения к сети.
Интеграция
Добавьте пакет в Xcode (File > Add Package Dependencies, затем вставьте URL ниже и выберите продукт PromptSurge). Инициализируйте SDK один раз, затем вызовите requestReview(in:) в нужный момент. Полные шаги, включая Package.swift, есть в документации.
URL пакета
https://github.com/PromptSurge-SDK/sdk-iosТочка входа приложения (SwiftUI)
import SwiftUI
import PromptSurge
@main
struct YourApp: App {
init() {
PromptSurge.initialize(apiKey: "ps_live_your_key_here")
PromptSurge.prefetch() // warms the cache in the background
}
var body: some Scene {
WindowGroup { ContentView() }
}
}В нужный момент (UIKit)
import PromptSurge
class CheckoutViewController: UIViewController {
private func onPurchaseSuccess() {
PromptSurge.requestReview(in: self)
}
}Во время интеграции PromptSurge.setLogLevel(.info) выводит по одной строке на каждое решение, включая прогрев, при котором новое приложение для первых 50 устройств показывает только нативное окно.
Что видит ваш пользователь: три шага
Те же пользователи, тот же момент. Разница в том, что сначала их просят, словами о вашем приложении.
Поездка сохранена
Доступно офлайн
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 устройствах
Новое приложение начинает только с нативного окна, поэтому сначала появляется базовый уровень.
Ежедневный снимок магазина
Ваша средняя оценка и число оценок в каждом магазине раз в день, для приложений со ссылкой на магазин.
Часто задаваемые вопросы
Какие версии iOS поддерживаются?
iOS 14 и новее, сборка в Xcode 14 или новее, установка через Swift Package Manager.
Разрешён ли предзапрос по правилу App Store 5.6.1?
Правило 5.6.1 предписывает запрашивать отзывы через API Apple и говорит, что кастомные запросы отзывов Apple не допускает. PromptSurge никогда не собирает оценку сам: звёзды и текст отзыва всегда остаются в собственном окне Apple, которое запрашивается через StoreKit. Диалог перед ним представляет собой короткую просьбу и никогда не спрашивает, как пользователь относится к приложению. В документации Apple по StoreKit также сказано не вызывать requestReview в ответ на нажатие кнопки, потому что система может не показать окно; при использовании предзапроса окно запрашивается именно нажатием пользователя на кнопку подтверждения. В текущих версиях SDK PromptSurge перестаёт показывать предзапрос на устройстве, как только трижды за 365 дней запросил на нём окно Apple (это собственный лимит Apple), поэтому «да» реже остаётся без ответа. Как Apple проверит конкретное приложение, решает Apple, поэтому любой текст, который вы пишете сами, должен оставаться простым утверждением; также стоит описать предзапрос в заметках для App Review. Панель управления предупредит вас, если текст содержит вопрос.
Что говорят магазины, и заметка для App Review (документация на английском) →Нативное окно всегда появляется после подтверждения?
Нет, решает iOS. StoreKit показывает запрос не более трёх раз за 365 дней на устройстве, а тому, кто уже поставил оценку, только для новой версии спустя год. В текущих версиях SDK предзапрос больше не показывается на устройстве, как только SDK трижды за 365 дней запросил на нём окно. Ни SDK, ни любой другой код не может узнать, появилось ли окно и поставил ли пользователь оценку.
Почему на моём тестовом устройстве ничего не появляется?
Почти всегда дело в прогреве: новое приложение показывает только нативное окно, пока до момента отзыва не дойдут 50 разных устройств. На время тестов отключите прогрев для приложения в панели управления и включите setLogLevel(.info), чтобы видеть каждое решение.
Что указать в App Privacy?
Identifiers > Device ID и Usage Data > Product Interaction, оба для аналитики, не связаны с личностью и не используются для отслеживания, в дополнение к тому, что собирает остальная часть вашего приложения. Таблица есть в README.
Похожие страницы
Начните бесплатно
План Indie бесплатен навсегда: одно приложение, 500 показов предзапросов в месяц, без кредитной карты. Собственные изображения заголовка доступны с плана Startup за 39 € за приложение в месяц. Цены в EUR, НДС включён.
Два вызова в iOS-приложении, остальное в панели управления
Бесплатный план, без кредитной карты. Создайте приложение, скопируйте его API-ключ и выпускайте.
Создать бесплатный аккаунт →Уже есть аккаунт? Войти