Unity SDK
Unity 应用内评价弹窗:一次 C# 调用支持 iOS 和 Android
PromptSurge Unity 版是一个 UPM 包,它会在您的游戏中显示一个简短的品牌化引导对话框,然后打开原生评价界面:iOS 上是 StoreKit,Android 上是 Google Play 应用内评价。在关卡结束后调用 RequestReview();文案、主题、标题图片和语言均来自服务器。
免费计划 · Unity 2022.3 LTS+ · iOS 和 Android
1 · 您的引导对话框
请您帮个小忙
我们在离线同步上下了很大功夫。一条简短的评价能帮助更多人发现这款应用。
2 · 原生评分界面
App Store 或 Google Play
Apple 或 Google 自己的界面,原样显示
Unity SDK 为您做了什么
两个商店,一次调用
PromptSurge.RequestReview() 通过轻量的原生桥接层,在 iOS 上打开 SKStoreReviewController,在 Android 上打开 Play 应用内评价。使用 External Dependency Manager 时,Play 依赖会自动解析;不使用它时,只需添加一行 Gradle 配置。
专为游戏 UI 打造
对话框是用代码构建的 UGUI 覆盖层,使用您的颜色和标题图片。如果场景中没有 EventSystem,它会自动创建一个;点击卡片外部或按 Android 返回键即可关闭;在准备就绪之前保持隐藏,因此加载缓慢的图片绝不会阻塞输入。
在编辑器中保持静默
在 Play Mode 中,每次调用都被刻意设计为空操作:没有对话框、没有原生界面、没有计费事件,也不会向 PlayerPrefs 写入任何内容。构建到设备上即可看到效果。
支持 IL2CPP
该包附带 link.xml 和 [Preserve] 特性,因此 Medium 或 High 级别的托管代码裁剪不会移除 SDK 所需的内容。
内置所有资格检查
会先检查退出设置、每台设备 90 天的冷却时间、10% 对照组、50 台设备的预热期以及您计划的每月上限。当引导对话框因预热期、对照组或上限用完而不显示时,原生界面仍会打开,这个时机不会浪费。
集成方式
在 Window > Package Manager > + > Add package from git URL 中添加该包,使用文档中固定版本的 URL。然后初始化一次,并在您选择的时机调用 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 上,Play 的评价库会通过 EDM4U 自动引入;不使用 EDM4U 时,请在 mainTemplate.gradle 中添加 implementation 'com.google.android.play:review:2.0.1'。集成期间,PromptSurge.SetLogLevel(LogLevel.Info) 会为每次决策打印一行日志。
用户看到的三个步骤
同样的用户,同样的时机。区别在于先用关于您应用的话向他们提出请求。
行程已保存
可离线使用
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 台设备预热期
新应用先只显示原生界面,因此基线先行建立。
每日商店快照
对于已添加商店链接的应用,每天一次记录您在各商店的平均评分和评分数量。
常见问题
支持哪些 Unity 版本?
Unity 2022.3 LTS 及更高版本。较旧的 LTS 版本或许可以运行,但未经编译验证,也不受支持。Android 构建需要通过 Play 商店分发,且需要 minSdkVersion 21;iOS 构建需要 iOS 14。
为什么在编辑器中什么都不发生?
这是有意设计的。在 Play Mode 中每个入口都是空操作,因此测试永远不会产生计费展示,也不会填充 PlayerPrefs。请构建到设备上;对于新应用,还要考虑到 50 台设备的预热期,测试期间可以在控制台中将其关闭。
QA 能多次看到对话框吗?
可以。PromptSurge.SetRateLimitBypass(true) 会关闭该设备上的冷却时间。该设置保存在 PlayerPrefs 中,开启期间每次检查都会记录一条警告,因此切勿在发布的构建中调用它。
两个商店都允许使用引导对话框吗?
两个商店都要求评分本身在它们自己的界面中完成,而 SDK 只会打开这些界面:iOS 上的 StoreKit 和 Android 上的 Play 应用内评价,均原样呈现。Apple 的指南 5.6.1 不允许自定义评价弹窗,Google 也要求应用不要在其卡片之前向用户提出任何问题。引导对话框从不询问玩家的感受或他们会打几分,而以陈述句表达的标题根本不会提出任何问题。两个商店还都不建议通过按钮点击打开其界面,因为上限可能导致界面不显示;当前的 SDK 版本会在该上限很可能已用完时跳过引导对话框,iOS 和 Android 分别计算。每个商店如何审核某款具体游戏,由该商店决定。
商店怎么说,以及给 App Review 的备注(英文文档)→费用是多少?
Indie 计划永久免费:一个应用,每月 500 次引导对话框展示,无需信用卡。Startup 为每个应用每月 €39(按年计费为 €31),每月 10,000 次展示,并可使用自定义标题图片。Growth 为每个应用每月 €99,Unlimited 为每个应用每月 €249。每个应用有自己的计划;计划决定了您的组织可以创建多少个应用。一次提示展示即显示一次引导对话框;原生评价界面和对照组设备不计入。价格含税(欧元)。