基于触发器的入口

基于触发器的入口会在用户执行特定事件（例如，采取特定操作）时启动 Journey。

提示

您可以添加多个基于触发器的入口点。在这种情况下，任何一个入口点都会启动 Journey。

要设置基于触发器的入口，请在画布上找到入口元素，并选择将用作触发器的事件。

有关如何配置事件的更多信息，请参阅事件文档。

如果所选事件具有属性，您可以使用这些属性来缩小入口条件。编辑元素时，单击添加条件，然后从下拉列表中选择一个属性，并定义其运算符和值。

重要提示

• 与您的开发团队合作，确保 HWID (硬件 ID) 正确包含在 Journey 的启动事件的 /postEvent API 请求中。否则，用户将无法进入 Journey。
• UserID 不适用于在 Customer Journey 中识别用户。

定义谁进入营销活动

定义当特定事件发生时，哪个（些）用户应进入 Journey。

使用**谁进入营销活动？**下拉菜单在两种可用模式之间进行选择：

执行事件的用户（默认）

触发事件的用户就是进入 Journey 的用户。

示例 用户完成购买（CheckoutSuccess 事件）。该用户（例如，User ID: 123）进入一个购买后 Journey，其中包含感谢消息、产品推荐或满意度调查。

来自事件属性的用户

您可以在自定义事件属性中传递一个或多个 User ID，而不是让触发事件的用户进入 Journey。该属性中列出的用户将进入 Journey。

为此，请选择来自事件属性的用户，并选择一个属性键（例如，recipient_ids、target_user_id）。此键应与您的事件 payload 结构匹配。

需要开发者协助

要正确使用来自事件属性的用户模式，您的应用或后端必须发送正确的 payload 结构。请与您的开发团队分享以下示例。

示例 payload（单个用户）

{
  "application": "XXXXX-XXXXX",
  "event": "invitation",
  "attributes": {
      "targetId": 321
  },
  "userId": 123
}

用户 321（来自 targetId）进入 Journey。

示例 payload（多个用户）

如果您提供多个 User ID，请使用一个字符串的 JSON 数组。

{
    "application": "XXXXX-XXXXX",
    "event": "invitation",
    "attributes": {
        "targetIds": [1,2,3,4]
    },
    "userId": 123
}

用户 1、2、3 和 4 将进入 Journey。

用例

评论通知

当有人评论用户的帖子时，帖子所有者会收到通知。

**示例：**评论事件在 target_user_id 属性中包含帖子所有者的 ID。该用户进入一个 Journey 以接收通知。

推荐计划

当被推荐的用户注册或进行购买时，推荐人将被添加到 Journey 中。

**示例：**用户 123 触发事件，推荐人 456（来自 referrer_id 属性）进入奖励活动。

礼品购买

当用户购买礼品时，收件人将使用事件 payload 中的 recipient_user_id 被添加到 Journey 中。

示例 用户 123 为用户 456 购买了一份礼物，然后用户 456 会收到通知、入门流程或感谢消息。

设置入口可用性

控制用户何时可以通过基于触发器的入口进入 Journey。您有两个选项：

• 允许随时进入：只要触发事件发生，用户就可以进入 Journey。

• 将进入限制在特定时期：只有在选定的日期范围内发生触发事件，用户才能进入 Journey。

  限制进入时，请选择开始日期、结束日期和时区。根据所选时区，进入窗口从开始日期的 00:00 开始，到结束日期的 23:59 结束。

控制用户可以同时拥有多少个会话

决定每个用户是只能一次加入一个 Journey，还是可以并行参与多个 Journey。

从下拉菜单中选择以下选项之一：

• 每个用户一个活动会话
• 每个用户多个活动会话

每个用户一个活动会话

每个用户在营销活动中只能有一个活动会话。他们必须完成或退出当前会话才能开始新会话。

用例

• 入门流程，用户在完成当前 Journey 之前不应重新开始
• 订阅续订提醒，用户不应收到重叠的通知
• 限时优惠或试用，每个用户只允许运行一个活动营销活动
• 反馈收集活动，确保每个用户在重新进入前只提供一次输入

每个用户多个活动会话

用户可以在一个营销活动中拥有多个活动会话。每个会话必须由一个唯一的事件属性（例如 order_id、product_id）来标识。

要进行此设置：

1. 在下拉菜单中选择每个用户多个活动会话。

2. 选择一个会话标识符属性（例如 order_id、product_id）。此属性将用于区分不同会话。

重要提示

此属性必须包含在所有相关的 Journey 事件中（例如，在等待触发器或转化目标中）。如果缺少会话标识符属性，系统将无法将事件链接到特定会话。相反，该事件将应用于该用户的所有活动会话。

示例

• OrderPlaced 带有 order_id = "1001" → 启动会话 1

• OrderPlaced 带有 order_id = "1002" → 启动会话 2

如果发送的 OrderReady 事件没有 order_id，那么会话 1 和会话 2 都将被标记为“就绪”，即使实际上只有一个订单准备好了。

用例

• 电子商务购买：每个订单启动自己的 Journey，因此可以独立跟踪来自一个用户的多个订单。（属性：order_id）
• 推荐计划：每次推荐都会创建一个新会话，允许一个用户推荐多个朋友。（属性：referral_id）
• 忠诚度计划：跟踪并行运行的不同交易中的积分或奖励。（属性：transaction_id）
• 票务预订：每次预订都会启动自己的 Journey，因此用户可以一次管理多张票。（属性：booking_id）
• 预约安排：每次预约都作为单独的会话处理。（属性：appointment_id）

配置完入口元素后，单击应用以保存更改。

示例场景：具有多个会话的电子商务订单 Journey

假设您想为用户下的每个订单发送通知。每个订单都应该有自己的 Journey 会话。为此，您将使用 OrderPlaced 事件作为触发器，并使用属性 order_id 作为会话标识符。

1. 创建事件 OrderPlaced 并确保它包含属性 order_id。了解有关创建事件的更多信息

2. 将此事件设置为您的 Journey 的触发器。

3. 在会话设置中，选择每个用户多个活动会话并选择 order_id 作为会话标识符。

在此设置中，每个新订单都会启动一个单独的 Journey 会话。

• OrderPlaced 带有 order_id = 1001 启动会话 1
• OrderPlaced 带有 order_id = 1002 启动会话 2

4. 接下来，添加一个等待触发器元素来跟踪订单何时准备好取货或交付。使用事件 OrderReady，该事件也必须包含相同的 order_id。 这可确保每个订单都在正确的会话中更新：

• OrderReady 带有 order_id = 1001 仅适用于会话 1
• OrderReady 带有 order_id = 1002 仅适用于会话 2

重要提示

如果事件不包含 order_id，系统将无法判断它属于哪个会话，该事件将应用于该用户的所有活动会话。

5. 最后，添加一个转化目标，例如 OrderDelivered 事件。此事件也必须包含相同的 order_id，以便可以将其匹配到正确的会话。

• 如果 OrderDelivered 包含 order_id = "1001"，它会为会话 1 记录一次转化。

• 如果 OrderDelivered 包含 order_id = "1002"，它会为会话 2 记录一次转化。

重要提示

如果缺少 order_id，转化将应用于该用户的所有活动会话，而不仅仅是预期的那一个。