Skip to main content
使用这些复制粘贴HTML模板来更快地构建自定义OneSignal应用内消息。 我们的应用内消息HTML编辑器让您可以使用HTML、CSS和JavaScript完全控制应用内消息的布局和行为。该编辑器不包含内置模板,但此页面提供可直接使用的示例,您可以粘贴到编辑器中并进行自定义。
这些模板在应用内消息webview中运行。要关闭消息、打开URL、标记用户和捕获点击,请使用应用内消息JS API

先决条件

在开始之前,我们建议您查看:
不要在模板代码中放置机密信息(API密钥、令牌)。将所有应用内消息输入视为不可信的,并在您的应用或后端中验证。

如何使用模板

  1. 在OneSignal中,转到消息 > 应用内 > 新建应用内消息
  2. 选择HTML编辑器
  3. 在下面找到一个模板。
  4. 从代码块中复制完整的HTML并粘贴到编辑器中。
  5. 更新占位符(URL、端点、日期和文案)。
  6. 在真实设备上测试,然后发布。

可用模板

email-form

邮箱收集表单

询问用户的邮箱并通过点击名称发送到您的应用。
sms-form

手机号码收集表单

询问并获得发送短信的同意。包含E.164格式的电话号码,并通过点击名称发送到您的应用。
checklist-survey

清单调查

多选调查,您可以发送到后端或转换为标签。
count_down

倒计时

用于时效性促销的倒计时器。
promo-wheel

促销转盘

转盘赢奖促销体验(自定义促销处理)。
quiz_modal

测验模态框

可以根据用户得分标记用户的测验体验。
ranking-survey

评分调查

1-5分评分调查(发送到您的端点或标记用户)。
ui-ui

音频/视频播放器

直接MP3文件的简单音频预览UI。
vertical-swiping

垂直滑动

多张幻灯片垂直滑动引导或功能介绍。

邮箱表单

通过应用内消息收集邮箱订阅 此表单工作原理:
  1. 用户输入邮箱地址并勾选同意框。
  2. 提交时,调用OneSignal的创建用户API在您的应用中创建邮箱订阅。
  3. 另外,模板调用OneSignalIamApi.addClickName(e, email)将邮箱地址传递给我们SDK的应用内消息点击监听器。
  4. 在您的应用内,您可以添加应用内消息点击监听器来读取点击名称并将邮箱传递给我们SDK的addEmail方法。
您可能会注意到步骤2和步骤4都涉及创建邮箱订阅。
  • 步骤2不需要直接在应用中添加代码,但如果您调用了login方法,也不会将邮箱订阅添加到用户。
  • 步骤4需要额外的代码(应用内消息点击监听器),但如果您调用了login方法,也会将邮箱订阅添加到用户。
**将YOUR_APP_ID替换为在设置 > 密钥和ID中找到的OneSignal应用ID。
步骤4的要求:
  1. 在您的HTML提交处理器中保留addClickName调用。
  2. 使用我们SDK的应用内消息点击监听器读取输入。
  3. 当点击名称看起来像邮箱时,在应用内消息点击监听器中调用addEmail方法。
使用应用内消息点击监听器和addEmail方法的示例:

短信表单

通过应用内消息收集短信订阅 此表单工作原理:
  1. 用户选择国家代码,输入10位数字号码,并勾选同意框。
  2. 提交时,调用OneSignal的创建用户API在您的应用中创建短信订阅。
  3. 另外,模板调用OneSignalIamApi.addClickName(e, e164Phone)将电话号码传递给我们SDK的应用内消息点击监听器。
  4. 在您的应用内,您可以添加应用内消息点击监听器来读取点击名称并将电话号码传递给我们SDK的addSms方法。
您可能会注意到步骤2和步骤4都涉及创建短信订阅。
  • 步骤2不需要直接在应用中添加代码,但如果您调用了login方法,也不会将短信订阅添加到用户。
  • 步骤4需要额外的代码(应用内消息点击监听器),但如果您调用了login方法,也会将短信订阅添加到用户。
**将YOUR_APP_ID替换为在设置 > 密钥和ID中找到的OneSignal应用ID。

清单调查

将调查结果发布到您的后端的多选调查。
  • handleSurveyAnswer() 中设置您的端点。
  • 更新复选框 name 值和标签以匹配您的问题。
如果您保留 var url = "",请求将失败。设置一个真实的端点或用标记替换 fetch()(下面的示例)。
可选:给用户打标签而不是调用您的后端 在提交处理程序中用以下代码替换 handleSurveyAnswer(answers) 调用:

倒计时

为限时优惠和促销活动创造紧迫感的倒计时器。自定义结束日期和重定向 URL 以匹配您的活动。
  • endtime 更新为未来的日期/时间。
  • 更新 openUrl 目标 URL。
此模板中的样本 endtime 是过去的日期(2025 年 3 月 25 日)。如果您不更新它,用户将立即触发”已结束”逻辑。