v7 v8

設定管線

上次更新: 2023-07-31
  • 主題:
  • Triggers
    檢視有關此主題的更多資訊

在執行個體設定檔案中設定驗證引數,例如,客戶ID、私密金鑰和驗證端點。
要處理的觸發程式清單是在JSON格式的選項中設定。
這些觸發程式由傳送電子郵件的行銷活動工作流程用於鎖定目標。 行銷活動的設定方式是讓具有兩個觸發事件的客戶收到電子郵件。

必要條件

開始此設定前,請檢查您是否使用:

  • 最少,會建置下列其中一個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中完成觸發器設定

驗證和組態檔

由於管道託管於Adobe Experience Cloud,因此需要驗證。
它使用一對公開和私密金鑰。 此程式與使用者/密碼具有相同的功能,但較安全。
支援透過Adobe I/O專案進行Marketing Cloud的驗證。

步驟1:建立/更新Adobe I/O專案

對於託管客戶,您可以建立客戶服務票證,讓您的組織能夠為Triggers整合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 > OptionsExplorer.

  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引數

管線的運作方式與供應商和消費者模型類似。 訊息僅供個別消費者使用:每位消費者各有專屬的訊息副本。

消費者 引數會將執行個體識別為這些取用者之一。 執行個體的身分將呼叫管道。 您可以在「從屬端主控台」的「監督」頁面中,找到執行處理名稱。

管道服務會追蹤每個取用者擷取的訊息。 針對不同的執行個體使用不同的消費者,可讓您確定每個訊息都傳送至每個執行個體。

管道選項建議

若要設定管道選項,您應遵循下列建議:

  • 新增或編輯下的觸發程式 Triggers,您不應該編輯其餘的。
  • 請確定JSON有效。 您可以使用JSON驗證器,請參閱此 網站 例如。
  • "name"會對應至觸發程式ID。 萬用字元「*」將接住所有觸發器。
  • 「消費者」對應到呼叫執行個體或應用程式的名稱。
  • 管線也支援「別名」主題。
  • 進行變更後,您應該一律重新啟動管線化。

步驟3:可選設定

您可以根據負載要求變更某些內部引數,但請務必在投入生產之前先測試這些引數。

您可在下方找到選用引數清單:

Option 說明
appName(舊版) 在上傳公開金鑰的舊版Oath應用程式中註冊的OAuth應用程式的AppID。 如需關於此項目的詳細資訊,請參閱此頁面
authGatewayEndpoint(舊版) 取得閘道權杖的URL。 預設: https://api.omniture.com
authPrivateKey(Legacy) 在舊版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 (秒)
retryValiditySec 如果在此期間之後未成功處理訊息(重試次數過多),請捨棄訊息。
預設為300 (秒)

管線處理序自動啟動

管線處理需要自動啟動。

為此,請將設定檔案中的<pipelined >元素設定為autostart="true":

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

管線處理序重新啟動

必須重新啟動變更才會生效:

nlserver restart pipelined@instance

步驟4:驗證

要驗證用於布建的管道設定,請執行以下步驟:

  • 確定 pipelined 處理序正在執行。
  • 檢查pipelined.log以取得管道連線記錄。
  • 驗證連線以及是否收到Ping。 託管客戶可使用使用者端主控台中的監視。

本頁內容