> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 模板

> 在 OneSignal 中为推送通知、电子邮件和短信创建、发送和跟踪可重复使用的模板，支持 Liquid 个性化和聚合性能指标。

模板是推送通知、电子邮件和短信消息的可重复使用的蓝图。它们确保消息的一致性，并集中跨发送的性能指标。模板特别适用于**频繁发送**、**事件驱动**或**交易性**消息。

<Card title="模板分析" icon="chart-bar" href="./template-analytics">
  查看每个模板的投递统计、参与度指标和每位收件人的活动。
</Card>

***

## 创建模板

模板可以通过多种方式创建：

<Columns cols={2}>
  <Card title="仪表板" icon="browser">
    转到 **Messages > Templates** 并点击 **New Template**。
  </Card>

  <Card title="API" icon="code" href="/reference/create-template">
    使用创建模板 API 以编程方式创建模板。
  </Card>

  <Card title="电子邮件模板转发" icon="envelope" href="./email-template-forwarding">
    从其他电子邮件平台迁移电子邮件模板。
  </Card>

  <Card title="应用间复制" icon="copy" href="/reference/copy-template-to-another-app">
    在 OneSignal 应用之间复制模板（一次性复制，不是实时同步）。
  </Card>
</Columns>

### 设计指南

模板支持 [Liquid 语法](./using-liquid-syntax) 进行 [高级个性化](./message-personalization)，让您可以插入动态、用户特定的内容。

有关特定渠道的最佳实践，请参阅：

<Columns cols={2}>
  <Card title="推送通知设计" icon="bell" href="./push">
    推送通知设计、功能和平台选项。
  </Card>

  <Card title="SMS 消息" icon="comment-sms" href="./sms-messaging">
    SMS 设计、功能和合规要求。
  </Card>

  <Card title="电子邮件 HTML 设计" icon="code" href="./design-emails-with-html">
    使用完整的 HTML 和 CSS 控制构建电子邮件。
  </Card>

  <Card title="电子邮件拖拽设计" icon="pen-ruler" href="./design-emails-with-drag-and-drop">
    使用拖放编辑器可视化构建电子邮件。
  </Card>
</Columns>

***

## 使用模板发送消息

您可以通过多种方式发送模板：

* **从编写屏幕：** 在仪表板中创建新消息时，选择从模板开始。
* **从模板页面：** 转到 **Messages > Templates**，选择 **选项（三个点）> New Message**。
* **API：** 在您的 [发送请求](/reference/create-message) 中包含 `template_id`。

<Note>
  对于 SMS/RCS 模板，您需要选择一个发送方，所显示的编辑器取决于该发送方：当发送方具有 RCS 资源时，您将看到 RCS 编辑器，否则将看到 SMS 编辑器。选择具有已批准 RCS 资源的发送方后，OneSignal 会自动为使用该发送方的所有现有自动化优先采用 RCS。有关现有 SMS 内容如何映射到 RCS 的信息，请参阅 [将现有自动化升级到 RCS](./sms-composing-messages#upgrading-existing-automations-to-rcs)。
</Note>

### 模板 ID

每个模板都有一个由 OneSignal 生成的唯一 `template_id`（UUID v4）。您可以通过以下方式找到它：

* 使用 [View Templates API](/reference/view-templates)
* 在 OneSignal 控制台中在 **消息 > 模板 > 选项 > 复制模板 ID** 下

<Frame caption="复制模板 ID">
  <img src="https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/dashboard/templates/copy-template-id.png?fit=max&auto=format&n=ciRrThfP6xMpI7GY&q=85&s=b1b94df3f7ad6cdc5dc985e5c2f7ffeb" alt="在 OneSignal 控制台中复制模板 ID" width="2208" height="1038" data-path="images/dashboard/templates/copy-template-id.png" />
</Frame>

***

## 跟踪性能

**Templates** 页面显示使用该模板的所有发送的聚合生命周期性能。

| 列        | 描述                                    |
| -------- | ------------------------------------- |
| **名称**   | 模板的名称。                                |
| **标签**   | 用于分组和过滤模板的 [标签](./labels)。            |
| **类型**   | 推送、电子邮件或 SMS。                         |
| **最后发送** | 模板最后一次用于已发送消息的日期和时间。                  |
| **已投递**  | 总成功投递数（到推送服务器、收件人收件箱或 SMS 运营商，取决于渠道）。 |
| **已打开**  | 电子邮件总打开次数（包含重复打开）。不适用于推送或 SMS。        |
| **已点击**  | 通知或电子邮件/SMS 中链接的总点击次数。                |
| **CTR**  | （已点击 ÷ 已投递）× 100%。                    |

有关每次发送的投递统计、参与度细分和受众活动：

<Card title="模板分析" icon="chart-bar" href="./template-analytics">
  包含渠道特定指标和可导出受众数据的详细每模板报告。
</Card>

***

## 更新模板

您可以通过以下方式更新模板：

* **仪表板：** 转到 **Messages > Templates > Options > Edit**。
* **API：** 使用 [更新模板 API](/reference/update-template)。

更新模板不会重置其性能统计。新链接将与现有数据一起被跟踪和聚合。

模板字段可以按消息覆盖。您可以将模板作为起点，并在发送之前更新内容。

例如，如果您的推送模板有一个设定的消息，并使用 [创建推送 API](/reference/push-notification) 带有新的 `content`，它将仅在该次发送中覆盖模板消息。

***

## 删除模板

您可以通过以下方式删除模板：

* **仪表板：** 转到 **Messages > Templates > Options > Delete**。
* **API：** 使用 [删除模板 API](/reference/delete-template)。

<Warning>
  一旦模板被删除，与其相关的所有数据都将被删除并无法恢复。

  您无法删除在旅程中使用的模板。请删除旅程或从旅程中移除模板。
</Warning>

***

## 常见问题

### 模板数据存储多久？

模板内容在模板的整个生命周期内存储——直到您将其删除。**Templates** 页面上的聚合分析也是生命周期数据。单次发送级别的分析遵循您的计划保留政策。有关详情，请参阅 [模板分析](./template-analytics)。

### 我可以在应用间复制模板吗？

可以。对于任何模板类型，使用 [将模板复制到另一个应用 API](/reference/copy-template-to-another-app)。对于电子邮件，您还可以使用 [电子邮件模板转发](./email-template-forwarding)。

### 更新模板会影响过去的消息吗？

不会。过去的消息保留其发送时的内容。只有未来的发送才会使用更新后的模板。性能统计不会重置。

### 我可以对多个渠道使用同一个模板吗？

不可以。每个模板绑定到单一渠道——推送、电子邮件或 SMS。请为每个渠道创建单独的模板。

### 通过 API 发送时可以覆盖模板内容吗？

可以。在您的 [创建消息](/reference/create-message) 请求中，将 `template_id` 与 `contents`、`headings` 或 `email_body` 等字段一起包含。API 字段仅对该次发送覆盖相应的模板字段。

## 相关页面

<Columns cols={2}>
  <Card title="消息个性化" icon="user-pen" href="./message-personalization">
    使用标签、Liquid 语法和自定义事件属性个性化模板。
  </Card>

  <Card title="Liquid 语法" icon="code" href="./using-liquid-syntax">
    OneSignal 消息中 Liquid 模板的完整参考。
  </Card>

  <Card title="旅程" icon="route" href="./journeys-overview">
    在自动化多渠道消息流中使用模板。
  </Card>

  <Card title="标签" icon="tag" href="./labels">
    使用自定义标签组织和过滤模板。
  </Card>
</Columns>