跳到内容
开发者文档支持 请求演示 登录
Pushwoosh.com

默认事件

什么是默认事件

Anchor link to

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

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

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

  1. 导航到 Audience 部分内的 Events 选项卡。
  2. 点击 Create Event。
  3. 从下拉菜单中选择 Default Event。
  4. 在弹出窗口中，选择所需的事件并点击 Activate。
显示可激活事件的默认事件下拉菜单

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

PW_DeviceRegistered

Anchor link to

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

用例

  • 为新注册用户启动引导营销活动 – 将使用 PW_DeviceRegistered 事件的基于触发器的入口添加到引导 Customer Journey 中
  • 通过事件统计数据识别为您带来更多新用户的获客活动
  • 在用户首次访问时就与他们互动：通过由 DeviceRegistered 事件触发的 In-App 消息来迎接他们
由 DeviceRegistered 事件触发的用于引导新用户的 In-App 消息

PW_DeviceUnregistered

Anchor link to

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

事件属性

  • message_id (string)
  • message_code (string)
  • campaign_id (string)

用例

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

PW_ApplicationOpen

Anchor link to

仅适用于移动应用

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

事件属性

  • device_type (整数设备类型代码，详情请参阅 registerDevice)
  • application_version

用例

  • 基于 ApplicationOpen 事件统计数据收集用户留存统计信息
  • 为应用内的活跃用户开展 In-App 消息营销活动

PW_ScreenOpen

Anchor link to

仅适用于移动应用

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

事件属性

  • application_version
  • device_type (整数设备类型代码，详情请参阅 registerDevice)
  • screen_name (从您的应用获取的技术屏幕名称)

用例

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

PW_ApplicationMinimized

Anchor link to

仅适用于移动应用

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

事件属性

  • device_type (整数设备类型代码，详情请参阅 registerDevice)
  • application_version

用例

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

PW_UserIdle

Anchor link to

仅适用于移动应用

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

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

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

事件属性

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

行为

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

用例

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

PW_ApplicationExit

Anchor link to

仅适用于移动应用

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

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

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

事件属性

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

行为

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

用例

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

PW_SiteOpened

Anchor link to

仅适用于 Web 平台

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

事件属性

  • device_type (整数设备类型代码，详情请参阅 registerDevice)
  • title – 所访问页面的标题
  • url – 所访问页面的 URL

用例

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

PW_InAppPurchase

Anchor link to

仅适用于移动应用

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

要实现 In-App Purchase 事件：

  • 对于 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 – 购买状态

用例

  • 收集应用内购买的统计数据
  • 开展促销活动并跟踪其成功情况：在促销消息后设置“等待触发器”事件
显示带有 In-App Purchase 事件的“等待触发器”步骤的 Customer Journey 配置

PW_NotificationOpen

Anchor link to

适用于移动和 Web 平台

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

用例

PW_NotificationSend

Anchor link to

适用于移动和 Web 平台

当 Pushwoosh 消息发送到用户设备时，此事件会触发一次。

事件属性

  • message_id (string)
  • message_code (string)
  • campaign_id (string)

用例

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

PW_EmailLinkClicked

Anchor link to

仅适用于电子邮件平台

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

事件属性

  • message_id (string)
  • message_code (string)
  • campaign_id (string)
  • redirect_link (string)
  • original_link (string)

用例

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

PW_EmailOpen

Anchor link to

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

事件属性

  • campaign_code (字符串)：与电子邮件关联的营销活动的唯一代码。
  • campaign_id (字符串)：营销活动的 ID。
  • message_code (字符串)：特定电子邮件消息的唯一标识符。
  • message_id (字符串)：消息的 ID

用例

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

PW_InAppShown

Anchor link to

当向用户显示 In-App 消息时，此事件会触发。

事件属性

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

用例

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

PW_InAppClicked

Anchor link to

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

事件属性

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

用例

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

PW_WhatsAppReceived

Anchor link to

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

事件属性

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

用例

  • 针对收到的 WhatsApp 消息自动执行后续操作（例如启动 Customer Journey 或跟踪用户参与度事件）。
  • 根据用户的 WhatsApp 消息互动对用户进行分群，以实现有针对性的消息传递或个性化营销活动。
  • 当用户共享其位置时，使用 latitude 和 longitude 属性触发基于位置的旅程。