> ## 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 中查看推送通知、电子邮件和短信模板的投递统计、参与度指标和受众活动。

模板分析可以了解您的推送通知、电子邮件和短信模板的表现——包括投递率、参与度指标和每位收件人的活动。在仪表板中点击任意模板即可打开模板报告。要修改模板，请点击**编辑**。

<Note>
  数据保留始于 2025 年 4 月 16 日。报告最多存储两年的模板分析数据，具体取决于您的[价格计划](https://onesignal.com/pricing)。
</Note>

***

## 如何访问和使用模板分析

<Steps>
  <Step title="转到模板">
    在您的 OneSignal 仪表板中，导航到 **Messages > Templates**

    选择正在使用的模板或创建新模板并发送测试消息。
  </Step>

  <Step title="查看分析和统计数据">
    模板报告显示关键性能指标和投递统计数据，按渠道（推送、邮件或 SMS）组织。

    使用这些指标来监控参与度、排除投递问题并评估模板有效性。
  </Step>

  <Step title="编辑或导出数据">
    要修改模板，请点击报告顶部的**编辑**按钮。

    使用**导出**按钮下载详细的活动日志。
  </Step>
</Steps>

***

## 按渠道的模板统计数据

每个消息渠道都提供独特的、特定于渠道的分析，帮助您了解投递和参与情况。以下是每个渠道可用指标的摘要。有关所有渠道的完整指标定义，请参阅[指标词汇表](./analytics-metrics-glossary)。

<Tabs>
  <Tab title="推送">
    #### 统计摘要

    | 名称           | 描述                                                                             |
    | ------------ | ------------------------------------------------------------------------------ |
    | 已投递          | 成功发送到推送服务器（FCM、APNs、HMS）的消息数量。                                                 |
    | 点击率 (CTR)    | （总点击数 / 已投递数）× 100%。                                                           |
    | 确认点击率 (CCTR) | （总点击数 / 确认已投递数）× 100%。                                                         |
    | 影响打开数        | 在影响时间段内打开应用而未直接点击通知的用户。可在 **Settings > Push & In-app > Influenced Opens** 中配置。 |

    #### 投递统计

    | 名称   | 描述                                                                                                                                                              |
    | ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | 已发送  | 从 OneSignal 发送的消息总数（包含失败数量）。                                                                                                                                    |
    | 已投递  | 成功发送到推送服务器（FCM、APNs、HMS）的消息数量。                                                                                                                                  |
    | 已确认  | 返回投递确认的设备数量。多种因素可能影响此计数——请参阅[确认投递](./confirmed-delivery)。                                                                                                       |
    | 取消订阅 | 无法访问的设备数量，通常是因为推送权限被撤销。检测到的设备将被标记为已取消订阅，并从后续发送中排除。旧令牌也可能过期——请参阅 [FCM 过期令牌](./fcm-expired-token-faq)和[取消订阅原因](./push-notification-message-reports#unsubscribed)。 |
    | 失败   | 由于错误导致消息无法发送。常见原因请参阅[推送错误参考](./push-notification-message-reports#failed)。                                                                                       |
    | 剩余   | 正在排队等待发送的通知数量。                                                                                                                                                  |
    | 限制   | 由于[频率限制](./frequency-capping)而未发送的通知数量。                                                                                                                         |

    #### 转化统计

    <Info>
      **即将推出** — [转化指标](./conversion-metrics)将在模板报告中提供。一旦可用，您将看到从该模板发送的所有消息中汇总的已归因转化和影响转化。
    </Info>

    #### 结果统计（旧版）

    <Warning>自定义结果正在被弃用，并被[转化指标](./conversion-metrics)取代。</Warning>

    | 名称    | 描述                                                                                   |
    | ----- | ------------------------------------------------------------------------------------ |
    | 点击    | 推送消息的直接点击/打开数量。始终通过直接归因进行测量。                                                         |
    | 确认投递  | 返回投递确认的设备数量。请参阅[确认投递](./confirmed-delivery)。[需要付费计划](https://onesignal.com/pricing)。 |
    | 会话    | 归因于此推送的应用会话计数或累计时长（秒）。应用失去焦点 30 秒以上后才会开始新会话。[需要专业计划](https://onesignal.com/pricing)。 |
    | 自定义结果 | 在应用代码中配置的自定义指标，如购买金额或用户行为。请参阅[自定义结果](./custom-outcomes)。                             |
  </Tab>

  <Tab title="邮件">
    #### 统计摘要

    | 名称        | 描述                                                                            |
    | --------- | ----------------------------------------------------------------------------- |
    | 打开率       | （唯一打开数 / 投递数）× 100%。用户隐私设置可能影响打开跟踪——请参阅[为什么打开事件很低？](#why-are-open-events-low) |
    | 点击率 (CTR) | （唯一点击数 / 投递数）× 100%。需要[启用点击跟踪](./unsubscribe-links-email-subscriptions)。      |
    | 取消订阅      | 通过此邮件的取消订阅链接退出的收件人数量。订阅在接收到事件后立即被标记为已取消订阅。                                    |

    #### 投递统计

    | 名称   | 描述                                                                                    |
    | ---- | ------------------------------------------------------------------------------------- |
    | 受众   | 发送时包含在受众中的邮件地址数量。                                                                     |
    | 已发送  | 从 OneSignal 发送的消息总数。                                                                  |
    | 已投递  | 确认成功投递到收件人收件箱的消息数量。                                                                   |
    | 剩余   | 正在排队等待发送的消息数量。                                                                        |
    | 总点击数 | 链接的总点击数，包括对同一链接的重复点击。请参阅 [URL、链接和深层链接](./links)。                                      |
    | 总打开数 | 邮件被打开的总次数，包括重复打开。隐私设置可能影响此数据——请参阅[为什么打开事件很低？](#why-are-open-events-low)               |
    | 取消订阅 | 通过取消订阅链接退出的收件人数量。订阅立即被标记为已取消订阅。                                                       |
    | 退信   | 邮件无法投递——常见原因包括地址无效、收件箱已满、发件人声誉差或严格的 DMARC 记录。退信地址会被添加到[抑制列表](./email-deliverability)。 |
    | 失败   | OneSignal 无法投递邮件并将消息丢弃。请参阅[为什么邮件被标记为失败？](#why-are-my-emails-marked-as-failed)         |
    | 已抑制  | 由于之前的垃圾邮件举报或退信而未发送的邮件，以保护发件人声誉。仅适用于 [OneSignal 邮件](./email-setup)。                    |
  </Tab>

  <Tab title="SMS">
    #### 摘要统计

    | 名称     | 描述                   |
    | ------ | -------------------- |
    | 投递率    | （总投递数 ÷ 总发送数）× 100%。 |
    | 失败和拒绝率 | （总失败数 ÷ 总发送数）× 100%。 |

    #### 投递统计

    | 名称  | 描述                                              |
    | --- | ----------------------------------------------- |
    | 受众  | 发送时包含在受众中的电话号码数量。                               |
    | 已发送 | 消息已成功发送给运营商。*这并不一定意味着用户已收到这些消息。*                |
    | 已投递 | OneSignal 已从运营商那里收到消息投递确认。*这并不一定意味着收件人已收到这些消息。* |
    | 失败  | 消息发送失败。                                         |
    | 已抑制 | 消息未发送给收件人，因为他们选择不接收来自发送者的消息。                    |
    | 被拒绝 | 由于号码封锁、速度封锁或收件人在封锁列表中，运营商未投递消息。                 |
  </Tab>
</Tabs>

***

## 受众活动

受众活动报告为您提供每个收件人与您消息互动的详细分解。这帮助您对用户进行分段以进行重定向，并了解订阅健康状况。

<Tabs>
  <Tab title="推送">
    * 列出每个设备订阅及其投递结果（已发送、已确认、已点击、失败、取消订阅等）。
    * 点击**导出**下载完整的订阅列表。
    * 如果某行的设备列中有 "()"，这意味着此订阅已被删除。
  </Tab>

  <Tab title="邮件">
    显示每个邮件地址订阅的状态：已投递、已打开、已点击、已取消订阅、退信、失败或投诉。时间戳反映最近的事件。

    * **导出**活动数据，包含失败消息原因等全部信息。
    * 基于活动数据**重定向**用户进行后续跟进。更多详细信息请参阅[重定向消息](./retargeting)。
  </Tab>

  <Tab title="SMS">
    受众活动显示已发送、已投递或未能接收 SMS 的订阅列表。更多详细信息请参阅[重定向消息](./retargeting)。
  </Tab>
</Tabs>

<Warning>
  对于所有渠道，受众活动在消息显示后 30 天内可用。
</Warning>

***

## 常见问题

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

模板数据遵循标准分析数据保留政策——最多两年，具体取决于您的计划。有关详细信息，请参阅[分析数据保留](./billing-faq#analytics-data-retention)。

### 为什么打开事件很低？

电子邮件打开跟踪依赖于收件人打开邮件时加载的跟踪像素。许多电子邮件客户端和隐私功能（Apple Mail 隐私保护、Gmail 图片代理）会屏蔽或预取此像素，导致打开率偏低。点击跟踪通常作为参与度信号更为可靠。

### 为什么我的邮件被标记为失败？

"失败"邮件意味着 OneSignal 无法投递消息并将其丢弃。常见原因包括：

* 收件人的电子邮件地址无效或拼写错误
* 收件人的邮箱已满
* 接收服务器拒绝了该消息（例如，由于内容过滤或发件人声誉）
* 您的发送域名存在 DNS 或身份验证问题（SPF、DKIM、DMARC）

如果您发现高失败率，请检查您的[邮件可投递性设置](./email-deliverability)和发送域名配置。

### "已抑制"是什么意思？

被抑制的消息是 OneSignal 有意保留的，因为收件人以前将您的邮件举报为垃圾邮件或其地址发生了硬退信。这可以保护您的发件人声誉。有关详细信息，请参阅[抑制](./suppressions)。

### 我可以导出受众活动数据吗？

可以。点击受众活动部分中的**导出**按钮，下载包含每位收件人投递结果（包括失败原因和时间戳）的 CSV 文件。

## 相关页面

<Columns cols={2}>
  <Card title="指标词汇表" icon="book" href="./analytics-metrics-glossary">
    所有渠道分析指标的完整定义。
  </Card>

  <Card title="消息报告" icon="chart-bar" href="./push-notification-message-reports">
    单条推送消息的投递和参与度报告。
  </Card>

  <Card title="邮件可投递性" icon="envelope-circle-check" href="./email-deliverability">
    提高投递率，管理退信、垃圾邮件举报和发件人声誉。
  </Card>

  <Card title="模板" icon="copy" href="./templates">
    跨渠道创建和管理可复用的消息模板。
  </Card>

  <Card title="确认投递" icon="circle-check" href="./confirmed-delivery">
    确认投递跟踪的工作原理及影响计数的因素。
  </Card>

  <Card title="频率限制" icon="gauge-high" href="./frequency-capping">
    限制用户接收消息的频率以减少疲劳。
  </Card>
</Columns>