PromptSurge

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 台设备上只显示原生界面的预热期。

查看集成文档 →

在手机上

用户看到的三个步骤

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

  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 台设备预热期

新应用先只显示原生界面,因此基线先行建立。

每日商店快照

对于已添加商店链接的应用,每天一次记录您在各商店的平均评分和评分数量。

常见问题

支持哪些 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 中有对应表格。

iOS 应用中两次调用,其余都在控制台完成

免费计划,无需信用卡。创建应用,复制其 API 密钥,然后发布。

创建免费账户 →

已有账户? 登录