# Customer Journey 中的掉队和跳过原因

通过双击已启动的 Journey 的某个节点，您可以查看掉队原因以及每个原因导致的掉队数量。

有几个事件根本不会显示在该面板中：它们在节点统计中被记录为 **Skipped**（已跳过）。请参阅[跳过原因](#skip-reasons)。

## 掉队原因

这些错误会将旅行者从 Journey 中移除。

### 账户已暂停

**含义：** 账户被禁用，因此 Pushwoosh API 不可用。这通常会在 Journey 到达下一个旅行者之前暂停整个 Journey。如果账户在某个步骤已经开始发送后被暂停，该特定步骤也可能因同样的原因使受影响的旅行者掉队。

**处理方法：** 联系[客户支持团队](https://help.pushwoosh.com/hc/en-us/requests/new/?utm_content=docs&utm_term=post&utm_campaign=troubleshooting)或您的专属客户成功经理以恢复访问权限。如果 Journey 已暂停，请在恢复访问后继续运行。

### 邮件达到上限

**含义：** 您账户的邮件发送限制已超出，因此该邮件无法发送。

**处理方法：** 联系[客户支持团队](https://help.pushwoosh.com/hc/en-us/requests/new/?utm_content=docs&utm_term=post&utm_campaign=troubleshooting)或您的客户成功经理以提高限制。

<span id="internal-error" />

### 内部错误

**含义：** 一个通用的错误指示，意味着 Journey 在此步骤无法为该旅行者继续进行。常见原因：

*   [**Time delay**](/zh/product/customer-journey/journey-elements/flow-controls/time-delay/)（时间延迟）元素引用的 Event 属性缺失，或者其值不符合预期的日期格式。同一元素中缺失 Tag 会导致[未找到 Tag](#tag-not-found)，但如果 Tag 存在但值格式错误，也会归为此类错误。
*   旅行者的 UserID 在 Journey 进行中发生了变化，导致系统无法再找到该配置文件以更新 Tag。
*   [**Send Push**](/zh/product/customer-journey/journey-elements/channels/push/)（发送推送）元素中使用的[推送预设](/zh/product/content/push-presets/)或模板存在问题。

**处理方法：** 对于时间延迟原因，请确保 Tag 是[日期类型](/zh/product/audience-data-and-segmentation/user-data-tags/tags#types-of-tags)，其值格式为 `2006-01-02T15:04:05`（UTC 时间），或者您在[创建 Event](/zh/product/audience-data-and-segmentation/events#1-create-events-in-pushwoosh-control-panel) 时使用了[日期类型的属性](/zh/product/audience-data-and-segmentation/events#2-set-attributes)，并通过 [/postEvent](/zh/developer/api-reference/user-centric-api#postevent) 发送时其值格式为 `2006-01-02 15:04:05`。对于其他原因，请检查受影响元素的配置和进入该步骤的旅行者数据，或联系[客户支持团队](https://help.pushwoosh.com/hc/en-us/requests/new/?utm_content=docs&utm_term=post&utm_campaign=troubleshooting)并提供 Journey 和元素的详细信息。

### 用户不匹配

**含义：** 设备的当前 UserID 与 Journey 中为其记录的 UserID 不匹配。

<Aside type="note">
例如，客户的电子邮件被记录在 UserID 参数中，然后被错误地分配给了另一个用户。如果您尝试在[更新用户配置文件](/zh/product/customer-journey/journey-elements/flow-controls/update-user-profile/)元素中设置一个特定于用户的 Tag，就会发生错误，因为该 Tag 被认为已经分配给了另一个用户。
</Aside>

**处理方法：** 检查设备注册过程，并确保在设备仍在 Journey 中活跃时，UserID 不会被转移给另一个用户。

### 未找到设备

**含义：** Pushwoosh 中没有关于进入 Journey 的 [HWID](/zh/product/pushwoosh-knowledge-hub/device-identifiers/#hwid) 的设备记录。这可能在以下情况下发生：

*   HWID 仅为 Pushwoosh 外部的系统所知，从未传递给 Pushwoosh，但某个 Event 仍然触发了 Journey。
*   设备之前已注册，但其 HWID 后来从数据库中被删除。

**处理方法：** 检查设备注册过程，并确保设备在触发进入 Journey 的 Event 之前已正确注册。

### 未找到用户

**含义：** Pushwoosh 中没有关于进入 Journey 的 [UserID](/zh/product/pushwoosh-knowledge-hub/users-userids/) 的用户记录。这可能在以下情况下发生：

*   UserID 仅为 Pushwoosh 外部的系统所知，从未传递给 Pushwoosh，但某个事件仍然触发了 Journey。
*   用户之前已注册，但其 UserID 后来从数据库中被删除。
*   UserID 是一个从未[与设备关联](/zh/developer/first-steps/collecting-user-ids/)的电子邮件地址，因此 Pushwoosh 无法识别该用户和邮件收件人为同一个人。

**处理方法：** 检查您的用户注册过程，并确保 UserID 值没有被错误地从数据库中删除。如果您使用电子邮件地址作为 UserID，请确保您的开发团队将其与设备关联。

### 未找到筛选器

**含义：** Journey 使用的[细分](/zh/product/audience-data-and-segmentation/segmentation/)在创建时存在，但在 Journey 启动后被删除。与此页面上的其他错误不同，这会停止整个 Journey，而不仅仅是受影响的旅行者。

**处理方法：** 已完成的 Journey 无法重新启动：克隆该 Journey，将克隆指向另一个细分（或重新创建已删除的细分），然后启动克隆。

### 未找到富媒体

**含义：** 此元素中使用的富媒体在 Journey 创建时存在，但在 Journey 启动后被删除。

**处理方法：** 在元素中选择另一个富媒体（或重新创建已删除的富媒体）。

<span id="tag-not-found" />

### 未找到 Tag

**含义：** [**Time delay**](/zh/product/customer-journey/journey-elements/flow-controls/time-delay/)（时间延迟）元素中使用的 Tag 未分配给某些旅行者，导致他们在该步骤掉队。

**处理方法：** 验证 Tag 是否已正确分配给旅行者且未被删除，或以不同方式设置**时间延迟**，以减少掉队的旅行者数量。

<Aside type="note">
这不适用于[**更新用户配置文件**](/zh/product/customer-journey/journey-elements/flow-controls/update-user-profile/)元素：如果它设置的 Tag 在 Journey 启动后被删除，该 Tag 更新将被静默跳过，旅行者不会掉队。
</Aside>

### 无效的推送预设

**含义：** 消息元素中使用的推送预设在 Journey 创建时存在，但在 Journey 启动后被删除。这会暂停整个 Journey，而不仅仅是受影响的旅行者。

**处理方法：** 在元素中选择另一个预设（或重新创建已删除的预设），然后继续已暂停的 Journey。

<span id="content-not-approved" />

### 内容未获批准

**含义：** [**Send Push**](/zh/product/customer-journey/journey-elements/channels/push/)（发送推送）或 [**Send Email**](/zh/product/customer-journey/journey-elements/channels/email/)（发送邮件）元素中使用的推送预设或邮件模板在 Journey 上次启动或继续时是**已批准**状态，但在 Journey 运行时变为**未批准**状态，例如在编辑后创建了一个新的**草稿**版本。在启动或继续前已经未获批准的内容会被[启动前检查](/zh/product/customer-journey/journey-settings/#pre-launch-check)更早地发现，这会阻止 Journey 启动或继续，直到您修复它。**Send Push** 元素也会暂停整个 Journey，而不仅仅是受影响的旅行者。**Send Email** 元素只会使受影响的旅行者掉队，并让 Journey 继续运行。

**处理方法：** 打开预设或模板，提交以供批准，并等待其状态变为**已批准**。如果 **Send Push** 元素暂停了 Journey，请在内容获批准后继续运行。

### 时间已过

**含义：** 根据指定的 Event 属性或 Tag，为[**时间延迟**](/zh/product/customer-journey/journey-elements/flow-controls/time-delay/)元素计算的时间已经过去。

**处理方法：** 以不同方式设置**时间延迟**，或检查所用 Event 属性或 Tag 中的日期值。

### 券池中已无优惠券

**含义：** 所选券池中已无未使用的优惠券。这包括已发送的优惠券，以及任何[从券池中删除的优惠券](/zh/product/content/vouchers#delete-vouchers)。

**处理方法：** [向券池中添加更多优惠券](/zh/product/content/vouchers#add-vouchers-to-an-existing-pool)。

### 券池已被删除

**含义：** 元素中使用的券池在 Journey 创建时存在，但在 Journey 启动后被删除。

**处理方法：** 在元素中连接一个不同的券池。已删除的券池无法恢复。

### 券池已过期

**含义：** 券池的到期日期已过，因此无法再发送其中的优惠券。

**处理方法：** [创建一个新的券池](/zh/product/content/vouchers#create-a-voucher-pool)，设置一个更晚的到期日期（或无到期日期）并在元素中连接它，或者连接一个尚未过期的不同券池。

<span id="request-error" />

### 请求错误

**含义：** [**Webhook**](/zh/product/customer-journey/journey-elements/channels/webhook/) 元素的请求未能完成：网络错误、超时、目标 URL 无效或被阻止（私有、内部、环回或链路本地，包括云元数据）、超出账户的 webhook 速率限制、目标因重复失败而进入冷却期，或目标返回非 2xx 响应（在 Pushwoosh 自己的重试之后，针对 `500`、`502`、`503` 或 `504`）。如果在发送请求前 URL 或请求体模板渲染失败，则归类为[内部错误](#internal-error)；元素中的无效标头会从请求中静默删除，而不会导致任何一种错误。

**处理方法：** 检查目标 URL 是否正确、公开且可访问，并确保其返回成功（2xx）响应。有关确切条件，请参阅[超时、重试和失败的请求](/zh/product/customer-journey/journey-elements/channels/webhook/#timeout-retries-and-failed-requests)。

<span id="no-user-id" />

### 无 User ID

**含义：** 旅行者到达 [**Issue Wallet Pass**](/zh/product/customer-journey/journey-elements/channels/issue-wallet-pass/)（发放钱包通票）元素时没有 [User ID](/zh/product/pushwoosh-knowledge-hub/users-userids/)。钱包通票是发给用户的，而不是匿名设备，因此没有发放对象。此操作不会重试。

**处理方法：** 检查您应用的用户注册流程，并确保在旅行者到达此元素之前设置了 User ID。

<span id="pass-issuance-failed" />

### 通票发放失败

**含义：** [**Issue Wallet Pass**](/zh/product/customer-journey/journey-elements/channels/issue-wallet-pass/)（发放钱包通票）元素无法从其配置的某个活动中发放通票，例如因为该活动已被删除或归档。此操作不会重试。

**处理方法：** 打开元素并检查其配置的活动是否仍然存在且未被归档。草稿状态的活动可以正常发放通票，无需处于活动状态。如果需要，请选择一个不同的活动。已删除的活动无法恢复。

<span id="skip-reasons" />

## 跳过原因

这些事件不会出现在掉队面板中：旅行者会照常继续到下一步，并且节点的统计数据会将其记录为 **Skipped**（已跳过）。

### 达到频次上限

**含义：** 旅行者在此步骤已达到[频次上限](/zh/product/messaging-channels/message-delivery-settings/frequency-capping/)。这是预期行为：消息被跳过，但旅行者继续在 Journey 中。

**处理方法：** 无需任何操作。要更改此情况的发生频率，请调整您的频次上限设置。

### 无匹配标识符

**含义：** 在 [**Audience sync**](/zh/product/customer-journey/journey-elements/flow-controls/audience-sync/)（受众同步）元素中，旅行者没有任何匹配所选受众所需的标识符。该旅行者在此步骤被跳过，并继续在 Journey 中。

**处理方法：** 对该旅行者无需任何操作。要减少此情况的发生频率，请在您的 Meta Ads 集成设置中配置用户数据映射（**Map user data**），以提高标识符匹配质量。