> ## 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 生态系统中每个消息渠道的指标标签之间的细微差别，以准确解读消息传递性能。

## 概览

OneSignal 记录消息旅程中每个步骤的指标。此旅程从 OneSignal 开始，移至第三方提供商，最后以传递到收件人设备或收件箱结束。

本文档旨在阐明我们在消息生命周期中捕获的不同指标，以及这些指标如何在 OneSignal 生态系统中各个渠道的各个接触点中表示。在协调来源之间的数字或构建内部报告时使用这些定义。

本术语表按渠道细分。每个部分包括以下内容：

1. **术语**：在此建立指标及其定义的通用术语表。
2. **传递生命周期**：在此可视化表示传递旅程每个阶段捕获的指标。
3. **指标映射**：在此将指标名称与所有 OneSignal 接触点关联起来。

### 渠道指标比较

不同渠道包含不同的传递状态和用户参与度指标。下表列出了每个渠道的不同指标。

| 渠道   | 已发送 | 已送达 | 失败 | 被拒绝 | 剩余 | 已点击 | 已打开 | 退回 | 已读 | 已取消订阅 | 报告为垃圾邮件 | 已抑制 | 频率上限 |
| ---- | --- | --- | -- | --- | -- | --- | --- | -- | -- | ----- | ------- | --- | ---- |
| 推送   | ✅   | ✅   | ✅  | ❌   | ✅  | ✅   | ❌   | ❌  | ❌  | ✅     | ❌       | ❌   | ✅    |
| 电子邮件 | ✅   | ✅   | ✅  | ❌   | ✅  | ✅   | ✅   | ✅  | ❌  | ✅     | ✅       | ✅   | ❌    |
| 短信   | ✅   | ✅   | ✅  | ✅   | ✅  | ✅   | ❌   | ❌  | ✅  | ❌     | ❌       | ✅   | ❌    |
| 应用内  | ✅   | ❌   | ✅  | ❌   | ✅  | ✅   | ❌   | ❌  | ❌  | ❌     | ❌       | ❌   | ❌    |
| 实时活动 | ❌   | ❌   | ✅  | ❌   | ❌  | ❌   | ❌   | ❌  | ❌  | ✅     | ❌       | ❌   | ❌    |

## 推送术语

1. **已发送**：从 OneSignal 成功发送到提供商的消息数量。
2. **尝试发送总数**：我们尝试发送的消息数量。这包括成功发送到推送提供商的消息和失败的消息。这是一个**派生**指标，是在尝试发送到提供商时成功、失败和错误的总和。
3. **受众**：目标细分中的订阅数量。
4. **已送达**：确认收到通知的推送订阅数量。
5. **已取消订阅**：由于卸载应用程序、清除浏览器数据或选择退出推送且此后未打开应用程序而未收到消息的推送订阅数量。我们将**不会**在未来的消息中尝试发送到这些订阅。
6. **失败**：由于错误而未收到通知的推送订阅数量。我们将在未来的消息中尝试发送到这些订阅。
7. **已点击**：通知的点击次数。
8. **频率上限**：由于频率上限设置而未发送通知的推送订阅数量。

### 推送生命周期

```mermaid theme={null}
sequenceDiagram
    participant OneSignal
    participant Provider
    participant Platform
    participant User

    %% -----------------------------
    %% Metrics when sending to provider
    %% -----------------------------
    Note over OneSignal,User: 发送到提供商时的指标

    OneSignal--xProvider: 从传递中排除 [频率上限]
    Note left of OneSignal: 传递前排除的消息

    OneSignal-->>Provider: 发送通知
    Provider-->>OneSignal: 错误响应 [失败 / 已取消订阅]
    Note left of OneSignal: 未能发送到提供商

    %% -----------------------------
    %% Metrics reported by push provider
    %% -----------------------------
    Note over OneSignal,User: 推送提供商报告的指标

    OneSignal->>Provider: 发送通知
    Provider->>OneSignal: 提供商已接受 [已发送]
    Note left of OneSignal: 成功传递到提供商

    Provider->>Platform: 传递通知
    Platform->>OneSignal: 确认传递 [已送达]
    Note left of OneSignal: 成功传递到平台

    %% -----------------------------
    %% Metrics reported by platform
    %% -----------------------------
    Note over OneSignal,User: 平台报告的指标

    Platform->>User: 显示通知
    User->>OneSignal: 参与事件 [已点击]
    Note left of OneSignal: 用户参与度
```

