配置自訂實施事件

此設定的部分是自訂開發，需要下列項目：

• Adobe Campaign中JSON、XML和Javascript剖析的實用知識。
• QueryDef和Writer API的使用知識。
• 使用私密金鑰進行加密和驗證的實用概念。

由於編輯Javascript程式碼需要技術技能，因此若未適當了解，請勿嘗試。

處理JavaScript中的事件

JavaScript檔案

管道使用JavaScript函式來處理每則訊息。 此函式由使用者定義。

它配置在「JSConnector」屬性下的​NmsPipeline_Config​選項中。 每次收到事件時都會呼叫此javascript。 由pipelined進程運行。

範例Javascript檔案為cus:triggers.js。

JavaScript函式

pipelined Javascript必須以特定函式開頭。

每個事件會呼叫此函式一次：

function processPipelineMessage(xmlTrigger) {}

它應傳回為

<undefined/>

編輯Javascript後，應該重新啟動pipelined。

觸發資料格式

trigger資料會以XML格式傳遞至JS函式。

• @triggerId​屬性包含trigger的名稱。
• JSON格式的​擴充​元素包含Adobe Analytics產生的資料，並附加至觸發器。
• @offset 是訊息的「指標」。它會指出佇列中的訊息順序。
• @partition 是佇列中訊息的容器。偏移相對於分區。
  隊列中約有15個分區。

範例:

<trigger offset="1500435" partition="4" triggerId="LogoUpload_1_Visits_from_specific_Channel_or_ppp">
 <enrichments>{"analyticsHitSummary":{"dimensions":{" eVar01":{"type":"string","data":["PI4INE1ETDF6UK35GO13X7HO2ITLJHVH"],"name":" eVar01","source":"session summary"}, "timeGMT":{"type":"int","data":[1469164186,1469164195],"name":"timeGMT","source":"session summary"}},"products":{}}}</enrichments>
 <aliases/>
 </trigger>

資料格式擴充

每個觸發器的內容都會在Adobe Analytics中以JSON格式定義。
例如，在觸發器LogoUpload_uploading_Visits中：

• eVar01 可包含字串格式的購物者ID，用於調解Adobe Campaign收件者。
  必須調解以尋找主要金鑰購物者ID。

• timeGMT 可以包含Adobe Analytics端觸發時間（UTC Epoc格式）(自01/01/1970 UTC起的秒數)。

範例:

{
 "analyticsHitSummary": {
 "dimensions": {
 "eVar01": {
 "type": "string",
 "data": ["PI4INE1ETDF6UK35GO13X7HO2ITLJHVH"],
 "name": " eVar01",
 "source": "session summary"
 },
 "timeGMT": {
 "type": "int",
 "data": [1469164186, 1469164195],
 "name": "timeGMT",
 "source": "session summary"
 }
 },
 "products": {}
 }
 }

事件處理順序

事件會依位移順序一次處理一次。 pipelined的每個線程處理不同的分區。

上次擷取的事件的「位移」會儲存在資料庫中。 因此，如果進程停止，則從最後一條消息重新啟動。 此資料會儲存在內建結構xtk:pipelineOffset中。

此指標專供每個例項和每個消費者使用。 因此，當許多執行個體以不同的使用者存取相同的管道時，會以相同的順序取得所有訊息。

管道選項的​consumer​參數可識別呼叫執行個體。

目前，無法為「測試」或「開發」等不同環境設定不同的佇列。

記錄和錯誤處理

日誌(如logInfo())被導向到pipelined日誌。 將logError()等錯誤寫入pipelined日誌中，並導致將事件放入重試隊列。 在這種情況下，您應檢查管道記錄。
在pipelined選項中設定的持續時間內，錯誤消息會重試多次。

為了偵錯和監控目的，完整的觸發程式資料會以XML格式寫入「資料」欄位的觸發程式表格中。 或者，包含觸發程式資料的logInfo()也有相同的用途。

正在解析資料

此範例Javascript程式碼會剖析擴充功能中的eVar01。

function processPipelineMessage(xmlTrigger)
 {
 (…)
 var shopper_id = ""
 if (xmlTrigger.enrichments.length() > 0)
 {
 if (xmlTrigger.enrichments.toString().match(/eVar01/) != undefined)
 {
 var enrichments = JSON.parse(xmlTrigger.enrichments.toString())
 shopper_id = enrichments.analyticsHitSummary.dimensions. eVar01.data[0]
 }
 }
 (…)
 }

剖析時請務必小心，以避免錯誤。
由於此程式碼用於所有觸發器，因此不需要大部分資料。 因此，若不存在，則可保留空白。

儲存觸發器

此範例JS程式碼會將觸發程式儲存至資料庫。

function processPipelineMessage(xmlTrigger)
 {
 (…)
 var event = 
 <pipelineEvent
 xtkschema = "cus:pipelineEvent"
 _operation = "insert"
 created = {timeNow}
 lastModified = {timeNow}
 triggerType = {triggerType}
 timeGMT = {timeGMT}
 shopper_id = {shopper_id}
 data = {xmlTrigger.toXMLString()}
 />
 xtk.session.Write(event)
 return <undef/>;
 }

限制

此程式碼的效能必須最佳，因為它會以高頻率執行，而且可能會對其他行銷活動造成潛在負面影響。 尤其是如果在行銷伺服器上每小時處理超過100萬個觸發事件，或未正確調整時。

此Javascript的內容有限。 並非所有API功能皆可使用。 例如，getOption()或getCurrentdate()無法運作。

為了加快處理速度，此指令碼的多個執行緒會同時執行。 程式碼必須是執行緒安全狀態。

儲存事件

管道事件架構

事件儲存在資料庫表中。 行銷活動使用它來鎖定客戶，並使用觸發器讓電子郵件更豐富。
雖然每個觸發器可以有不同的資料結構，但所有觸發器都可放在單一表格中。
triggerType欄位標識資料的觸發源。

下表為此表格的范常式式碼：

顯示事件

事件可根據事件結構以簡單的形式顯示。

處理事件

調解工作流

調解是將客戶從Adobe Analytics比對至Adobe Campaign資料庫的程式。 例如，比對的條件可以是shopper_id。

基於效能原因，必須使用工作流在批處理模式下完成匹配。
頻率必須設定為15分鐘才能優化工作負載。 因此，Adobe Campaign中的事件接收與行銷工作流程處理之間的延遲最多為15分鐘。

JavaScript中的單元協調選項

可以在JavaScript中為每個觸發器執行調解查詢。 它對效能的影響更大，而且效果更快。 當需要再活動時，可能需要它。

如果未在shopper_id上設定索引，則實施可能會很困難。 如果條件位於與市場營銷伺服器不同的單獨的資料庫伺服器上，則它使用資料庫連結，這會導致效能不佳。

清除工作流

觸發器會在一小時內處理。 音量可以是每小時100萬個觸發器。 它說明了清除工作流程必須到位的原因。 清除每天執行一次，並刪除超過三天的所有觸發器。

促銷活動工作流程

觸發促銷活動工作流程通常類似於已使用的其他循環促銷活動。
例如，它可以從觸發器上的查詢開始，在最後一天尋找特定事件。 該目標用於傳送電子郵件。 擴充功能或資料可能來自觸發器。 行銷可安全地使用，因為不需要設定。