文档CampaignCampaign Classic v7 文档

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

配置管道 configuring-pipeline

Last update: Fri Apr 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

在实例配置文件中配置身份验证参数，例如客户ID、私钥和身份验证端点。
要处理的触发器列表是通过JSON格式的选项配置的。
触发器由发送电子邮件的活动工作流用于定位。 活动设置为让具有两个触发事件的客户收到电子邮件。

先决条件 prerequisites

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

  • 最少，需要以下Adobe Campaign构建之一：

    • 19.1.8.9039
    • 19.1.4.9032 - Gold Standard 11
    • 20.2.4.9187
    • 20.3.1

  • Adobe Analytics Standard版本

您还需要：

  • Adobe I/O项目身份验证
  • 有效的组织ID — 要查找您的组织ID，请参阅 此页面
  • 具有组织访问权限的开发人员
  • 在Adobe Analytics中完成触发器配置

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

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

步骤1：创建/更新Adobe I/O项目 creating-adobe-io-project

对于托管客户，您可以创建客户关怀票证，以便为贵组织启用Triggers集成的Adobe I/O技术帐户令牌。

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

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

设置身份验证后，管道将检索事件。 它只会处理在Adobe Campaign中配置的触发器。 触发器必须从Adobe Analytics生成，并推送到管道，该管道仅处理在Adobe Campaign中配置的触发器。
也可以使用通配符配置选项，以捕获所有触发器，而不管其名称如何。

  1. 在Adobe Campaign中，访问 Administration > Platform > Options 在 Explorer.

  2. 选择 NmsPipeline_Config 选项。

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

    code language-none 
    {
"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-none 
    {
"topics": [
  {
    "name": "triggers",
    "consumer":  "customer_dev",
    "triggers": [
      {
        "name": "*",
        "jsConnector": "cus:pipeline.js"
      }
    ]
  }
]
}

Consumer参数 consumer-parameter

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

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

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

管道选项建议 pipeline-option-recommendation

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

  • 在下面添加或编辑触发器 Triggers，则不应编辑其余部分。
  • 确保JSON有效。 您可以使用JSON验证器，请参阅此 网站 例如。
  • “name”对应于触发器ID。 通配符“*”将捕获所有触发器。
  • “消费者”对应于调用实例或应用程序的名称。
  • 管道化还支持“别名”主题。
  • 进行更改后，应始终重新启动管道。

步骤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 >元素设置为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