自定义操作故障排除 troubleshoot-a-custom-action
您可以通过从Journey Optimizer用户界面的“管理”部分发送API调用来测试自定义操作。 此功能可帮助您在历程中使用自定义操作之前或之后对其进行故障诊断。
作为管理员，使用 发送测试请求 功能，通过直接从Adobe Journey Optimizer发出真正的API调用来验证自定义操作配置。 此功能可确保请求结构、标头、身份验证和有效负载的格式正确，然后才能在历程中使用。
使用此功能可简化测试和验证过程，确保自定义操作在实时历程中正常运行。
先决条件 troubleshoot-custom-action-prereq
要使用 发送测试请求 功能，必须使用URL、标头和身份验证设置预配置自定义操作。
管理员若要使用此功能，需要以下权限：
- 用户必须具有 Manage journeys events, data sources and actions 权限。
- 此权限包含在 历程管理员 角色中。
- 仅使用 View journeys events 权限是不够的。
在本节中了解有关历程权限的更多信息。
如何使用发送测试请求功能 troubleshoot-custom-action-use
要测试自定义操作，请执行以下步骤：
-
导航到 操作 配置屏幕，然后选择自定义操作。
-
单击操作配置屏幕底部的 发送测试请求 按钮。
在操作配置面板中
-
在弹出窗口中，允许您指定请求参数：
-
如果自定义操作方法为GET，则无需任何有效负载。
-
如果自定义操作方法为POST，则必须提供JSON有效负载。
note note NOTE 如果此JSON的结构不正确，Adobe Journey Optimizer将引发错误；但是，如果数据类型不匹配，则不会引发此错误。 例如，如果将整数参数用于应该是字符串的内容，则不会发生错误。 -
如果定义了身份验证，系统将提示您输入身份验证详细信息。
-
-
单击 发送 以执行请求。
-
来自API的响应（包括标头和状态代码）将显示在界面中。
身份验证处理 troubleshoot-custom-action-auth
当自定义操作包括身份验证时，Adobe Journey Optimizer要求用户为每个测试请求输入身份验证详细信息：
- 基本身份验证：用户必须提供密码。
- API密钥身份验证：用户必须输入API密钥值。
- 自定义身份验证：用户必须在请求 bodyParam 中提供身份验证参数。 在此情况下添加了两个部分： 身份验证请求和身份验证响应。
主要优点 troubleshoot-custom-action-benefits
作为Journey Optimizer管理员，您还可以使用外部工具(例如Postman)来测试自定义操作。 与外部测试相比，产品内故障排除功能的主要优势如下：
-
测试请求由 AJO历程 执行，这意味着：
- 使用确切的请求结构(包括Adobe Journey Optimizer特定的标头)。
- 源IP和标头与实时历程中使用的相匹配。
-
发送测试请求功能可用于对 实时历程 进行故障排除，因为已部署自定义操作。
-
这种产品内测试功能消除了手动在工具之间复制配置详细信息的需要，从而降低了错误风险。
疑难解答 troubleshoot-custom-action-check
如果请求失败，您可以检查：
- 在测试中输入的身份验证凭据。
- 请求方法(GET与POST)以及相应的有效负载。
- 在自定义操作中定义的API端点和标头。
- 使用响应数据识别潜在的错误配置。
处理放弃事件和空闲超时 handling-discard-events-and-idle-timeouts
当一个历程中的自定义操作触发旨在启动 第二个历程 的事件时，请确保第二个历程处于有效状态并且事件被识别。 如果事件不符合第二个历程的进入条件，则该事件可以是已丢弃，并显示在包含notSuitableInitialEvent等代码的日志中。 如果第二个历程未准备就绪，可能会发生空闲超时，从而导致日志中丢弃事件。
常见原因：
-
不符合事件资格 — 第二个历程使用具有资格条件的基于规则的事件（例如，必填字段必须为非空，如特定字段上的
isNotEmpty）。 如果事件有效负载不满足该条件（例如，字段为空或缺少该字段），则事件为已接收但已放弃，并且未触发第二个历程。 这是预期行为；文档和日志确认，如果不满足资格条件，则将放弃事件，并且不会为该用户档案触发历程。 验证自定义操作发送的有效负载是否包含第二个历程的事件配置所需的所有字段和值。 了解如何在历程执行中配置基于规则的事件和事件接收疑难解答。 -
第二个历程未就绪 — 如果第二个历程尚未处于活动状态（例如，未处于测试模式或未处于实时状态），或者自定义操作触发与第二个历程准备接收之间存在时间间隔，则可能会发生空闲超时。 在触发自定义操作之前，请确保目标历程已发布或处于测试模式。
-
正在诊断放弃事件 — 如果在日志中看到放弃事件，请检查历程日志和Splunk跟踪以确认是否已收到该事件，但由于资格（有效负载不符合规则）或时间限制已将其丢弃。 确保第二个历程的开始日期和配置正确，并且历程处于其活动日期范围内。
要避免在通过自定义操作链接历程时放弃事件，请根据第二个历程的事件规则验证事件有效负荷，并确认目标历程为实时历程或处于测试状态且处于活动日期范围内。
其他资源
浏览以下部分，了解有关配置和使用自定义操作的更多信息：
- 自定义操作入门 — 了解什么是自定义操作以及它们如何帮助您连接到第三方系统
- 配置自定义操作 — 了解如何创建和配置自定义操作
- 使用自定义操作 — 了解如何在历程中使用自定义操作
- 将集合传递到自定义操作参数 — 了解如何在运行时动态填充的自定义操作参数中传递集合