### 推送指标映射

| 术语     | 控制面板 - 传递报告统计卡片 | 控制面板 - 传递报告时间序列图表 | 控制面板 - 旅程节点报告统计卡片 | 控制面板 - 旅程节点报告时间序列图表 | 控制面板 - 受众活动 | 控制面板 - 参与度趋势 | 查看消息 API<sup>1</sup> | 通知 CSV            | Event Streams             |
| ------ | --------------- | ----------------- | ----------------- | ------------------- | ----------- | ------------ | -------------------- | ----------------- | ------------------------- |
| 已发送    | 已发送、已送达         | ❌                 | 已送达               | 已送达                 | 已发送         | 已送达          | successful           | successful        | message.push.sent         |
| 尝试发送总数 | ❌               | ❌                 | 总发送数              | 已发送                 | ❌           | ❌            | ❌                    | ❌                 | ❌                         |
| 受众     | 受众              | ❌                 | ❌                 | ❌                   | ❌           | ❌            | ❌                    | ❌                 | ❌                         |
| 已送达    | 已确认             | 确认传递              | 已确认               | 已确认                 | 确认传递        | ❌            | received             | received          | message.push.received     |
| 已取消订阅  | 已取消订阅           | ❌                 | 已取消订阅             | 已取消订阅               | 已取消订阅       | 已取消订阅        | failed               | failed            | message.push.unsubscribed |
| 失败     | 失败              | ❌                 | 失败                | 失败                  | 失败          | ❌            | errored              | errored           | message.push.failed       |
| 已点击    | 已点击             | 点击次数              | ❌                 | 已点击                 | 已点击         | 已点击          | converted            | converted         | message.push.clicked      |
| 频率上限   | 已上限             | ❌                 | 已上限               | 已上限                 | ❌           | ❌            | frequency\_capped    | frequency\_capped | ❌                         |

<sup>1</sup> 我们还在 API 中包含除"剩余"之外所有指标的每个平台指标（例如 ios\_converted、android\_converted）。

## 电子邮件术语

1. **已发送**：成功发送到提供商的电子邮件数量。
2. **受众**：目标细分中的订阅数量。
3. **已送达**：确认已送达订阅者电子邮件服务器的电子邮件数量。
4. **失败**：无法送达收件箱的电子邮件数量，不包括退回。这可能包括 ESP 或 OneSignal 传递失败报告的失败。
5. **已抑制**：由于先前的退回或垃圾邮件报告而被阻止以保护发件人声誉的电子邮件数量。此指标仅记录配置为使用 OneSignal 电子邮件的应用程序。
6. **退回**：由于地址无效、收件箱已满、发件人声誉或 DMARC 问题而被拒绝的电子邮件数量。这些地址被添加到[抑制列表](/docs/cn/suppressions)，由 OneSignal 或第三方 ESP 管理。
7. **报告为垃圾邮件**：将电子邮件标记为垃圾邮件的收件人数量。这些地址被添加到[抑制列表](/docs/cn/suppressions)，由 OneSignal 或第三方 ESP 管理。
8. **已取消订阅**：选择退出接收电子邮件的收件人数量。
9. **总打开次数**：电子邮件被打开的总次数，包括重复打开。
10. **总点击次数**：电子邮件中链接被点击的总次数，包括重复点击。
11. **唯一打开次数**：打开电子邮件的单个收件人数量。此指标与确认送达一起使用以确定打开率。
12. **唯一点击次数**：点击电子邮件的单个收件人数量。此指标与确认送达一起使用以确定点击率。

**为什么我们要区分总点击次数和唯一点击次数或打开次数？**

