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 会使用您的 window scene 向 StoreKit 请求评价界面:当前的 SDK 版本在 iOS 16 及更高版本上调用 AppStore.requestReview(in:),在更早的版本上调用 SKStoreReviewController.requestReview(in:)。由 iOS 决定界面是否出现,每台设备每年最多三次;SDK 从不自行绘制星级或收集评分。
UIKit 和 SwiftUI
传入任意用于呈现的 view controller 即可;在 SwiftUI 中,传入您的根 view controller。对话框是用代码构建的 UIKit 卡片,遵循安全区域,长文案可滚动。
内置所有资格检查
在显示任何内容之前,会先检查退出设置、每台设备 90 天的冷却时间、10% 对照组、50 台设备的预热期以及您计划的每月上限。当引导对话框因预热期、对照组或上限用完而不显示时,原生请求仍会触发,这个时机不会浪费。
无 ATT 弹窗,附带隐私清单
唯一的标识符是 identifierForVendor 与您的 bundle ID 的加盐 SHA-256 哈希;不使用 IDFA,也没有 App Tracking Transparency 弹窗。PrivacyInfo.xcprivacy 随包提供,README 中给出了 App Privacy 的填写答案。
无需等待即可显示
在启动时调用 prefetch(),文案就会缓存在设备上,这样 requestReview(in:) 无需网络往返即可显示对话框。
集成方式
在 Xcode 中添加包(File > Add Package Dependencies,然后粘贴下面的 URL 并选择 PromptSurge 产品)。初始化一次,然后在您选择的时机调用 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 都表示,评分和评价会影响应用在搜索中的排名。
控制台会显示您的应用发生了什么变化:每天的文字评价数、星级和关键词提及,对比启用预提示之前和之后。
工作原理
添加 SDK
安装 iOS、Android 或 Unity 包,并在启动时调用一次 initialize()。然后在您选择的时机调用 requestReview(),例如完成一个关卡、保存一个项目或完成一笔订单之后。
打造您自己的引导对话框
在控制台中撰写标题、消息和两个按钮标签,或让内置 AI 根据您自己的评价起草。选择一个主题,使用 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 要求使用 Apple 的 API 来请求评价,并表示 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 中有对应表格。