应用内评分对话框 API
在最佳时机请求用户进行 App Store 评分——从您的 Web 应用触发 iOS 原生评分对话框。
App Store 上的好评是应用增长最有力的驱动因素之一。WebViewGold 的应用内评分对话框 API 让您可以在最合适的时机请求用户评分——例如在成功购买后,或用户在您的 Web 应用中完成某项任务之后。
方式 1:原生 iOS 评分对话框(默认)
通过 HTML 链接或 JavaScript 调用以下 URL,以显示原生的 SKStoreReviewController 评分对话框:
<a href="rateapp://">喜欢这个应用吗?给我们评分吧!</a>
window.location.href = "rateapp://";
注意:Apple 限制了原生评分对话框的显示频率(每位用户每年约三次),因此它可能不会在每次调用时都出现——这是有意为之,在开发期间也同样适用。
方式 2:自定义评分对话框
如果您希望对话框始终显示,并将用户引导至您的 App Store 页面,请在 Config.swift 中进行配置:
showcustomrateappdialog— 设置为true,在触发rateapp://时显示自定义评分对话框,而不是尝试原生评分调用。ratemyappurl— 设置您应用的 App Store URL,例如https://apps.apple.com/app/idXXXXXXXXX?action=write-review。
典型使用场景:
- 在积极互动(完成订单、升级、预订成功)之后立即请求评价。
- 先在您的网站上展示自己的“您喜欢这个应用吗?”流程,只将满意的用户引导至
rateapp://。
SDK 风格的实现说明
将此功能视为向 Web 层公开的原生能力:将生产网站或 PWA 作为唯一可信来源,然后使用文档中的 WebViewGold 配置标志、URL 命令和 JavaScript 桥接调用,仅在能够带来价值的地方启用原生 iOS 行为。这种方式让代码库易于维护,因为同一个 Web 应用只需极少的条件逻辑即可同时服务于浏览器、WebViewGold for iOS 以及其他 WebViewGold 平台。
为获得可靠的结果,建议优先使用 HTTPS 端点、稳定的路由名称、在界面中明确的成功/错误状态,以及封装原生调用的小型 JavaScript 辅助函数。例如,使用 jQuery Mobile、Lovable、Base44、Bolt、WordPress、Bubble、自定义 React/Vue/Angular 技术栈或静态 HTML 构建的 Web 应用,可以提供单个按钮或事件处理程序来触发原生 WebViewGold API,同时仍为浏览器提供优雅的回退方案。
- 推荐的集成模式:检测应用上下文,调用 WebViewGold API,然后在原生回调或路由变更后更新 Web 界面。
- 测试清单:在真机或打包构建上验证该功能,检查权限和商店审核文案,并确认仅使用浏览器的用户仍能获得有用的回退方案。
- SEO 优势:让功能页面、路由标题和结构化内容在您的网站上保持可被索引,同时由 WebViewGold 为 iOS 用户提供原生应用外壳。