文档CampaignCampaign Classic v7 文档

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

配置管道 configuring-pipeline

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

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

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

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

先决条件 prerequisites

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

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

由于管道托管在Adobe Experience Cloud中，因此需要进行身份验证。 它使用通过Adobe Developer项目支持的身份验证。

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

您必须为组织启用触发器集成的Adobe Developer帐户令牌。

在本页中了解如何创建您的Adobe技术帐户。 请注意，将API添加到Adobe Developer凭据时需要选择​ Adobe Analytics。

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

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

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

  1. 在Adobe Campaign中，访问​ Explorer ​中​ Administration > Platform > Options ​下的选项菜单。

  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

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

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

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

管道选项建议 pipeline-option-recommendation

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

  • 在​ Triggers ​下添加或编辑触发器。
  • 确保JSON有效。
  • Name ​参数对应于触发器ID。 通配符“*”将捕获所有触发器。
  • Consumer ​参数对应于调用实例或应用程序的名称。
  • 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进程需要自动启动。

为此，将配置文件中的<pipelined>元素设置为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