默认事件

什么是默认事件

默认事件是用户在应用或网站中执行的基本交互，无论其行业或功能如何。这些关键用户行为构成了客户沟通的核心，可用于任何产品和客户生命周期的任何阶段。

对于最新的 SDK 版本，默认事件是开箱即用的。除了 PW_InAppPurchase（详见下文）之外，它们不需要额外设置。

要查找并激活 Pushwoosh 中可用的默认事件，请按照以下步骤操作：

导航到 Audience（受众）部分的 Events（事件）选项卡。
点击 Create Event（创建事件）。
从下拉菜单中选择 Default Event（默认事件）。
在弹出窗口中，选择所需的事件并点击 Activate（激活）。

激活后，默认事件可用于基于行为的消息传递。例如，将它们用作 Customer Journey 中的 Trigger-based Entry（基于触发器的入口）或 In-App 消息的触发器。

设备和应用使用情况

PW_DeviceRegistered

此事件对于每个设备仅在首次启动应用和 SDK 初始化时触发一次。顾名思义，此事件跟踪设备在您应用中的注册情况。

事件属性

platform (字符串)：已注册设备的平台名称。
platform_id (整数)：平台代码，与 registerDevice 中的 device_type 值相同。

用例

为新注册的用户发起引导活动。使用 PW_DeviceRegistered 事件将 Trigger-based Entry（基于触发器的入口）添加到 Onboarding Customer Journey（客户旅程）中。
通过事件统计数据，识别为您带来更多新用户的获客活动。
在用户首次访问时就与他们互动。通过由 DeviceRegistered 事件触发的 In-Apps（应用内消息）来迎接他们。

PW_DeviceUnregistered

当应用被卸载，或用户选择退订电子邮件或推送通知时，此事件会触发。

事件属性

message_id (字符串)
message_code (字符串)
campaign_id (字符串)
platform (字符串)
platform_id (整数)

用例

当用户决定停止使用您的应用时，挽留他们。例如，您可以向每个卸载了应用的用户发送一封包含特别优惠的电子邮件。
与已从您的某个渠道退订的用户保持沟通。例如，如果用户不想再接收推送通知，您可以发送一封电子邮件或显示一条应用内消息，鼓励他们更频繁地使用应用。

PW_ApplicationOpen

仅适用于移动应用

ApplicationOpen 事件在用户每次在其设备上启动您的移动应用时触发。

事件属性

device_type (整数)：设备类型代码。详情请参阅 registerDevice。
application_version (字符串)：应用版本。

用例

根据 ApplicationOpen 事件的统计数据收集用户留存统计信息。
为活跃在应用中的用户开展应用内消息营销活动。

PW_ScreenOpen

仅适用于移动应用

此事件在用户每次查看您移动应用中的特定屏幕时触发。

事件属性

application_version (字符串)：应用版本。
device_type (整数)：设备类型代码。详情请参阅 registerDevice。
screen_name (字符串)：从您的应用中获取的技术屏幕名称。

用例

通过使用 PW_ScreenOpen 事件启动 Customer Journeys，向对特定应用部分表现出兴趣的用户发送完全相关的消息。
评估并提高您促销活动的有效性。对两个或多个版本的优惠进行 A/B/n 测试，等待 ScreenOpen 事件发生，然后查看哪个内容表现最佳。
了解哪些应用屏幕访问量最大。按屏幕名称筛选事件统计数据。

PW_ApplicationMinimized

仅适用于移动应用

当用户在其设备上最小化（但不是强制停止）应用时，此事件会触发。

事件属性

device_type (整数)：设备类型代码。详情请参阅 registerDevice。
application_version (字符串)：应用版本。

用例

跟踪 ApplicationOpen 和 ApplicationMinimized 事件之间的平均会话时间。
在应用在后台运行时发送推送通知，以吸引用户的注意力并让他们返回应用。

PW_UserIdle

仅适用于移动应用

