使用自定义操作 use-custom-actions

在此页面上:​了解如何在应用数据治理和同意策略时,使用自定义操作,通过带有JSON有效负载的REST API调用将历程连接到第三方系统。

使用自定义操作启用与第三方系统的连接,以发送消息或API调用。 可以使用任何提供商的任何服务配置操作,这些服务可以通过具有 JSON 格式有效负载的 REST API 调用。

此部分中了解自定义操作的详细信息。

了解如何在此页面上创建和配置自定义操作。

了解如何在此页面上使用自定义操作的API调用响应进行个性化。

同意和数据治理 privacy

在Journey Optimizer中,您可以将数据治理和同意策略应用于自定义操作,以防止将特定字段导出到第三方系统,或排除未同意接收电子邮件、推送或短信通信的客户。 有关更多信息,请参阅以下页面:

URL 配置

自定义操作​活动的配置窗格显示针对自定义操作配置的URL配置参数和身份验证参数。 您无法在历程中设置URL的静态部分,但可以在自定义操作的全局配置中设置。 了解详情

动态路径

如果URL包含动态路径,请在​ 路径 ​字段中指定路径。

要连接字段和纯文本字符串,请使用高级表达式编辑器中的字符串函数或加号(+)。 将纯文本字符串用单引号(‘)或双引号(’')括起来。 了解详情

下表显示了一个配置示例:

字段
URL
https://xxx.yyy.com:8080/somethingstatic/
路径
The _id + '/messages'

连接的URL具有以下形式:

https://xxx.yyy.com:8080/somethingstatic/<ID>/messages

具有动态参数映射的自定义操作URL配置

标头和查询参数 headers

URL配置​部分显示动态标头和查询参数字段,但不显示常量字段。 在操作配置屏幕中,动态标头和查询参数字段被定义为变量。 了解详情

要指定动态标题和查询参数字段的值,请在字段内或铅笔图标上单击,然后选择所需字段。

自定义操作中的 动态标头字段配置

操作参数

在​ 操作参数 ​部分中,您将看到定义为​ "变量" ​的消息参数。 对于这些参数,您可以定义从何处获取此信息(例如:事件、数据源)、手动传递值或针对高级用例使用高级表达式编辑器。 高级用例可以是数据操作和其他功能使用。 请参见此页面

AI知识参考

本节包含结构化知识,用于支持与本主题相关的解释、检索和问答。

要全面了解相关信息,应将此信息与本页上的文档相结合。 这两个源都不是独立的;页面描述了功能,而本节提供了其他上下文来帮助消除术语、意图、适用性和约束条件的歧义。

  • TL;DR:​本页介绍如何在历程中添加和配置自定义操作活动,以使用JSON有效负载调用第三方REST API,包括URL配置、标头/查询参数映射、操作参数映射,以及应用数据治理和同意策略。

意图:

  • 向历程添加自定义操作活动,以通过REST API将数据发送到第三方系统
  • 通过在表达式编辑器中连接字段和静态文本来配置动态URL路径
  • 映射历程事件或数据源中的动态标头和查询参数值
  • 将操作参数(定义为变量)映射到事件字段、数据源字段或静态值
  • 应用数据治理和同意策略以控制通过自定义操作导出的数据

术语表:

  • 自定义操作:历程操作活动,该活动调用具有JSON格式有效负载的外部REST API终结点以集成第三方系统​(产品特定)
  • 动态路径:使用历程上下文​ (特定于产品) ​中的字段为每个执行定义的自定义操作URL的变量部分
  • 操作参数:在自定义操作配置中定义为“变量”的消息有效负载字段,映射到历程级别​(产品特定)的历程数据

护栏:

  • 无法在历程中修改URL的静态部分;必须在全局自定义操作配置中设置它。
  • 动态标头和查询参数字段在操作配置屏幕中定义为变量,而不是在历程中。
  • 可应用数据治理和同意策略以防止导出特定字段或排除未经同意的客户。

术语:

  • 规范名称:自定义操作 — 首字母缩略词:none — 变体:自定义操作,第三方操作
  • 同义词: “action parameters” = “message parameters defined as Variable”
  • 请勿混淆:“静态URL部分”(在全局操作配置中设置,在历程中不可编辑)≠“动态路径”(在每次执行的历程中设置)

常见问题解答:

  • 问:能否更改历程中自定义操作的基本URL? — 不能,只能在历程中设置动态路径部分;URL的静态部分在全局自定义操作配置中配置。
  • 问:如何生成包含配置文件ID的动态URL路径? — 将路径字段与高级表达式编辑器一起使用,以将ID字段与静态字符串连接起来,例如: _id + '/messages'
  • 问:如何将同意规则应用于自定义操作? — 在自定义操作上配置同意策略以排除未同意接收相关通信的客户;有关详细信息,请参阅同意页面。
  • 问:应将动态标头的值映射到何处? — 在活动窗格的“URL配置”部分中,单击动态标题字段的内部,或使用铅笔图标从事件或数据源中选择所需的字段。
  • 问:可以为操作参数分配哪些类型的值? — 可以将参数映射到事件字段、数据源字段、手动传递值,或使用高级表达式编辑器进行数据处理。
recommendation-more-help
journey-optimizer-help