唯一点击次数和打开次数每个订阅者仅计数一次，无论该订阅者打开或点击同一封电子邮件多少次。总点击次数和打开次数跟踪每个订阅者不是唯一的，并计算每次点击或打开电子邮件的次数。

### 电子邮件生命周期

```mermaid theme={null}
sequenceDiagram
    participant OneSignal
    participant ESP
    participant Inbox
    participant User

    %% -----------------------------
    %% Metrics when sending to ESP
    %% -----------------------------
    Note over OneSignal,User: 发送到 ESP 时的指标

    OneSignal--xESP: 从传递中排除 [已抑制]
    Note left of OneSignal: 传递前排除的消息

    OneSignal-->>ESP: 发送电子邮件
    ESP-->>OneSignal: 错误响应 [失败]
    Note left of OneSignal: 未能发送到 ESP

    %% -----------------------------
    %% Metrics reported by ESP
    %% -----------------------------
    Note over OneSignal,User: ESP 报告的指标

    OneSignal->>ESP: 发送电子邮件
    ESP->>OneSignal: ESP 已接受 [已发送]
    Note left of OneSignal: 成功传递到 ESP

    ESP-->>Inbox: 尝试传递到收件箱
    Inbox-->>OneSignal: 未能传递 [失败 / 退回]
    Note left of OneSignal: 未能传递到收件箱

    ESP->>Inbox: 传递电子邮件
    Inbox->>OneSignal: 确认传递到收件箱 [已送达]
    Note left of OneSignal: 成功传递到收件箱

    %% -----------------------------
    %% Metrics reported by User
    %% -----------------------------
    Note over OneSignal,User: 用户报告的指标
    %% Metrics reported to ESP then OS

    Inbox->>User: 显示电子邮件
    User->>OneSignal: 参与事件 [已打开 / 已点击 / 已取消订阅 / 报告为垃圾邮件]
    Note left of OneSignal: 用户参与度
```

### 电子邮件指标映射

| 术语      | 控制面板 - 传递报告统计卡片 | 控制面板 - 传递报告时间序列图表 | 控制面板 - 旅程节点报告统计卡片 | 控制面板 - 旅程节点报告时间序列图表 | 控制面板 - 受众活动 | 控制面板 - 参与度趋势 | 查看消息 API                                       | 通知 CSV                | Event Streams                    |
| ------- | --------------- | ----------------- | ----------------- | ------------------- | ----------- | ------------ | ---------------------------------------------- | --------------------- | -------------------------------- |
| 已发送     | 已发送             | 已发送               | ❌                 | 已发送                 | 已发送         | ❌            | platform\_delivery\_stats.email.successful     | successful            | message.email.sent               |
| 受众      | 受众              | ❌                 | ❌                 | ❌                   | ❌           | ❌            | ❌                                              | ❌                     | ❌                                |
| 已送达     | 已送达             | 已送达               | 已送达               | 已送达                 | 已送达         | 已送达          | platform\_delivery\_stats.email.received       | email\_delivered      | message.email.received           |
| 失败      | 失败              | 失败                | 失败                | 失败                  | 失败          | ❌            | platform\_delivery\_stats.email.failed         | email\_failed         | message.email.failed             |
| 已抑制     | 已抑制             | 已抑制               | 已抑制               | 已抑制                 | 已抑制         | ❌            | platform\_delivery\_stats.email.suppressed     | ❌                     | message.email.suppressed         |
| 退回      | 退回              | 退回                | 退回                | 退回                  | 退回          | ❌            | platform\_delivery\_stats.email.bounced        | email\_bounced        | message.email.bounced            |
| 报告为垃圾邮件 | 报告为垃圾邮件         | 垃圾邮件              | 报告为垃圾邮件           | 垃圾邮件                | 投诉          | ❌            | platform\_delivery\_stats.email.reported\_spam | email\_reported\_spam | message.email.reported\_as\_spam |
| 已取消订阅   | 已取消订阅           | 已取消订阅             | 已取消订阅             | 已取消订阅               | 已取消订阅       | 已取消订阅        | platform\_delivery\_stats.email.unsubscribed   | email\_unsubscribed   | message.email.unsubscribed       |
| 总打开次数   | 总打开次数           | 总打开次数             | 总打开次数             | 总打开次数               | ❌           | ❌            | platform\_delivery\_stats.email.opened         | email\_opened         | message.email.opened             |
| 总点击次数   | 总点击次数           | 总点击次数             | 总点击次数             | 总点击次数               | ❌           | ❌            | platform\_delivery\_stats.email.clicked        | email\_clicked        | message.email.clicked            |
| 唯一打开次数  | 唯一打开次数          | 唯一打开次数            | 唯一打开次数            | 唯一打开次数              | 已打开         | 已打开          | platform\_delivery\_stats.email.unique\_opens  | email\_unique\_opens  | ❌                                |
| 唯一点击次数  | 唯一点击次数          | 唯一点击次数            | 唯一点击次数            | 唯一点击次数              | 已点击         | 已点击          | platform\_delivery\_stats.email.unique\_clicks | email\_unique\_clicks | ❌                                |

