# 自定义事件

与[默认事件](/zh/product/audience-data-and-segmentation/events/default-events)不同，自定义事件是特定于您的应用的，而默认事件在许多应用和行业中是通用的。这些事件跟踪特定于您需求的独特操作，例如完成一次锻炼或延长订阅。它们帮助您了解用户如何与您的特定功能互动。此外，它们还提供对用户行为的更深入洞察，帮助[跟踪留存率](/zh/product/statistics-and-analytics/user-retention-statistics)，并允许创建高度个性化和有效的营销活动。这最终提高了用户的参与度和满意度。

## 创建自定义事件

在 Pushwoosh 中创建自定义事件：

1.  前往 **Audience > Events** 并点击 **Create Event**。在出现的下拉菜单中，选择 **Custom Event**。

<img src="/events-custom-events-1.webp" alt="“创建事件”下拉菜单，显示“自定义事件”选项"/>

2.  在打开的窗口中，在 **Event Name** 字段中输入您的事件名称。例如，使用 level_completed 来跟踪用户完成游戏关卡的时间。在 **Description** 字段中提供事件的简要描述。这有助于快速识别事件的用途。

<img src="/events-custom-events-2.webp" alt="自定义事件创建表单，包含事件名称和描述字段"/>

3.  定义与您的事件相关的特定属性并选择属性类型。事件属性是描述事件细节的特定信息。它们捕捉用户在您应用内互动的各个方面。这为精确的消息定位和细分提供了宝贵的数据。您最多可以为一个事件添加 50 个属性。

可用的属性类型：

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

