PromptSurge

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) 会为每次决策打印一行日志。

查看集成文档 →

在手机上

用户看到的三个步骤

同样的用户,同样的时机。区别在于先用关于您应用的话向他们提出请求。

  1. 行程已保存

    可离线使用

    requestReview()

    第 1 步

    时机由您的代码决定

    在某件事顺利完成之后调用 requestReview(),例如保存了行程或通过了关卡。

  2. 想请您帮个小忙

    我们在离线地图上花了很多心血。一条简短的评价能帮助其他旅行者找到这款应用。

    以后再说好的

    第 2 步

    预提示用您的话提出请求

    一条简短的消息,点出您的应用能做什么。点“以后再说”就会关闭,不会再发生别的事。

  3. 为此应用评分

    轻点星星评分

    一条提到该功能的评价

    离线地图救了我的行程,没有信号也能用。

    第 3 步

    商店自带的评分窗口

    点“好的”会原样打开商店的评分窗口。刚读到的那条消息让他们有具体的内容可写。

它为什么而做

  1. 同样的用户,更多的评价

    在您选定的时机提出请求,并给出回应的理由。

  2. 更多带文字的评价

    关于某项功能的消息会引出文字,而不只是星级。

  3. 用户用自己的话说出您的关键词

    提到应用功能的评价能告诉下一位访客这款应用适合谁。

  4. 商店会读取的信号

    Apple 和 Google 都表示,评分和评价会影响应用在搜索中的排名。

控制台会显示您的应用发生了什么变化:每天的文字评价数、星级和关键词提及,对比启用预提示之前和之后。

来源: Apple:App Store 搜索 · Google Play:应用发现与排名

工作原理

  1. 添加 SDK

    安装 iOS、Android 或 Unity 包,并在启动时调用一次 initialize()。然后在您选择的时机调用 requestReview(),例如完成一个关卡、保存一个项目或完成一笔订单之后。

  2. 打造您自己的引导对话框

    在控制台中撰写标题、消息和两个按钮标签,或让内置 AI 根据您自己的评价起草。选择一个主题,使用 Startup 及以上计划时还可添加标题图片,然后接受:文案会被翻译成 10 种语言,无需更新应用即可送达设备。

  3. 与对照组进行比较

    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。每个应用有自己的计划;计划决定了您的组织可以创建多少个应用。一次提示展示即显示一次引导对话框;原生评价界面和对照组设备不计入。价格含税(欧元)。

关卡结束后一次调用,其余都在控制台完成

免费计划,无需信用卡。创建游戏,复制其 API 密钥,然后构建到设备上。

创建免费账户 →

已有账户? 登录