## 短信术语

1. **已发送**：成功发送到 Twilio 的消息数量。
2. **尝试发送总数**：我们尝试发送到的电话号码数量。这包括成功发送到 Twilio 的消息以及失败的消息。这是一个**派生**指标，是在尝试发送到提供商时成功、失败和错误的总和。这是受众的**子集**，因为它不包括被抑制的消息。
3. **受众**：目标细分中的订阅数量。
4. **已送达**：Twilio 报告的成功传递消息数量。确认传递指标进一步分类以区分 SMS/MMS 和 RCS。
5. **失败**：未能发送到 Twilio 的消息数量。
6. **已抑制**：由于收件人选择退出接收发件人的消息而未发送给收件人的消息数量。
7. **被拒绝**：由于号码被阻止、速度被阻止或收件人在阻止列表中而未由运营商传递的消息数量。这是一个**派生**指标，是提供商错误和提供商失败的总和。
8. **提供商错误**：此数字计算 Twilio 未能发送消息的电话号码。
9. **提供商未送达**：此计数 Twilio 发送消息但未能传递的电话号码。
10. **已读**：阅读 RCS 消息的收件人数量。
11. **总点击次数**：消息中链接被点击的总次数。包括单个链接被多次点击。
12. **唯一点击次数**：消息中所有链接的唯一链接点击数。这些对每个订阅者都是唯一的。
13. **已回复**：OneSignal 收到的关键字数量，不包括同意关键字。
14. **已取消订阅**：OneSignal 收到的退出关键字数量。

### 短信生命周期

```mermaid theme={null}
sequenceDiagram
    participant OneSignal
    participant Twilio
    participant Device
    participant User

    %% -----------------------------
    %% Metrics before message goes to provider
    %% -----------------------------
    Note over OneSignal,User: 消息发送到提供商之前的指标

    OneSignal--xTwilio: 从传递中排除 [已抑制]
    Note left of OneSignal: 传递前排除的消息

    OneSignal-->>Twilio: 发送短信
    Twilio-->>OneSignal: 错误响应 [失败]
    Note left of OneSignal: 未能发送到提供商

    %% -----------------------------
    %% Metrics reported by Twilio
    %% -----------------------------
    Note over OneSignal,User: Twilio 报告的指标

    OneSignal->>Twilio: 发送短信
    Twilio->>OneSignal: Twilio 已接受 [已发送]
    Note left of OneSignal: 成功传递到提供商

    Twilio-->>Device: 尝试传递到设备
    Device-->>OneSignal: 未能传递到设备 [被拒绝]
    Note left of OneSignal: 未能传递到设备

    Twilio->>Device: 传递短信
    Device->>OneSignal: 传递确认 [已送达]
    Note left of OneSignal: 成功传递到设备

    %% -----------------------------
    %% Metrics reported by user
    %% -----------------------------
    Note over OneSignal,User: 用户报告的指标
    %% Metrics reported to Twilio then OS

    Device->>User: 显示短信
    User->>OneSignal: 参与事件 [已读 / 已点击]
    Note left of OneSignal: 用户参与度
```

### 短信指标映射

