Android SDK
Android 应用内评价:基于 Google Play In-App Review API
PromptSurge Android 版是一个 Kotlin 库,它会显示一个简短的品牌化引导对话框,并在用户确认后启动 Google Play 的应用内评价流程。代码中只需两次调用;文案、主题、标题图片和语言均来自服务器。
免费计划 · minSdk 24 · JitPack
1 · 您的引导对话框
请您帮个小忙
我们在离线同步上下了很大功夫。一条简短的评价能帮助更多人发现这款应用。
2 · 原生评分界面
App Store 或 Google Play
Apple 或 Google 自己的界面,原样显示
Android SDK 为您做了什么
Play 自带的评价卡片
用户确认后,SDK 会运行 ReviewManager 的 requestReviewFlow() 和 launchReviewFlow()。卡片属于 Google,按原样显示;此时引导对话框已经关闭,卡片是否出现由 Play 自己的配额决定。
适配任何应用主题
对话框采用 Material 3。在 Material 主题下,它会继承您的外观;在 AppCompat、平台主题或自定义游戏主题下,它会回退到自带的主题,而不会崩溃。控制台中设置的颜色会叠加应用在其上。
在生产应用中安全可靠
minSdk 24,无需运行时权限,不向您的 manifest 添加任何内容,R8 规则随 AAR 提供。如果 activity 正在结束、其状态已保存或对话框已在显示,requestReview() 不会执行任何操作。
内置所有资格检查
会先检查退出设置、每台设备 90 天的冷却时间、10% 对照组、50 台设备的预热期以及您计划的每月上限。当引导对话框因预热期、对照组或上限用完而不显示时,Play 的评价流程仍会启动,这个时机不会浪费。
附带 Data Safety 填写答案
唯一的标识符是 ANDROID_ID 加上您的包名后的 SHA-256 哈希,从不使用原始 ID,也不使用广告 ID。README 中准确列出了需要在 Play Data Safety 表单中声明的内容。
集成方式
添加 JitPack 和一个 Gradle 依赖(坐标和当前版本请参阅文档),在您的 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) 会为每次决策打印一行日志。Play 的卡片受配额限制,在调试构建中经常不显示,因此在调试构建中看不到卡片是正常的。
用户看到的三个步骤
同样的用户,同样的时机。区别在于先用关于您应用的话向他们提出请求。
行程已保存
可离线使用
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 台设备预热期
新应用先只显示原生界面,因此基线先行建立。
每日商店快照
对于已添加商店链接的应用,每天一次记录您在各商店的平均评分和评分数量。
常见问题
支持哪些 Android 版本?
minSdk 24(Android 7.0)及更高版本,Kotlin 1.9 或更高版本,通过 JitPack 分发。对话框需要 androidx.fragment,而 appcompat 已经引入了它。
引导对话框与 Google Play 的应用内评价指南是什么关系?
Google 要求应用按原样显示其评价卡片,不在其上叠加任何内容,并且不要在显示卡片之前或期间向用户提出任何问题,其中点名了意见类问题(“您喜欢这款应用吗?”)和预测类问题(“您会给这款应用打 5 星吗?”)。PromptSurge 从不修改或覆盖 Play 的卡片,其对话框在卡片打开之前就已关闭,其默认文案和生成的文案都是请求评价的陈述句,从不提问。Google 的指南还指出,应用不应提供触发评价流程的号召性用语(CTA)按钮,因为其配额可能导致卡片不显示;引导对话框的确认按钮就属于这种按钮,因此请针对您的应用权衡这条指导。在当前的 SDK 版本中,PromptSurge 在某台设备上最后一次请求 Play 卡片后的 30 天内会跳过引导对话框,这能降低这一风险,但无法消除,因为 Google 不公开其配额。如果您自行撰写文案,请像本页示例那样用陈述句写标题;文案中出现任何问题,控制台都会提醒您。
商店怎么说,以及给 App Review 的备注(英文文档)→点击“暂不”会消耗 Play 的配额吗?
不会。“暂不”根本不会启动任何评价流程。只有用户确认,或者预热期、对照组和计划上限用完时的仅原生路径,才会调用应用内评价 API。
为什么我的测试设备上什么都不显示?
通常是因为预热期:在 50 台不同的设备到达评价时机之前,新应用只会显示 Play 的卡片。测试期间,请在控制台中为该应用关闭预热期。Play 自己的卡片也受配额限制,在调试构建中经常不显示。
在 Data Safety 中需要声明什么?
Device or other IDs,以及 App activity > App interactions:已收集、不共享、用于分析、不与用户关联;此外还需声明您应用其他部分收集的数据。README 对每个答案都有说明。