有关属性类型的详细信息，请参阅[了解事件](/zh/product/audience-data-and-segmentation/events/#2-set-attributes)。

<img src="/events-custom-events-3.webp" alt="事件属性配置，显示属性类型和字段"/>

对于发生的每个事件，都会有相应的属性值。例如，**level_completed** 事件的属性可以包括 **level_number、completion_time、score** 或 **points_earned**。当事件在 Pushwoosh 中记录时，它将包含这些属性值以及一个时间戳。这些数据以后可用于构建细分、定位消息和收集统计数据。

填写完必要的详细信息并添加属性后，点击 **Create** 以完成事件设置。如果您决定不继续创建事件，请点击 **Cancel** 以放弃更改。

<Aside type="caution" icon="setting" title="需要开发者协助">
在控制面板中设置自定义事件后，您需要开发团队的帮助才能将其集成到您的应用中。请将您创建的事件旁边找到的集成代码以及[此链接](/zh/developer/guides/audience-and-segmentation/events#custom-events-implementation)分享给他们以获取说明。
</Aside>

## 管理自定义事件

事件列表提供了您为应用程序创建的所有自定义事件的概览。每个事件都帮助您跟踪特定的用户互动或行为。

**事件详情**

*   **Event Name** 用于识别事件（例如，“button_clicked”、“video_watched”）
*   **Attributes** 或与事件相关的关键信息，提供额外的上下文（例如，“button_id”、“video_category”）
*   **7-Day Activity** - 过去七天内事件发生的次数，提供近期参与度的快速视图

<img src="/events-custom-events-4.webp" alt="自定义事件列表，显示事件详情和管理选项"/>

每个事件都有一个用于进一步管理的菜单：

*   点击 **View Code** 以访问将此事件集成到您应用代码库中所需的代码片段。
*   点击 **Event Statistics** 以深入了解所选事件的详细统计数据，从而洞察用户行为。
*   点击 **Edit Event** 以修改事件的设置，包括其名称和相关属性，以确保数据收集的准确性。

<img src="/events-custom-events-6.webp" alt="事件管理菜单，包含“查看代码”、“事件统计”和“编辑事件”选项"/>

## 在 Pushwoosh 中使用自定义事件

设置好事件后，您可以使用它们来：

1.  [创建一个客户旅程](/zh/product/customer-journey/create-a-customer-journey-for-your-project)，该旅程将在您的自定义事件发生时启动，使用 [**Trigger-based entry**](/zh/product/customer-journey/journey-elements#trigger-based-entry) 元素。
2.  [按事件构建细分](/zh/product/audience-data-and-segmentation/segmentation/create-segments/by-events/)，包括按事件属性值和运算符进行筛选。
3.  根据用户执行自定义事件的次数或事件最后发生的时间等标准对用户进行细分。使用这些细分来设置进入客户旅程的 [Audience-based entries](/zh/product/customer-journey/journey-elements/#audience-based-entry)，或在旅程中使用 [Segment Split 选项](/zh/product/customer-journey/journey-elements#segment-split)。
4.  根据用户在旅程中触发的自定义事件，在您的[客户旅程中设置时间延迟](/zh/product/customer-journey/journey-elements#delay-based-on-user-or-event-data)。
5.  在 [Wait for Trigger 步骤](/zh/product/customer-journey/journey-elements#wait-for-trigger)中使用自定义事件，根据用户是否在指定时间内触发此特定事件或多个事件来设置不同的通信场景。

## 自定义事件用例

| 应用类型 | 自定义事件 | 描述 | 用例 |
| --- | --- | --- | --- |
| 健身与健康应用 | workout_complete | 用户完成一次锻炼。 | 发送激励消息或奖励，以保持用户参与并鼓励定期锻炼。 |
| 电子商务应用 | cart_abandoned | 用户将商品添加到购物车但未完成购买。 | <p>发送提醒邮件或推送通知，并对购物车中留下的商品提供特别优惠或折扣。</p><p><a href="/product/audience-data-and-segmentation/events/recommended-events-for-e-commerce">探索电子商务应用的推荐事件</a></p> |
| 教育与电子学习应用 | complete_course | 用户完成一门课程。 | 发送祝贺消息并推荐高级课程或相关主题。 |
| 媒体与娱乐应用 | watch_video | 用户观看一个视频。 | <p>发送关于类似内容或新发布的通知。推荐其他视频。</p><p><a href="/product/audience-data-and-segmentation/events/recommended-events-for-media">探索媒体应用的推荐事件</a></p> |
| 旅游与酒店应用 | book_flight | 用户预订一个航班。 | 发送旅行提醒、打包技巧以及目的地活动推荐。 |
| 订阅应用 | start_trial | 用户开始免费试用。 | <p>发送入门消息，提供技巧，提供帮助，并突出关键功能。</p><p><a href="/product/audience-data-and-segmentation/events/recommended-events-for-subscription-management">探索订阅应用的推荐事件</a></p> |
| 出行或共享汽车应用 | ride_completed | 用户完成一次共享汽车行程。 | 发送后续应用内消息，请求反馈，或为下一次行程提供折扣。 |
| 游戏应用 | level_completed | 用户完成一个游戏关卡。 | <p>发送祝贺消息，并为完成下一关卡提供技巧或奖励。</p><p><a href="/product/audience-data-and-segmentation/events/recommended-events-for-gaming-apps">探索游戏应用的推荐事件</a></p> |

## 跟踪自定义事件

#### 事件统计

您可以跟踪您创建的每个事件。为此：

1.  导航到 **Audience > Events**。
2.  在 **Events** 列表中，找到您想要跟踪的事件，并点击旁边的三个点。选择 **Event Statistics**。
3.  设置您想要分析事件数据的日期范围。
4.  通过添加基于用户细分、设备类型或其他自定义标准等属性的特定条件或筛选器来优化事件数据分析。
5.  查看一个图表，该图表可视化了所选事件在指定日期范围内被触发的频率。
6.  您还可以将事件数据导出为 CSV 文件，以进行进一步分析或报告。

<img src="/events-custom-events-7.webp" alt="事件统计仪表板，显示频率图和数据导出选项"/>

要更新仪表板上显示的事件数据，请点击 **Refresh** 按钮。

#### 仪表板

Pushwoosh 还允许您使用事件仪表板跟踪自定义事件，该仪表板包含与您活动中使用的事件相关的统计数据，或者通过构建您自己的自定义仪表板。 [了解更多](/zh/product/statistics-and-analytics/dashboards/)

#### 留存标签页

使用 **Retention** 标签页来跟踪与您业务相关的特定事件的留存情况。 [了解更多](/zh/product/statistics-and-analytics/user-retention-statistics)