本指南介绍如何创建和使用模板。有关性能跟踪的详细信息,请参阅 模板分析。
创建模板
模板可以通过多种方式创建:仪表板
转到 消息 > 模板 并点击 新模板。
API
使用创建模板 API 以编程方式创建模板。
电子邮件模板转发
从其他电子邮件平台迁移电子邮件模板。
应用间复制 API
在 OneSignal 应用之间移动模板。如果您让别人在另一个应用中创建模板然后移动到您的生产应用,这非常有用。
注意: 这是一次性复制,不是实时同步。
设计指南
模板支持 Liquid 语法 进行 高级个性化,让您可以插入动态、用户特定的内容。模板数据可以被覆盖。您可以将模板作为起点,并在发送之前按消息基础更新内容。
使用模板发送消息
您可以通过多种方式发送模板:- 从编写屏幕: 在仪表板中创建新消息时,选择从模板开始。
- 从模板页面: 转到 消息 > 模板,选择 选项(三个点)> 新消息。
- API: 在您的 发送请求 中包含
template_id
。
模板 ID
每个模板都有一个由 OneSignal 生成的唯一template_id
(UUID v4)。您可以通过以下方式找到它:
- 使用 View Templates API
- 在 OneSignal 控制台中在 消息 > 模板 > 选项 > 复制模板 ID 下

复制模板 ID
跟踪性能
模板页面显示使用该模板的所有发送的聚合性能。此页面上的数据是模板的整个生命周期数据。 有关单个模板性能,请参阅 模板分析。列 | 描述 |
---|---|
名称 | 模板的名称。 |
标签 | 可用于对模板进行分组和过滤的唯一 标签。 |
类型 | 推送、电子邮件或 SMS。 |
最后发送 | 模板最后一次用于已发送消息的日期和时间。 |
已投递 | 推送:成功发送到推送服务(FCM、APNs 等)的总数 电子邮件:成功投递到收件人收件箱的总数。 SMS:成功发送到 SMS 运营商的总数。 |
已打开 | 推送:不适用。 电子邮件:电子邮件被打开的总次数(非唯一)。 SMS:不适用。 |
已点击 | 推送:推送被点击的总次数。 电子邮件:电子邮件中链接被点击的总次数。 SMS:SMS 中链接被点击的总次数。 |
点击率 | (已点击 ÷ 已投递)× 100% 。 |
更新模板
您可以通过以下方式更新模板:- 仪表板: 转到 消息 > 模板 > 选项 > 编辑。
- API: 使用 更新模板 API。
content
,它将覆盖模板消息。
删除模板
您可以通过以下方式删除模板:- 仪表板: 转到 消息 > 模板 > 选项 > 删除。
- API: 使用 删除模板 API。
一旦模板被删除,与其相关的所有数据都将被删除并无法恢复。您无法删除在旅程中使用的模板。请删除旅程或从旅程中移除模板。
常见问题
模板数据存储多久?
我可以在应用间复制模板吗?
可以:- 对于任何模板类型,使用 将模板复制到另一个应用 API。
- 对于电子邮件,特别使用 电子邮件模板转发。