触发器:由应用决定时机 \
触发器是应用设置的一个键和值。所有配置为与之匹配的应用内消息都会显示。Clean Beans 的每个界面在标题栏都有一个帮助按钮,它会以界面名称作为值设置一个触发器。src/components/HelpButton.tsx
app/(tabs)/_layout.tsx

点击仪表板上的帮助按钮会显示帮助浮层。
help_topic is dashboard 的消息,并为每个界面重复此操作。多步骤引导使用相同的触发器和轮播布局。

以卡片轮播形式构建的多步骤引导。
自定义 HTML 消息 \
帮助浮层用 HTML 编写,因此与应用的设计完全一致。HTML 应用内消息通过OneSignalIamApi 对象与 SDK 通信。每个可点击元素都适用两条规则:
- 为其设置唯一的
data-onesignal-unique-label,以便正确跟踪点击。 - 为其绑定一个调用
OneSignalIamApi方法的监听器。普通链接不会被跟踪。
docs/iam-html/help-dashboard.html
推送权限预提示 \
系统权限对话框只能显示一次。先显示一条应用内消息可以说明用户将收到什么,只有点击 Enable notifications 的人才会看到系统对话框。
预提示会在系统对话框出现之前说明好处。
docs/iam-html/push-permission-prompt.html
如果使用预提示,请从应用启动代码中移除
requestPermission() 调用。否则系统对话框会先出现,预提示就没有什么可问的了。应用更新提示 \
新版本发布后,仍在使用旧版本的用户会看到更新提示。这条消息完全不需要应用中的代码。它的受众是使用旧版应用的用户细分。
仅向使用旧版本的用户显示的更新提示。
openUrl 会跟踪点击、打开应用商店并关闭消息。
docs/iam-html/app-update-prompt.html
docs/iam-html/app-update-prompt.html
标签替换适用于 HTML 应用内消息的文本和属性,但不适用于
script 标签内部。评价提示:把点击交还给应用 \
请求应用商店评分的好时机,是在某件事顺利完成之后。当一次打扫会话让连续记录达到七天的倍数时,Clean Beans 会发出请求。 这是唯一一条点击后必须在应用中运行代码的应用内消息,因为原生评分面板只能由应用自己打开。1
应用在连续记录里程碑设置触发器
它会等到会话界面关闭,以免提示打断打扫,并记住上次请求时的里程碑。
src/lib/reviewPrompt.ts
2
消息将点击名称发回应用
addClickName 会将名称传给应用的点击监听器。它不会关闭消息,因此脚本随后会关闭消息。docs/iam-html/review-prompt.html
3
应用打开原生评分面板
点击监听器检查名称,并请求系统显示评分面板。
src/lib/reviewPrompt.ts
app/_layout.tsx

评价提示应用内消息。
ask_for_review is show 的 HTML 应用内消息。将其计划设置为最多每 17 周显示一次。
应用内触发器
触发器类型及其组合方式。
HTML 应用内消息
使用您自己的 HTML 设计消息。
应用内 JavaScript API
所有
OneSignalIamApi 方法。