跳转到主要内容
本页面是示例应用:完整的 OneSignal 集成的一部分,该指南从头到尾跟随一个真实应用。这个应用是 Clean Beans,一款面向合租家庭的打扫值日表应用,使用 Expo(React Native)和 Supabase 后端构建。 应用内消息会在用户使用应用时显示。它们的内容、受众和计划都保存在 OneSignal 仪表板中,因此无需发布新版本即可更改。Clean Beans 将它们用于五项工作。

触发器:由应用决定时机 \

触发器是应用设置的一个键和值。所有配置为与之匹配的应用内消息都会显示。Clean Beans 的每个界面在标题栏都有一个帮助按钮,它会以界面名称作为值设置一个触发器。
src/components/HelpButton.tsx
app/(tabs)/_layout.tsx
一个触发器键服务于十三个界面。为新界面添加帮助,只需添加一个带新值的按钮,并在仪表板中创建一条消息。
显示在仪表板上方的帮助浮层应用内消息

点击仪表板上的帮助按钮会显示帮助浮层。

仪表板设置。 在 Messages > In-App 中,创建一条触发器为 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
仪表板设置。 创建一个筛选条件为 App version 小于当前版本的细分,并将其用作消息的受众。每次发布新版本时更新该筛选条件。
标签替换适用于 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 周显示一次。
Apple 每年对每位用户最多显示三次评分面板,Google 也有自己的限制,因此点击按钮并不保证一定会显示任何内容。TestFlight 构建中永远不会出现评分面板。请使用 App Store 构建测试此流程。

应用内触发器

触发器类型及其组合方式。

HTML 应用内消息

使用您自己的 HTML 设计消息。

应用内 JavaScript API

所有 OneSignalIamApi 方法。