当用户在您的应用内，但在可配置的一段时间内未与屏幕互动时，此事件会触发。与用户离开应用后触发的 PW_ApplicationMinimized 不同，PW_UserIdle 在用户仍在应用内时触发。它捕捉了用户注意力下降、犹豫或分心的时刻。将其用作服务器端信号，以显示及时的 In-App 消息、提供帮助或推动用户进入下一步。

默认情况下，在两个平台上都禁用了空闲检测。当超时键缺失或设置为 0 时，不会发送 PW_UserIdle 事件。要启用它，请在您应用的平台配置中设置超时（最少 30 秒）：

iOS： 在您应用的 Info.plist 中添加 Pushwoosh_IDLE_TIMEOUT_SECONDS 键（数字，最少 30）。
Android： 在您的 AndroidManifest.xml 中添加 com.pushwoosh.idle_timeout_seconds 元数据（整数，最少 30）。

事件属性

screen_name (字符串)：用户进入空闲状态的屏幕。在 Android 上，当当前屏幕是嵌套的时，格式为 ActivityName/FragmentName。否则为活动名称。在 iOS 上，当嵌套时，格式为 ParentVC/ChildVC。否则为视图控制器名称。
idle_seconds (整数)：已过的配置的空闲超时时间。
session_duration (整数)：自应用上次进入前台以来的秒数。
device_type (整数)：设备类型代码。详情请参阅 registerDevice。
application_version (字符串)：应用版本。

行为

每个前台会话最多触发一次。返回后台再回到前台会开始一个新的会话。
当软键盘打开、模态对话框或系统提示在屏幕上以及应用在后台时，计时器会自动暂停。
与屏幕的物理交互（触摸、滚动和输入）会重置计时器。

用例

当用户在高意图屏幕（购物车、定价、结账）上停留而未采取行动时，触发 In-App 优惠或上下文助手。
当用户在引导步骤中停滞时，显示提示或教程。
通过按 screen_name 筛选空闲事件统计数据，识别用户失去动力的地方。

PW_ApplicationExit

仅适用于移动应用

当用户将应用置于后台并且在可配置的超时时间内未返回时，此事件会触发。与用户离开时立即触发的 PW_ApplicationMinimized 不同，PW_ApplicationExit 仅在配置的延迟过后才会触发。它确认用户已真正离开会话，而不是短暂切换应用。用它来重新吸引那些在流程中途放弃会话的用户，或在确认退出后触发后续活动。

默认情况下，退出意图检测是禁用的。要启用它，请在您应用的平台配置中设置超时（10-30 秒，超出此范围的值会自动钳位）：

Android： 在您的 AndroidManifest.xml 中添加 com.pushwoosh.exit_intent_timeout_seconds 元数据（整数，10-30）。
iOS： 在您应用的 Info.plist 中添加 Pushwoosh_APPLICATION_EXIT_TIMEOUT_SECONDS 键（数字，10-30）。

事件属性

screen_name (字符串)：用户将应用置于后台时最后活动的屏幕。
session_duration (整数)：自应用上次进入前台以来的秒数。
exit_intent_seconds (整数)：事件触发前经过的有效超时时间（10-30 秒）。
device_type (整数)：设备类型代码。详情请参阅 registerDevice。
application_version (字符串)：应用版本。

行为

当应用进入后台时计时器启动，如果用户在超时到期前返回，则取消计时。
屏幕名称和会话持续时间是在进入后台的瞬间捕获的，而不是在事件触发时。
如果退出意图检测被禁用（超时键为 0 或未设置），则不会触发该事件。

用例

重新吸引放弃购买或注册流程的用户。触发带有提醒或折扣的推送通知或电子邮件。
为未完成关键操作（例如，离开购物车或在引导中途停止）就退出的用户启动赢回 Customer Journey。
通过按 screen_name 筛选事件统计数据，识别高流失率的屏幕。

网站

PW_SiteOpened

仅适用于网站

SiteOpened 事件在用户每次打开您网站的任何页面时触发。

事件属性

