設定管線

驗證參數（如客戶ID、私鑰和驗證終結點）在實例配置檔案中配置。
要處理的觸發器清單以JSON格式的選項配置。
觸發器用於由發送電子郵件的市場活動工作流進行瞄準。 設定市場活動，以便具有兩個觸發事件的客戶接收電子郵件。

必要條件

在啟動此配置之前，請檢查您正在使用：

  • 最少，以下Adobe Campaign構建之一：
    • 19.1.8.9039
    • 19.1.4.9032 — 金標11
    • 20.2.4.9187
    • 20.3.1
  • Adobe Analytics Standard版本

您還需要：

  • Adobe I/O項目身份驗證
  • 有效的組織ID — 要查找組織ID，請參閱 此頁
  • 開發人員訪問您的組織
  • 觸發器配置在Adobe Analytics完成

驗證和配置檔案

由於管道在Adobe Experience Cloud托管，因此需要身份驗證。
它使用一對公鑰和私鑰。 此進程與用戶/密碼具有相同的功能，但更安全。
通過Marketing Cloud項目支援Adobe I/O。

步驟1:建立/更新Adobe I/O項目

對於托管客戶，您可以建立客戶服務票證，以啟用您的組織，並使用Adobe I/O技術帳戶令牌進行觸發器整合。

對於現場客戶，請參閱 為Adobe Experience Cloud Triggers配置Adobe I/O 的子菜單。 請注意，您需要選擇 Adobe Analytics 將API添加到Adobe I/O憑據。

步驟2:配置NmsPipeline_Config管線選項

一旦設定了驗證，管道將檢索事件。 它將僅處理在Adobe Campaign中配置的觸發器。 觸發器必須是從Adobe Analytics生成的，並被推入到管道，該管道將僅處理在Adobe Campaign配置的觸發器。
也可以使用通配符配置該選項，以捕獲所有觸發器，而不考慮其名稱。

  1. 在Adobe Campaign，訪問 Administration > Platform > Options 的 Explorer。

  2. 選擇 NmsPipeline_Config 的雙曲餘切值。

  3. 在 Value (long text) 欄位中，可以貼上以下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代碼。

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

Consumer參數

管道的工作方式類似於供應商和消費者模型。 消息僅用於單個用戶：每個消費者都會得到自己的郵件副本。

的 消費者 參數將實例標識為這些使用者之一。 實例的標識將調用管道。 您可以使用實例名稱來填充它，該實例名稱可在客戶端控制台的「監視」頁上找到。

管道服務跟蹤每個使用者檢索到的消息。 對不同實例使用不同的使用者，可確保將每個消息發送到每個實例。

管道選項建議

要配置「管線」(Pipeline)選項，您應遵循以下建議：

  • 在下添加或編輯觸發器 Triggers，則不應編輯其餘內容。
  • 確保JSON有效。 可以使用JSON驗證程式，請參閱 網站 例如。
  • "name"對應於觸發器ID。 通配符「*」將捕獲所有觸發器。
  • "Consumer"與調用實例或應用程式的名稱相對應。
  • 流水線還支援「別名」主題。
  • 在進行更改後，應始終重新啟動流水線。

第3步：可選配置

您可以根據負載要求更改一些內部參數，但是請確保在將它們投入生產之前對其進行test。

可以找到以下可選參數清單：

Option 說明
appName（舊版） 在上載公鑰的舊式宣誓應用程式中註冊的OAuth應用程式的AppID。 如需關於此項目的詳細資訊，請參閱此頁面
authGatewayEndpoint（舊版） 獲取網關令牌的URL。 預設: https://api.omniture.com
authPrivateKey（舊版） 私鑰，在Legacy Oath應用程式中上傳的公共部件，AES使用XtkKey選項進行加密： cryptString("PRIVATE_KEY")
disableAuth（舊） 禁用身份驗證，沒有網關令牌的連接將只被某些開發管道終結點接受。
discoverPipelineEndpoint 用於查找要用於此租戶的Pipeline Services終結點的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
指針FlushMessageCount 處理此數目的消息時，偏移將保存在資料庫中。
預設值為1000
指針FlushPeriodSec 在此期間後，偏移將保存在資料庫中。
預設值為5（秒）
處理JSThreads 使用自定義JS連接器處理消息的專用線程數。
預設值為4
處理線程 使用內置代碼處理消息的專用線程數。
預設值為4
retryPeriodSec 處理錯誤時重試之間的延遲。
預設值為30（秒）
retryValiditySec 如果在此時間段後未成功處理該消息（重試次數過多），請放棄該消息。
預設值為300（秒）

流水線處理自動啟動

流水線處理需要自動啟動。

為此，將配置檔案中的< pipelined >元素設定為autostart="true":

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

流水線處理重啟

要使更改生效，需要重新啟動：

nlserver restart pipelined@instance

第4步：驗證

要驗證管道設定以進行預配，請執行以下步驟：

  • 確保 pipelined 進程正在運行。
  • 檢查pipelined.log中的管道連接日誌。
  • 驗證連接是否收到ping。 托管客戶可以從客戶端控制台使用監控。

本頁內容