以下使用案例說明如何使用工作流程中的參數來呼叫工作流程。
其目的在於使用外部參數從API呼叫觸發工作流程。 此工作流程會從檔案將資料載入您的資料庫,並建立相關對象。 在建立對象後,會觸發第二個工作流程,以傳送個人化訊息,並使用API呼叫中定義的外部參數。
要執行此使用案例,您需要執行以下操作:
在設定工作流程之前,您必須先建立Workflow 1和Workflow 2,其中每個工作流程都包含External signal活動。 如此,您就可以在呼叫工作流程時鎖定這些訊號活動。
進行API呼叫,以使用參數觸發Workflow 1。 如需API呼叫語法的詳細資訊,請參閱 Campaign Standard REST APIs檔案。
在本例中,我們要使用下列參數來呼叫工作流程:
-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標籤以新增協調條件(在本例中為email欄位)。
選擇Fields to update標籤,然後指定要在資料庫中更新的欄位(在本例中為firstname和email欄位)。
檢查是否從檔案檢索到資料。 若要這麼做,請將Test活動拖放至工作流程中,然後按一下Add an element按鈕以新增條件。
命名並定義條件。 在本例中,我們要測試出站轉場是否包含下列語法的資料:
$long(vars/@recCount)>0
如果擷取資料,請將其儲存至觀眾。 若要這麼做,請新增Save audience活動至Target not empty轉場,然後開啟它。
選取Use a dynamic label選項,然後使用fileToTarget參數作為對象的標籤:
$(vars/@fileToTarget)
拖放End活動,該活動將使用參數呼叫Workflow 2,然後將其開啟。
選擇External signal標籤,然後指定要觸發的工作流程及其關聯的信號活動。
定義您要在Workflow 2中使用的參數及其關聯值。
在本例中,我們要傳遞API呼叫中最初定義的參數(fileToTarget和discountDesc),以及具有常數值(「20%折扣」)的額外segmentCode參數。
Workflow 1已設定,您現在可以建立Workflow 2。 如需詳細資訊,請參閱本章節。
工作流程2的建立方式如下:
請依照下列步驟來設定工作流程:
聲明已在Workflow 1中定義的參數。
要執行此操作,請開啟External signal活動,然後添加在Workflow 1的End活動中定義的每個參數的名稱和類型。
使用已儲存在Workflow 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呼叫前,請確定已啟動兩個工作流程。