device_type (整数)：设备类型代码。详情请参阅 registerDevice。
title (字符串)：访问页面的标题。
url (字符串)：访问页面的 URL。

用例

分析您的网站流量分布，并比较用户打开特定网站页面的次数。为此，请按其属性筛选事件统计数据。
在用户访问网站后，通过相关的沟通进行跟进。构建一个以针对特定 title 或 url 属性设置的 SiteOpened 事件开始的旅程。

商业

PW_InAppPurchase

仅适用于移动应用

InAppPurchase 事件在用户每次在您的应用中购买应用内项目时触发。例如付费订阅、游戏机制元素、应用内货币等。

要实现应用内购买事件：

iOS： 在您的 Control Panel 中激活 PW_InAppPurchase 事件。将 Pushwoosh iOS SDK 的 Pushwoosh_PURCHASE_TRACKING_ENABLED 参数设置为 yes。
Android： 在您的 Control Panel 中激活 PW_InAppPurchase 事件。配置向 Pushwoosh 发送购买信息使用本指南。

事件属性

productIdentifier (字符串)：从 App Store 获取。
quantity (整数)：购买的物品数量。
transactionDate (字符串)：购买日期。
status (字符串)：购买状态。

用例

收集应用内购买的统计数据。
开展促销活动并跟踪其成功情况。在促销消息后设置“等待触发”事件。

推送通知

PW_NotificationSend

仅适用于移动和网站

此事件在 Pushwoosh 消息发送到用户设备后触发一次。

事件属性

message_id (字符串)
message_code (字符串)
campaign_id (字符串)

用例

无论使用何种渠道，都可跟踪消息是否已发送。
根据发送的消息数量创建用户 Segments（细分）。
在 Events history（事件历史）中查看发送给用户的所有消息，并分析用户的后续行为。

PW_NotificationOpen

仅适用于移动和网站

此事件在用户每次打开通过 Pushwoosh 发送的推送通知时触发。

用例

配置发送推送的最佳时间。
根据特定时间段内的通知表现创建 Segments（细分）。

电子邮件

PW_EmailSent

仅适用于电子邮件

此事件在电子邮件发送到电子邮件提供商后触发一次。检查 status_code 以了解结果。

事件属性

message_id (字符串)：消息的 ID。
message_code (字符串)：特定电子邮件消息的唯一标识符。
status_code (整数)：电子邮件提供商为此发送尝试返回的投递状态码。
campaign_id (字符串)：活动的 ID。仅当电子邮件作为活动的一部分发送时才包含。
campaign_code (字符串)：活动的唯一代码。当发送是活动的一部分且活动查找成功时包含。即使 campaign_id 存在，campaign_code 也可能缺失。

用例

使用 status_code 跟踪发送结果，与电子邮件之后是否被打开或点击无关。
根据发送的电子邮件数量创建用户 Segments（细分）。
在 Events history（事件历史）中查看发送给用户的所有电子邮件，并分析用户的后续行为。

PW_EmailOpen

仅适用于电子邮件

当用户打开通过 Pushwoosh 发送的电子邮件时，此事件会触发。

事件属性

campaign_code (字符串)：与电子邮件关联的活动的唯一代码。
campaign_id (字符串)：活动的 ID。
message_code (字符串)：特定电子邮件消息的唯一标识符。
message_id (字符串)：消息的 ID。
opened_by (字符串)：触发打开的人或物：user 表示收件人真实打开，或 ampp 表示由 Apple Mail Privacy Protection（Apple 邮件隐私保护）预取跟踪像素触发的自动打开。

用例

跟踪电子邮件打开情况，以识别积极与您的电子邮件互动的用户。使用此数据创建后续活动，例如向打开促销电子邮件的用户发送折扣码。
如果用户打开了电子邮件但未完成期望的操作（例如，进行购买），您可以触发后续电子邮件，附带提醒或个性化优惠。
分析各个活动的打开率，以优化您的主题行和电子邮件发送时机策略，适用于产品发布或季节性促销等活动。
创建一个基于 PW_EmailOpen 且 opened_by 等于 user 的细分，以定位打开了电子邮件的收件人，排除 AMPP 触发的打开。

