驗證參數(如客戶ID、私密金鑰和驗證端點)是在實例配置檔案中配置的。
要處理的觸發器清單會以JSON格式的選項設定。
觸發程式可用於透過傳送電子郵件的促銷活動工作流程進行定位。 促銷活動已設定,讓同時具有觸發事件的客戶收到電子郵件。
如果是混合部署,請確定管道是在中間實例上配置的。
在開始此配置之前,請檢查您使用的是:
您還需要:
驗證是必要的,因為管道是由Adobe Experience Cloud代管。
它使用一對公鑰和私鑰。 此程式與用戶/密碼功能相同,但更安全。
透過Adobe I/O專案的Marketing Cloud支援驗證。
對於代管客戶,您可以建立客戶服務票證,以便透過Adobe I/O技術帳戶Token為觸發器整合啟用您的組織。
若為On Premise客戶,請參閱為Adobe Experience Cloud觸發器設定Adobe I/O頁面。 請注意,在將API新增至Adobe I/O憑證時,您必須選取Adobe Analytics。
一旦設定了驗證,管線將檢索事件。 它只會處理在Adobe Campaign中設定的觸發程式。 觸發器必須是從Adobe Analytics產生,並推送至管線,而管線僅會處理在Adobe Campaign中設定的觸發器。
也可以使用通配符配置該選項,以便捕獲所有觸發器(無論其名稱如何)。
在Adobe Campaign中,存取Explorer中Administration > Platform > Options下的選項功能表。
選擇NmsPipeline_Config選項。
在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.
},
]
}
]
}
您也可以選擇貼上下列會擷取所有觸發器的JSON程式碼。
{
"topics": [
{
"name": "triggers",
"consumer": "customer_dev",
"triggers": [
{
"name": "*",
"jsConnector": "cus:pipeline.js"
}
]
}
]
}
管道的運作方式類似於供應商和消費者模型。 消息僅用於單個消費者:每個消費者都會收到自己的訊息。
Consumer參數將實例標識為其中一個使用者。 實例的標識將調用pipeline。 您可以用實例名稱來填充它,該名稱可在「客戶端控制台」的「監視」頁上找到。
流水線服務跟蹤每個消費者檢索的消息。 針對不同的例項使用不同的使用者,可讓您確定每個訊息都會傳送至每個例項。
若要設定「管線」選項,您應遵循下列建議:
您可以根據負載需求變更某些內部參數,但請務必先加以測試,再投入生產。
可在以下找到可選參數清單:
選項 | 說明 |
---|---|
appName(舊版) | 已在上傳公開金鑰的舊版誓言應用程式中註冊的OAuth應用程式的AppID。 如需詳細資訊,請參閱此頁面 |
authGatewayEndpoint(舊版) | 取得閘道Token的URL。 預設值:https://api.omniture.com |
authPrivateKey(舊版) | 私密金鑰、Legacy Fond應用程式中上傳的公用部分、使用XtkKey選項加密的AES:cryptString("PRIVATE_KEY") |
disableAuth(舊版) | 停用驗證時,若未使用閘道Token進行連線,只有某些開發管道端點才會接受。 |
discoverPipelineEndpoint | URL,以尋找要用於此租用戶的Pipeline Services端點。 預設值: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(秒) |
retryValiditySec | 如果消息在此時段後未成功處理(重試次數過多),請捨棄該消息。 預設值為300(秒) |
需要自動啟動流水線處理。
為此,請將配置檔案中的< pipelineed >元素設定為autostart="true":
<pipelined autoStart="true" ... "/>
要使更改生效,需要重新啟動:
nlserver restart pipelined@instance
要驗證為置備設定的管線,請執行以下步驟: