# 了解 Pushwoosh 中的事件

**事件 (Events)** 用于记录用户在应用中执行的各种操作。与存储扁平化数据（如国家、设备型号或安装数据）的标签 (Tags) 不同，事件数据是按历史记录存储的。这会创建用户行为的历史记录，而不是静态的设备信息。所有关于事件的上下文信息都可以作为属性及其值进行传递。

Pushwoosh 事件分为三类：开箱即用的[默认事件](/zh/product/audience-data-and-segmentation/events/default-events/)、您为应用定义的[自定义事件](/zh/product/audience-data-and-segmentation/events/custom-events/)，以及用于以统一格式跟踪收入的[转化事件](/zh/product/audience-data-and-segmentation/events/conversion-events/)。

一旦正确收集，这些数据可用于：

*   触发基于行为的消息。
*   构建在应用中执行特定操作的用户细分。
*   获取有关用户流程、使用指标和其他统计数据的洞察。

## 实现

### 1. 在 Pushwoosh 控制面板中创建事件

您的应用发送的所有事件都必须首先在 Pushwoosh 中创建，并设置好属性及其类型。否则，Pushwoosh 将无法识别它们。

要创建事件，请转到控制面板的 **Events** 部分，然后按 **Add event** 按钮。输入名称和描述，并根据需要添加[属性](#2-set-attributes)。

<Aside type="tip">
事件数据只有在正确提交时才有价值。因此，我们强烈建议您遵循以下简单指南：

*   尽量使事件名称简短。
*   根据用户在应用中执行的操作来命名事件，例如 “LoggedIn”、“SignedOut”、“Subscribed” 等。
*   请记住，事件名称区分大小写。
*   将描述单个操作的事件合并为一个事件。例如，使用带有适当属性的 “Subscribed” 事件，而不是单独的 “SubscribedToSports”、“SubscribedToPolitics”、“SubscribedToTechnology” 事件。
</Aside>

<img src="/events-README-1.webp" alt="事件部分显示添加事件按钮和事件创建界面"/>

### 2. 设置属性

描述事件的所有详细信息都通过其属性提供。属性是键/值对。在控制面板中，您可以选择以下类型之一：

*   **integer**
*   **string**
*   **boolean**
*   **list**
*   **decimal (price)**
*   **date**

<Aside type="note">
您最多可以为一个事件添加 50 个属性，每个属性的有效负载（内容）限制为 10 KB。
</Aside>

<img src="/events-README-2.webp" alt="事件属性表单，显示属性名称和类型下拉菜单，包含 integer、string、boolean、list、decimal (price) 和 date"/>

例如，您可以通过指定单个 Login 事件的属性来跟踪用户登录并收集登录凭据（例如，使用 Facebook、Google、Twitter 或电子邮件登录）、互联网连接类型（wifi、cellular、unknown）以及登录是否成功（true 或 false 值），如下所示：

| 属性 | 类型 | 值 |
| ---------- | ------- | -------------------------------- |
| type | string | facebook, google, twitter, email |
| connection | string | wifi, cellular, unknown |
| success | boolean | true, false |

该事件将连同属性值和时间戳一起记录在 Pushwoosh 中，以便稍后用于构建细分、定位消息和收集统计数据。

<Aside type="tip">
要在构建细分时按事件属性值筛选用户，请参阅[按事件构建细分](/zh/product/audience-data-and-segmentation/segmentation/create-segments/by-events/#event-attribute-operators-by-type)。
</Aside>



### 3. 调用 /postEvent API

<Aside type="caution" icon="setting" title="需要开发人员协助">
 此步骤需要您的开发团队协助。请与他们分享[此链接](/zh/developer/guides/audience-and-segmentation/events)，以获取有关事件设置的详细说明。
</Aside>

## 导入事件

**导入事件**功能允许您从 CSV 文件上传事件数据，从而轻松地批量跟踪和分析用户活动。您可以从各种分析和 CRM 系统导入事件，以增强您的数据并改进细分。

要导入事件，请导航至 **Audience** → **Import CSV** → **Import events**。

![上传事件](/importevents.webp)

### 步骤 1. 上传 CSV

上传包含事件数据的 CSV 文件。该文件必须包含以下必需列：

*   **Event name：** 事件的名称。
*   **Event date：** 事件发生的日期和时间。
*   **HWID 或 User ID：** 与事件关联的用户的唯一标识符。

您还可以包含用于可选事件属性的附加列以增强您的数据。

要上传文件，请将 CSV 文件拖放到上传区域，或单击以从您的设备中选择文件。允许的最大文件大小为 100 MB。

### 步骤 2\. 映射列

上传文件后，您必须将 CSV 列映射到 Pushwoosh 中相应的事件属性。

*   将每个必填字段（Event Name、Event Date、HWID 或 User ID）分配到文件中的正确列。
*   如果您的 CSV 包含自定义属性，请将它们映射到与您的数据跟踪需求一致的有意义的名称。
*   如果需要，单击 **Add attribute** 以包含额外的字段。

所有列都正确映射后，单击 **Import events**。

导入成功完成后，将显示一条确认消息。您现在可以使用这些事件来最大化您的营销活动的潜力。

如果需要，您可以上传另一个文件以继续导入其他数据。

您可以在 [**User Explorer**](/zh/product/audience-data-and-segmentation/user-explorer/) 的 **Events History** 部分找到导入的事件。