> ## 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.

# Live Activities 分析

> 了解如何通过 OneSignal 分析和测量您的 iOS Live Activities 性能。跟踪投递率、点击量和用户参与度，以优化您的实时更新策略。

通过跟踪投递率、点击量和用户参与度等关键指标，了解您的 Live Activities 的表现。OneSignal 提供全面的分析功能，帮助您优化实时更新策略。

<Note>
  本指南涵盖 [Live Activities](./live-activities) 的分析功能。在深入了解分析之前，请确保您已设置好 Live Activities。
</Note>

***

## 概述

Live Activities 分析帮助您了解：

* 有多少用户接收到您的更新
* 用户是否与您的 Live Activities 互动
* 投递失败在哪里发生
* 您的订阅基数如何随时间变化

***

## 关键指标

Live Activities 提供以下指标。更多详情，请参见 [参与度趋势](./engagement-analytics)。

| 指标       | 定义                                                                   |
| -------- | -------------------------------------------------------------------- |
| **已发送**  | 从 OneSignal 发送到 Apple 推送通知服务 (APNs) 的 Live Activities。包括推送启动和推送更新通知。 |
| **确认投递** | 确认投递到设备的 Live Activities。需要 iOS SDK 5.2.15+ 和 OneSignal 设置方法。        |
| **失败**   | 由于错误而投递失败的 Live Activities。                                          |
| **取消订阅** | 当用户关闭 Live Activity 或在设置中禁用 Live Activities 时标记为取消订阅的订阅。             |
| **已点击**  | 所有 Live Activities 的总点击数。同一用户的多次点击将分别计算。                             |

<Note>
  **确认投递** 和 **已点击** 指标需要 iOS SDK 版本 **5.2.15 或更高版本**。请确保您的应用已更新以利用这些跟踪功能。
</Note>

***

## 消息报告

使用消息报告通过跟踪投递率和点击率来分析您的 Live Activities 的有效性。

<Frame caption="Live Activity 报告">
  <img src="https://mintcdn.com/onesignal/vW9xDwSIrN3V7agt/images/live-activities/live-activity-report.png?fit=max&auto=format&n=vW9xDwSIrN3V7agt&q=85&s=e9e93614f215a30145dffaf02731fce8" width="1600" height="1171" data-path="images/live-activities/live-activity-report.png" />
</Frame>

### 访问消息报告

1. 在您的 OneSignal 控制面板中导航到**已发送消息**
2. 按 **Live Activities** 筛选，仅查看 Live Activity 消息
3. 点击任意 Live Activity 查看其详细报告

### 统计和定义

| 指标       | 定义                                              |
| -------- | ----------------------------------------------- |
| **已投递**  | 接收到 Live Activity 的订阅数量。                        |
| **确认投递** | 确认接收到活动的订阅数量。                                   |
| **失败**   | 由于错误而未接收到 Live Activity 的订阅数量。                  |
| **取消订阅** | 由于卸载应用、选择退出且自那时起未打开应用而未接收到 Live Activity 的订阅数量。 |
| **已点击**  | 所有 Live Activities 的总点击数。同一用户的多次点击将分别计算。        |

***

## 受众活动

受众活动面板允许您查看与 Live Activity 相关的用户最近活动，包括投递、点击、失败和取消订阅。

### 查看受众活动

1. 打开 Live Activity 消息报告
2. 找到**受众活动**面板
3. 选择您想查看的统计类型：
   * **投递** — 接收到 Live Activity 的用户
   * **点击** — 点击 Live Activity 的用户
   * **失败** — 由于错误而未接收到 Live Activity 的用户
   * **取消订阅** — 取消订阅或被移除的用户

### 了解用户行为

使用受众活动数据：

* 识别用户参与模式
* 为特定用户群体排查投递问题
* 跟踪 Live Activity 内容对点击率的影响
* 监控订阅健康状况随时间的变化

***

## 导出结果

您可以通过点击受众活动面板上方的**导出**按钮导出您的 Live Activity 的受众活动。

### 导出选项

* **单个统计** — 仅导出当前选择的活动类型（例如，仅点击或仅失败）
* **所有统计** — 一次导出所有受众活动数据

### 接收您的导出

导出受众活动将向已登录用户的电子邮件地址直接发送包含结果的电子邮件。导出包括：

* 用户标识符
* 活动时间戳
* 活动类型
* 设备和平台信息（如果可用）

<Note>
  大型导出可能需要几分钟的时间来处理。您的导出准备好时将收到电子邮件通知。
</Note>

***

## 性能分析

### 投递率

计算您的投递率以了解您的 Live Activities 向用户传达的有效性：

```
投递率 = (确认投递 / 已发送) × 100
```

健康的投递率通常为 **95% 或更高**。较低的费率可能表明：

* 过时的推送令牌
* 禁用了 Live Activities 的用户
* 网络连接问题

### 点击率 (CTR)

衡量与您的 Live Activities 的参与度：

```
CTR = (已点击 / 确认投递) × 100
```

### 基准测试您的性能

比较您随时间变化的指标以识别趋势：

* **逐周** — 投递率是否在改善？
* **按内容类型** — 某些 Live Activity 类型是否表现更好？
* **按时间** — 用户在什么时候最活跃？

***

## 常见问题故障排除

### 高失败率

如果您看到升高的失败率：

1. **检查推送令牌有效性** — 当用户卸载或重新安装您的应用时，令牌会过期
2. **验证 APNs 配置** — 确保您的推送证书是最新的
3. **查看错误消息** — 检查失败详情以获取特定错误代码

### 低确认投递

如果确认投递显著低于已发送：

1. **验证 SDK 版本** — 确认投递需要 iOS SDK 5.2.15+
2. **检查 OneSignal 设置** — 确保 OneSignal 设置方法得到正确实施
3. **考虑网络条件** — 某些用户可能有间歇性连接

### 点击率下降

如果点击率在下降：

1. **查看内容相关性** — 您的更新是否提供价值？
2. **检查时机** — 您是否在适当的时间发送更新？
3. **审计 UI/UX** — 确保您的 Live Activity 设计鼓励互动

***

## 分析最佳实践

### 定期监控

* 每周查看 Live Activity 性能
* 为重大指标变化设置警报
* 比较不同 Live Activity 类型的性能

### 数据驱动优化

* A/B 测试不同内容方法
* 尝试更新频率
* 分析哪些事件推动最多参与

### 历史分析

Live Activity 数据在控制面板中最多可用 **30 天**。对于更长期的分析：

* 定期导出数据
* 在电子表格或分析工具中跟踪趋势
* 记录更改以与性能变化相关联

***

## 常见问题

### Live Activity 数据保留多长时间？

您可以在控制面板的**已发送消息**下查看历史上发送的 Live Activities（最多 30 天），并按 Live Activities 进行筛选。

### 为什么我的确认投递低于已发送？

确认投递需要 iOS SDK 版本 5.2.15 或更高版本以及正确的 OneSignal 设置。如果您的应用中有使用较旧 SDK 版本的用户，他们将不会报告确认投递。

### 我可以跟踪个人用户旅程吗？

是的，受众活动面板允许您查看个人用户活动。您还可以导出此数据以进行更深入的分析。

### 如何提高我的点击率？

专注于提供及时、相关的更新，为用户提供明确价值。确保您的 Live Activity 设计具有清晰的点击目标和引人注目的内容。

***