PW_EmailLinkClicked

仅适用于电子邮件

此事件在用户每次点击电子邮件中的链接时触发。

事件属性

message_id (字符串)
message_code (字符串)
campaign_id (字符串)
redirect_link (字符串)
original_link (字符串)

用例

为点击电子邮件中特定链接的用户开展有针对性的活动。
向忽略第一封电子邮件中链接的用户发送另一封消息，以鼓励他们点击链接（或采取其他行动）。

PW_EmailSubscribed

仅适用于电子邮件

当用户订阅一个或多个电子邮件类别时——通过偏好中心提交或重新订阅链接，以及在新电子邮件设备首次注册时自动订阅，此事件会触发。

事件属性

message_id (字符串)：触发订阅的消息 ID（如果适用）。
campaign_id (字符串)：相关活动的 ID（如果适用）。
message_code (字符串)：特定消息的唯一标识符（如果适用）。
categories (字符串数组)：用户订阅的电子邮件类别的名称；如果没有适用（例如，注册时没有自动订阅的类别），则省略。
resubscribe (布尔值)：对于任何偏好中心或重新订阅链接的提交为 true——包括用户在那里进行的首次订阅；对于设备注册时的自动订阅则省略。

用例

使用 resubscribe 将偏好中心驱动的订阅与注册时的自动订阅区分开。
创建订阅了特定类别的用户的 Segments（细分）。

PW_EmailUnsubscribed

仅适用于电子邮件

当用户取消订阅一个或多个电子邮件类别时，以及完全选择退出所有营销电子邮件（Unsubscribed Emails 标签）时，此事件会触发——在这种情况下，categories 会被省略。如果用户一次性取消订阅多个类别，categories 会列出所有这些类别。

事件属性

message_id (字符串)：用户取消订阅的消息 ID（如果适用）。
campaign_id (字符串)：相关活动的 ID（如果适用）。
message_code (字符串)：特定消息的唯一标识符（如果适用）。
categories (字符串数组)：用户取消订阅的电子邮件类别的名称；在完全选择退出时省略。

用例

创建选择退出特定类别的用户的 Segments（细分），以将他们从该类别的未来活动中排除。
为取消订阅某个类别的用户触发赢回旅程。

应用内消息

PW_InAppShown

仅适用于移动应用

当向用户显示应用内消息时，此事件会触发。

事件属性

message_code (字符串)：与应用内消息关联的特定消息的唯一标识符。
message_id (整数)：消息的 ID。
campaign_code (字符串)：与应用内消息关联的活动的唯一代码。
campaign_id (整数)：触发应用内消息的活动的 ID。
rich_media_code (字符串)：在应用内消息中显示的富媒体内容的唯一标识符。
inapp_code (字符串)：标识所显示的特定应用内消息的唯一代码。

用例

跟踪应用内消息的查看频率，以调整您的消息策略，例如移除可能惹恼用户的冗余消息。
使用应用内消息的展示数据来评估促销活动（如限时抢购或订阅升级）的覆盖范围。
如果应用内消息已显示但未被点击，您可以触发后续操作，例如发送内容相似的推送通知以强化消息。

PW_InAppClicked

仅适用于移动应用

当用户通过点击与应用内消息互动时，此事件会触发。

事件属性

message_code (字符串)：与应用内消息关联的特定消息的唯一标识符。
message_id (整数)：消息的 ID。
campaign_code (字符串)：与应用内消息关联的活动的唯一代码。
campaign_id (整数)：触发应用内消息的活动的 ID。
rich_media_code (字符串)：在应用内消息中显示的富媒体内容的唯一标识符（如果适用）。
inapp_code (字符串)：标识被点击的特定应用内消息的唯一代码。
element_id (字符串)：被点击的应用内消息中特定元素的标识符（例如，按钮或链接）。
link (字符串)：与被点击元素关联的 URL 或深层链接。

用例

