Show Menu
主題×

使用案例

以下使用案例說明如何使用工作流程中的參數來呼叫工作流程。
其目的在於使用外部參數從API呼叫觸發工作流程。 此工作流程會從檔案將資料載入您的資料庫,並建立相關對象。 在建立對象後,會觸發第二個工作流程,以傳送個人化訊息,並使用API呼叫中定義的外部參數。
要執行此使用案例,您需要執行以下操作:
  1. 進行API呼叫 ,以使用外部參數觸發Workflow 1。 請參 閱步驟1:設定API呼叫
  2. 建立工作流程1 :工作流將傳輸檔案並將其載入到資料庫中。 然後,它會測試資料是否空白,並最終將描述檔儲存至觀眾。 最後,它將觸發Workflow 2。 請參 閱步驟2:設定工作流程1 .
  3. 建立工作流程2 :工作流程會讀取在Workflow 1中建立的觀眾,然後傳送個人化訊息至描述檔,並使用參數自訂區段代碼。 請參 閱步驟3:設定工作流程2 .

必要條件

在設定工作流程之前,您必須先建立「工作流程1」和「工作流程2」,其 External signal 中每個工作流程都包含活動。 如此,您就可以在呼叫工作流程時鎖定這些訊號活動。

步驟1:設定API呼叫

進行API呼叫,以使用參數觸發Workflow 1。 如需API呼叫語法的詳細資訊,請參閱 Campaign Standard REST API檔案
在本例中,我們要使用下列參數來呼叫工作流程:
  • fileToTarget :要導入到資料庫的檔案的名稱。
  • 折扣設計 :要在交貨中顯示的折扣說明。
-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 } 

步驟2:設定工作流程1

工作流程1的建立方式如下:
  • External signal 活動:其中,必須聲明外部參數才能在工作流中使用。
  • Transfer file 活動:導入具有參數中定義的名稱的檔案。
  • Load file 活動:從導入的檔案將資料載入到資料庫中。
  • Update data 活動:使用導入檔案中的資料插入或更新資料庫。
  • Test 活動:檢查是否有匯入的資料。
  • Save audience 活動:如果檔案包含資料,請將描述檔儲存至觀眾。
  • End activity 活動:呼叫Workflow 2,其中包含您要使用的參數。
請依照下列步驟來設定工作流程:
  1. 宣告已在API呼叫中定義的參數。 若要這麼做,請開啟 External signal 活動,然後新增參數的名稱和類型。
  2. 新增活 Transfer file 動以將資料匯入資料庫。若要這麼做,請拖放活動,將其開啟,然後選取標 Protocol 簽。
  3. 選取 Use a dynamic file path 選項,然後使 ​用fileToTarget參數作為要傳輸的檔案:
    $(vars/@fileToTarget)
    
    
  4. 將資料從檔案載入到資料庫中。
    若要這麼做,請將活動拖放 Load file 至工作流程中,然後根據您的需求進行設定。
  5. 使用導入檔案中的資料插入和更新資料庫。
    若要這麼做,請拖放活 Update data 動,然後選取標 Identification 簽以新增協調條件(在我們的例子中為電子郵件 欄位 )。
  6. 選取標 Fields to update 簽,然後指定要在資料庫中更新的欄位(在我們的例子中是名 和電 子郵件欄位 )。
  7. 檢查是否從檔案檢索到資料。 若要這麼做,請將活動拖放 Test 至工作流程中,然後按一下按 Add an element 鈕以新增條件。
  8. 命名並定義條件。 在本例中,我們要測試出站轉場是否包含下列語法的資料:
    $long(vars/@recCount)>0
    
    
  9. 如果擷取資料,請將其儲存至觀眾。 若要這麼做,請新增活 Save audience 動至 Target而非空白轉場 ,然後開啟它。
  10. 選取 Use a dynamic label 選項,然後使 ​用fileToTarget參數作為對象的標籤:
    $(vars/@fileToTarget)
    
    
  11. 拖放會以參 End 數呼叫Workflow 2的活動,然後開啟它。
  12. 選取標 External signal 簽,然後指定要觸發的工作流程及其相關的信號活動。
  13. 定義您要在Workflow 2中使用的參數及其關聯值。
    在我們的情況下,我們會傳遞API呼叫( fileToTarget and discountDesc )中最初定義的參數,以及具有固定值的額 外segmentCode 參數(「20%折扣」)。
Workflow 1已設定,您現在可以建立Workflow 2。 如需詳細資訊,請參閱 本章節

步驟3:設定工作流程2

工作流程2的建立方式如下:
  • External signal 活動:其中,必須聲明參數才能在工作流中使用。
  • Read audience 活動:讀取在Workflow 1中儲存的對象。
  • Email delivery 活動:傳送循環訊息給目標對象,並使用參數個人化。
請依照下列步驟來設定工作流程:
  1. 聲明已在Workflow 1中定義的參數。
    若要這麼做,請開啟 External signal 活動,然後新增在Workflow 1活動中定義之每個參數 End 的名稱和類型。
  2. 使用已儲存在Workflow 1中的對象。 若要這麼做,請將活動拖放 Read audience 至工作流程中,然後開啟它。
  3. 選取 Use a dynamic audience 選項,然後使 ​用fileToTarget參數作為要讀取的對象名稱:
    $(vars/@fileToTarget)
    
    
  4. 根據segmentCode參數命名出站 轉場
    To do this, select the Transition tab, then the Use a dynamic segment code option.
  5. 使用 segmentCode 參數作為傳出轉換的名稱:
    $(vars/@segmentCode)
    
    
  6. 拖放活動 Email delivery 以傳送訊息給觀眾。
  7. 識別訊息中要使用的參數,以便使用discountDesc參 數個人化 。 若要這麼做,請開啟活動的進階選項,然後新增參數名稱和值。
  8. 您現在可以設定訊息。 開啟活動,然後選取 Recurring email
  9. 選取要使用的範本,然後根據您的需求定義電子郵件屬性。
  10. 使用 discountDesc 參數做為個人化欄位。 若要這麼做,請從個人化欄位清單中選取它。
  11. 您現在可以完成訊息的設定,然後照常傳送。

執行工作流程

建立工作流程後,您就可以執行這些工作流程。 在執行API呼叫前,請確定已啟動兩個工作流程。