[也适用于v8]{class="badge positive" title="也适用于Campaign v8"}

配置管道 configuring-pipeline

在实例配置文件中配置身份验证参数,例如客户ID、私钥和身份验证端点。

要处理的触发器列表是通过JSON格式的选项配置的。

触发器由发送电子邮件的活动工作流用于定位。 活动设置为让具有两个触发事件的客户收到电子邮件。

先决条件 prerequisites

在开始此配置之前,请检查您是否拥有:

  • Adobe Developer项目
  • 有效的组织ID — 要查找您的组织ID,请参阅 此页面
  • 具有组织访问权限的开发人员
  • Adobe Analytics中的有效触发器配置

身份验证和配置文件 authentication-configuration

由于管道托管在Adobe Experience Cloud中,因此需要进行身份验证。 它使用一对公钥和私钥。 此进程与用户/密码具有相同的功能,但更加安全。 Marketing Cloud支持通过Adobe Developer项目进行身份验证。

步骤1:创建/更新您的Adobe Developer项目 creating-adobe-io-project

对于托管客户,请与您的Adobe代表/客户关怀团队合作,为贵组织启用Adobe Developer帐户令牌以进行Triggers集成。

对于内部部署/混合部署客户,请参阅 为Adobe Experience Cloud Triggers配置Adobe I/O 页面。 请注意,您需要选择 Adobe Analytics 将API添加到Adobe Developer凭据时。

步骤2:配置管道选项 configuring-nmspipeline

设置身份验证后,管道将检索事件。 它只会处理在Adobe Campaign中配置的触发器。 触发器必须从Adobe Analytics生成,并推送到管道,该管道仅处理在Adobe Campaign中配置的触发器。

也可以使用通配符配置选项,以捕获所有触发器,而不管其名称如何。

  1. 在Adobe Campaign中,访问 Administration > Platform > OptionsExplorer.

  2. 选择 NmsPipeline_Config 选项。

  3. Value (long text) 字段中,可以粘贴以下JSON代码,该代码指定了两个触发器。 您需要确保删除注释。

    code language-json
    {
    "topics": [ // list of "topics" that the pipelined is listening to.
       {
            "name": "triggers", // Name of the first topic: triggers.
            "consumer": "customer_dev", // Name of the instance that listens.  This value can be found on the monitoring page of Adobe Campaign.
            "triggers": [ // Array of triggers.
                {
                    "name": "3e8a2ba7-fccc-49bb-bdac-33ee33cf02bf", // TriggerType ID from Analytics
                    "jsConnector": "cus:triggers.js" // Javascript library holding the processing function.
                }, {
                    "name": "2da3fdff-13af-4c51-8ed0-05802a572e94", // Second TriggerType ID
                    "jsConnector": "cus:triggers.js" // Can use the same JS for all.
                },
            ]
        }
    ]
    }
    
  4. 您还可以选择粘贴以下捕获所有触发器的JSON代码。

    code language-json
    {
    "topics": [
      {
        "name": "triggers",
        "consumer":  "customer_dev",
        "triggers": [
          {
            "name": "*",
            "jsConnector": "cus:pipeline.js"
          }
        ]
      }
    ]
    }
    

设置Consumer参数 consumer-parameter

管道的工作方式与供应商和消费者模型类似。 消息仅供个人消费者使用:每个消费者均可获得其自己的消息副本。

消费者 parameter将实例标识为这些使用者之一。 实例的标识将调用管道。 您可以使用实例名称填充该实例,该名称可在客户端控制台的“监视”页面上找到。

管道服务会跟踪每个使用者检索到的消息。 对不同的实例使用不同的使用者,这可以确保将每条消息都发送到每个实例。

管道选项建议 pipeline-option-recommendation

要配置管道选项,您应该遵循以下建议:

  • 在下面添加或编辑触发器 Triggers.
  • 确保JSON有效。
  • 名称 参数对应于触发器ID。 通配符“*”将捕获所有触发器。
  • 消费者 参数对应于调用实例或应用程序的名称。
  • pipelined进程还支持“别名”主题。
  • 您应始终重新启动 pipelined进行更改后的进程。

步骤3:可选配置 step-optional

您可以根据负载要求更改某些内部参数,但请确保在将它们应用于生产环境之前对其进行测试。

可选参数列表为:

选项
说明
appName(旧版)
在上传公钥的旧版Oath应用程序中注册的OAuth应用程序的AppID。 有关更多信息,请参阅此页面
authGatewayEndpoint(旧版)
用于获取网关令牌的URL。 默认: https://api.omniture.com
authPrivateKey(旧版)
旧版Oath应用程序中上传的私钥、公共部分,使用XtkKey选项加密的AES: cryptString("PRIVATE_KEY")
disableAuth(旧版)
禁用身份验证,只有某些开发管道端点接受不使用网关令牌进行连接。
discoverPipelineEndpoint
用于查找要用于此租户的管道服务端点的URL。 默认: https://producer-pipeline-pnw.adobe.net
dumpStatePeriodSec
中的两个内部状态进程转储之间的周期 var/INSTANCE/pipelined.json.
内部状态也可在此处按需访问: http://INSTANCE:7781/pipelined/status
forcedPipelineEndpoint
禁用检测PipelineServicesEndpoint以强制执行该操作
monitorServerPort
管道化进程将侦听此端口,以在此处提供内部状态进程: http://INSTANCE:PORT/pipelined/status.
默认为7781
pointerFlushMessageCount
当处理此数量的消息时,偏移将保存在数据库中。
默认值为1000
pointerFlushperiodSec
在此时段之后,偏移将保存在数据库中。
默认为5(秒)
processingJSThreads
使用自定义JS连接器处理消息的专用线程数。
默认为4
processingThreads
使用内置代码处理消息的专用线程数。
默认为4
retryPeriodSec
发生处理错误时重试之间的延迟。
默认为30(秒)
retryValidSec
如果在此时段后未成功处理消息(重试次数过多),则放弃该消息。
默认值为300(秒)

流水线进程自动启动 pipelined-process-autostart

pipelined 进程需要自动启动。

为此,请设置 <流水线> 元素(to autostart="true"):

 <pipelined autoStart="true" ... "/>

管道化进程重新启动 pipelined-process-restart

需要重新启动才能使更改生效:

nlserver restart pipelined@instance

步骤4:验证 step-validation

要验证用于配置的管道设置,请执行以下步骤:

  • 确保 pipelined 进程正在运行。
  • 查看 pipelined.log 用于管道连接日志。
  • 验证连接以及是否接收到ping。 托管客户可以从客户端控制台使用监控。
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1