分析点击行为，以识别用户最常互动的按钮或链接，并优化未来的应用内消息设计。例如，在订阅升级活动中测试不同的 CTA。
根据用户点击触发自动化操作，例如将用户重定向到特定产品页面或发送推送通知。

短信

PW_SMSSent

仅适用于短信

此事件在短信发送到短信提供商后触发一次。检查 status_code 以了解结果。

事件属性

message_id (字符串)：消息的 ID。
message_code (字符串)：特定短信消息的唯一标识符。
status_code (整数)：短信提供商为此发送尝试返回的投递状态码。用它来区分成功与失败。
campaign_id (字符串)：活动的 ID。仅当短信作为活动的一部分发送时才包含。
campaign_code (字符串)：活动的唯一代码。当发送是活动的一部分且活动查找成功时包含。即使 campaign_id 存在，campaign_code 也可能缺失。

用例

使用 status_code 跟踪发送结果，无论在同一旅程中其他地方使用了何种渠道。
根据发送的短信数量创建用户 Segments（细分）。
在 Events history（事件历史）中查看发送给用户的所有短信，并分析用户的后续行为。

PW_WhatsAppSent

仅适用于 WhatsApp

此事件在 WhatsApp 消息发送到 WhatsApp 提供商后触发一次。检查 status_code 以了解结果。

事件属性

message_id (字符串)：消息的 ID。
message_code (字符串)：特定 WhatsApp 消息的唯一标识符。
status_code (整数)：WhatsApp 提供商为此发送尝试返回的投递状态码。用它来区分成功与失败。
campaign_id (字符串)：活动的 ID。仅当 WhatsApp 消息作为活动的一部分发送时才包含。
campaign_code (字符串)：活动的唯一代码。当发送是活动的一部分且活动查找成功时包含。即使 campaign_id 存在，campaign_code 也可能缺失。

用例

使用 status_code 跟踪发送结果，与投递或已读状态分开。
根据发送的 WhatsApp 消息数量创建用户 Segments（细分）。
在 Events history（事件历史）中查看发送给用户的所有 WhatsApp 消息，并分析用户的后续行为。

PW_WhatsAppReceived

仅适用于 WhatsApp

当通过系统接收到 WhatsApp 消息时，此事件会触发。

事件属性

message (字符串)：接收到的消息内容。对于位置消息，包含 "latitude,longitude" 格式的坐标（例如 "55.751244,37.618423"）。
latitude (数字)：共享位置的纬度。仅当用户分享其当前位置时包含。
longitude (数字)：共享位置的经度。仅当用户分享其当前位置时包含。

这些属性仅当 WhatsApp 提供商发送它们时，在 Click-to-WhatsApp 对话的第一条消息中包含：

ctwa_clid (字符串)：开始对话的 Click-to-WhatsApp 广告的点击 ID。用它进行转化归因——每个值对于每次点击都是唯一的，因此对细分没有用处。
referral_source_id (字符串)：开始对话的广告或帖子的 ID。当来源是广告时，这与 Meta Ads Manager 中显示的广告 ID 相同；帖子不会在那里列出。
referral_source_type (字符串)：引荐来源的类型，例如广告或帖子。
referral_source_url (字符串)：开始对话的广告或帖子的 URL。
referral_headline (字符串)：广告的标题文本。
referral_body (字符串)：广告的正文文本。

用例

响应收到的 WhatsApp 消息自动执行后续操作（例如开始 Customer Journey 或跟踪用户参与事件）。
根据用户的 WhatsApp 消息互动对用户进行细分，以实现有针对性的消息传递或个性化活动。
当用户分享其位置时，使用 latitude 和 longitude 属性触发基于位置的旅程。
使用 ctwa_clid 和 referral_* 属性将对话归因于启动它的特定 Click-to-WhatsApp 广告。
使用 WhatsApp Ad Click ID 和 WhatsApp Ad Click Date 设备标签，这些标签在对话结束后仍然存在，以创建点击了广告并随后转化的用户的 Segments（细分）。