| 术语     | 控制面板 - 传递报告统计卡片 | 控制面板 - 传递报告时间序列图表 | 控制面板 - 旅程节点报告统计卡片 | 控制面板 - 旅程节点报告时间序列图表 | 控制面板 - 受众活动 | 控制面板 - 参与度趋势 | 查看消息 API                                                                                | 通知 CSV                      | Event Streams           |
| ------ | --------------- | ----------------- | ----------------- | ------------------- | ----------- | ------------ | --------------------------------------------------------------------------------------- | --------------------------- | ----------------------- |
| 已发送    | ❌               | 已发送               | ❌                 | 已发送                 | 已发送         | ❌            | platform\_delivery\_stats.sms.successful                                                | successful                  | message.sms.sent        |
| 尝试发送总数 | 已发送<sup>1</sup> | ❌                 | 已发送<sup>1</sup>   | ❌                   | ❌           | ❌            | ❌                                                                                       | ❌                           | ❌                       |
| 受众     | 受众              | ❌                 | ❌                 | ❌                   | ❌           | ❌            | ❌                                                                                       | ❌                           | ❌                       |
| 已送达    | 已送达             | 已送达               | 已送达               | 已送达                 | 已送达         | 已送达          | platform\_delivery\_stats.sms.provider\_successful                                      | ❌                           | message.sms.delivered   |
| 失败     | 失败              | ❌                 | 失败                | ❌                   | 失败和被拒绝      | ❌            | platform\_delivery\_stats.sms.failed, platform\_delivery\_stats.sms.errored<sup>2</sup> | failed, errored<sup>2</sup> | message.sms.failed      |
| 已抑制    | 已抑制             | ❌                 | 已抑制               | ❌                   | 已抑制         | ❌            | platform\_delivery\_stats.sms.suppressed                                                | ❌                           | ❌                       |
| 被拒绝    | 被拒绝             | ❌                 | 被拒绝               | ❌                   | 失败和被拒绝      | ❌            | ❌                                                                                       | ❌                           | ❌                       |
| 提供商错误  | ❌               | 失败（错误）            | ❌                 | 失败（错误）              | ❌           | ❌            | platform\_delivery\_stats.sms.provider\_errored                                         | ❌                           | ❌                       |
| 提供商未送达 | ❌               | 失败（未送达）           | ❌                 | 失败（未送达）             | ❌           | ❌            | platform\_delivery\_stats.sms.provider\_failed                                          | ❌                           | message.sms.undelivered |
| 已读     | 已读              | 已读                | 已读                | 已读                  | 已读          | 已读           | ❌                                                                                       | ❌                           | ❌                       |
| 总点击次数  | 总点击次数           | ❌                 | 总点击次数             | ❌                   | ❌           | ❌            | ❌                                                                                       | ❌                           | ❌                       |
| 唯一点击次数 | 唯一点击次数          | ❌                 | 唯一点击次数            | ❌                   | ❌           | ❌            | ❌                                                                                       | ❌                           | ❌                       |
| 已回复    | ❌               | ❌                 | ❌                 | ❌                   | ❌           | 已回复（关键字）     | ❌                                                                                       | ❌                           | ❌                       |
| 已取消订阅  | ❌               | ❌                 | ❌                 | ❌                   | ❌           | 已取消订阅        | ❌                                                                                       | ❌                           | ❌                       |

<sup>1</sup> OneSignal 控制面板将其解释为尝试发送总数，并汇总从 OneSignal 发送的通知数量，以及在 OneSignal 内部系统中失败或错误的通知数量。

<sup>2</sup> **失败**和**错误**的总和，这两者都在 OneSignal 内部系统尝试发送到 Twilio 时记录，结果为**失败**。

## 应用内术语

1. **展示次数**：消息成功显示在设备上的次数。
2. **卡片展示次数**：轮播显示在设备上的次数。仅适用于轮播。
3. **总点击次数**：按钮块、图像块或背景被点击的次数。
4. **唯一点击次数**：按钮块、图像块或背景首次被点击。不包括"关闭按钮"点击。

### 应用内生命周期

