以下使用案例顯示如何使用工作流程中的引數呼叫工作流程。
目標是使用外部引數從API呼叫觸發工作流程。 此工作流程會將資料從檔案載入您的資料庫,並建立關聯的對象。 建立對象後,系統會觸發第二個工作流程,使用API呼叫中定義的外部引數傳送個人化訊息。
若要執行此使用案例,您必須執行下列動作:
設定工作流程之前,您需要使用建立工作流程1和2 External signal 活動。 如此一來,您就可以在呼叫工作流程時鎖定這些訊號活動。
進行API呼叫以使用引數觸發工作流程1。 如需API呼叫語法的詳細資訊,請參閱 Campaign StandardREST API檔案.
在本例中,我們想使用下列引數呼叫工作流程:
-X POST https://mc.adobe.io/<ORGANIZATION>/campaign/<TRIGGER_URL>
-H 'Authorization: Bearer <ACCESS_TOKEN>'
-H 'Cache-Control: no-cache'
-H 'X-Api-Key: <API_KEY>'
-H 'Content-Type: application/json;charset=utf-8'
-H 'Content-Length:79'
-i
-d {
-d "source:":"API",
-d "parameters":{
-d "fileToTarget":"profile.txt",
-d "discountDesc":"Running shoes"
-d }
工作流程1將建置如下:
請依照下列步驟設定工作流程:
宣告API呼叫中已定義的引數。 若要這麼做,請開啟 External signal 活動,然後新增引數的名稱和型別。
新增 Transfer file 將資料匯入資料庫的活動。若要執行此動作,請拖放活動,開啟活動,然後選取 Protocol 標籤。
選取 Use a dynamic file path 選項,然後使用 fileToTarget 要傳輸的檔案引數:
$(vars/@fileToTarget)
將資料從檔案載入資料庫。
若要這麼做,請拖放 Load file 活動進入工作流程,然後視需要進行設定。
使用匯入檔案的資料插入並更新資料庫。
若要這麼做,請拖放 Update data 活動,然後選取 Identification 索引標籤以新增調解條件(在此案例中, 電子郵件 欄位)。
選取 Fields to update 標籤,然後指定要在資料庫中更新的欄位(在我們的案例中, firstname 和 電子郵件 欄位)。
檢查是否從檔案擷取資料。 若要這麼做,請拖放 Test 活動進入工作流程,然後按一下 Add an element 按鈕以新增條件。
命名並定義條件。 在本例中,我們要測試出站轉變是否包含使用下列語法的資料:
$long(vars/@recCount)>0
如果擷取資料,則將其儲存到對象中。 若要這麼做,請新增 Save audience 活動至 目標不是空的 轉變,然後開啟它。
選取 Use a dynamic label 選項,然後使用 fileToTarget 做為對象標籤的引數:
$(vars/@fileToTarget)
拖放 End 使用引數呼叫工作流程2的活動,然後開啟它。
選取 External signal 標籤,然後指定要觸發的工作流程及其關聯的訊號活動。
定義您要在「工作流程2」中使用的引數及其相關值。
在本例中,我們想要傳遞原本在API呼叫(fileToTarget 和 discountdesc),以及其他 segmentCode 具有常數值的引數(「20%折扣」)。
工作流程1已設定,您現在可以建置工作流程2。 如需詳細資訊,請參閱本章節。
工作流程2將建置如下:
請依照下列步驟設定工作流程:
宣告已在工作流程1中定義的引數。
若要這麼做,請開啟 External signal 活動,然後新增中定義之每個引數的名稱和型別 End 工作流程1的活動。
使用工作流程1中儲存的對象。 若要這麼做,請拖放 Read audience 活動進入工作流程,然後開啟它。
選取 Use a dynamic audience 選項,然後使用 fileToTarget 引數當作要讀取的對象名稱:
$(vars/@fileToTarget)
根據為出站轉變命名 segmentCode 引數。
若要這麼做,請選取 Transition 標籤,然後 Use a dynamic segment code 選項。
使用 segmentCode 引數作為出站轉變的名稱:
$(vars/@segmentCode)
拖放 Email delivery 活動以傳送訊息給對象。
識別訊息中要使用的引數,以透過對其進行個人化 discountdesc 引數。 若要這麼做,請開啟活動的進階選項,然後新增引數名稱和值。
您現在可以設定訊息。 開啟活動,然後選取「 」 Recurring email.
選取要使用的範本,然後視需要定義電子郵件屬性。
使用 discountdesc 引數作為個人化欄位。 若要這麼做,請從個人化欄位清單中選取它。
您現在可以完成訊息設定,然後照常傳送。
一旦建立工作流程後,您就可以執行它們。 執行API呼叫之前,請確定兩個工作流程已開始。