没有要考虑的传递生命周期。为应用内消息捕获的所有指标都来自通过 OneSignal SDK 的设备。

### 应用内指标映射

| 术语     | 控制面板 - 传递报告统计卡片   | 控制面板 - 旅程节点报告统计卡片 | 控制面板 - 旅程节点报告时间序列图表 | 控制面板 - 受众活动 | 控制面板 - 参与度趋势 | Event Streams               |
| ------ | ----------------- | ----------------- | ------------------- | ----------- | ------------ | --------------------------- |
| 展示次数   | 展示次数              | 展示次数              | 展示次数                | 展示          | 展示次数         | message.iam.impression      |
| 卡片展示次数 | 卡片展示次数            | 卡片展示次数            | ❌                   | ❌           | ❌            | message.iam.page\_displayed |
| 总点击次数  | 总点击次数<sup>1</sup> | 总点击次数<sup>1</sup> | ❌                   | ❌           | ❌            | message.iam.clicked         |
| 唯一点击次数 | ❌<sup>2</sup>     | ❌<sup>2</sup>     | ❌                   | 已点击         | 已点击          | ❌                           |

<sup>1</sup> 我们在应用内传递报告统计卡片上过滤掉总点击次数中的"关闭按钮"点击。

<sup>2</sup> 虽然我们在控制面板上没有唯一点击次数的标签，但我们在 CTR 旁边显示唯一点击次数。

## 实时活动术语

1. **已发送**：从 OneSignal 成功发送到提供商的消息数量。
2. **尝试发送总数**：我们尝试发送的消息数量。这包括成功发送到推送提供商的消息和失败的消息。这是一个**派生**指标，是在尝试发送到提供商时成功、失败和错误的总和。
3. **已送达**：确认收到通知的推送订阅数量。
4. **已取消订阅**：由于卸载应用程序、清除浏览器数据或选择退出推送且此后未打开应用程序而未收到消息的推送订阅数量。我们将**不会**在未来的消息中尝试发送到这些订阅。
5. **失败**：由于错误而未收到通知的推送订阅数量。我们将在未来的消息中尝试发送到这些订阅。

### 实时活动生命周期

```mermaid theme={null}
sequenceDiagram
    participant OneSignal
    participant Provider
    participant Device

    %% -----------------------------
    %% Metrics before message goes to provider
    %% -----------------------------
    Note over OneSignal,Device: 消息发送到提供商之前的指标

    Note left of OneSignal: 未能发送到提供商
    OneSignal-->>Provider: 发送实时活动更新
    Provider-->>OneSignal: 错误响应 [失败 / 已取消订阅]

    %% -----------------------------
    %% Metrics reported by push provider
    %% -----------------------------
    Note over OneSignal,Device: 推送提供商报告的指标

    Note left of OneSignal: 成功传递到提供商
    OneSignal->>Provider: 发送实时活动更新
    Provider->>OneSignal: 提供商已接受 [已发送]

    Note left of OneSignal: 成功传递到设备
    Provider->>Device: 传递实时活动更新
```

### 实时活动指标映射

| 术语     | 控制面板 - 传递报告统计卡片 | 控制面板 - 受众活动 | 控制面板 - 参与度趋势 | 查看消息 API   | 通知 CSV     | Event Streams                       |
| ------ | --------------- | ----------- | ------------ | ---------- | ---------- | ----------------------------------- |
| 尝试发送总数 | 已发送             | ❌           | ❌            | ❌          | ❌          | ❌                                   |
| 已发送    | 已送达             | 已送达         | 已送达          | successful | successful | message.live\_activity.sent         |
| 已送达    | ❌               | ❌           | 已确认          | ❌          | ❌          | message.live\_activity.delivered    |
| 失败     | 失败              | 失败          | 失败           | errored    | errored    | message.live\_activity.failed       |
| 已取消订阅  | 已取消订阅           | 已取消订阅       | 已取消订阅        | failed     | failed     | message.live\_activity.unsubscribed |
| 已点击    | ❌               | ❌           | ❌            | ❌          | ❌          | message.live\_activity.clicked      |

***