使用案例

以下使用案例說明如何使用工作流程中的參數呼叫工作流程。

目標是從含有外部參數的API呼叫觸發工作流程。 此工作流程會從檔案將資料載入至您的資料庫,並建立相關的對象。 建立對象後,將觸發第二個工作流程,以傳送以API呼叫中定義之外部參數個人化的訊息。

若要執行此使用案例,您必須執行下列動作:

  1. 發出API呼叫 以使用外部參數觸發工作流程1。請參閱步驟1:設定API呼叫
  2. 建置工作流程1:工作流程會傳輸檔案並將其載入資料庫。接著會測試資料是否空白,並最終將設定檔儲存至對象。 最後,它會觸發工作流程2。 請參閱步驟2:設定工作流程1
  3. 建置工作流程2:工作流程將讀取在工作流程1中建立的對象,然後傳送個人化訊息至設定檔,並使用參數自訂的區段代碼。請參閱步驟3:設定工作流程2

先決條件

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

步驟1:設定API呼叫

進行API呼叫以使用參數觸發工作流程1。 如需API呼叫語法的詳細資訊,請參閱Campaign StandardREST API檔案

在我們的案例中,我們想使用下列參數呼叫工作流程:

  • fileToTarget:要導入資料庫的檔案的名稱。
  • discountDesc:要顯示在折扣傳送中的說明。
-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 活動:使用您要在其中使用的參數呼叫工作流程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​標籤以新增調解標準(在此例中是​email​欄位)。

  6. 選取​Fields to update​標籤,然後指定要在資料庫中更新的欄位(在此例中是​firstname​和​email​欄位)。

  7. 檢查是否從檔案中擷取資料。 若要這麼做,請將​Test​活動拖放至工作流程中,然後按一下​Add an element​按鈕以新增條件。

  8. 命名並定義條件。 在本例中,我們要測試出站轉變是否包含具有下列語法的資料:

    $long(vars/@recCount)>0
    

  9. 如果擷取資料,則將其儲存至對象中。 若要這麼做,請將​Save audience​活動新增至​非空的​轉變,然後開啟它。

  10. 選取​Use a dynamic label​選項,然後使用​fileToTarget​參數作為對象的標籤:

    $(vars/@fileToTarget)
    

  11. 拖放將使用參數呼叫Workflow 2的​End​活動,然後開啟它。

  12. 選取​External signal​標籤,然後指定要觸發的工作流程及其相關訊號活動。

  13. 定義您要在工作流程2中使用的參數及其關聯值。

    在本例中,我們想傳遞API呼叫(fileToTarget​和​discountDesc)中最初定義的參數,以及具有常數值("20% discount")的額外​segmentCode​參數。

工作流程1已設定,您現在可以建置工作流程2。 如需詳細資訊,請參閱本章節

步驟3:配置工作流2

工作流程2的建置方式如下:

  • External signal 活動:其中,必須聲明參數,才能在工作流程中使用。
  • Read audience 活動:讀取儲存在工作流程1中的對象。
  • Email delivery 活動:傳送循環訊息給目標對象,並使用參數個人化。

請依照下列步驟來設定工作流程:

  1. 聲明已在工作流1中定義的參數。

    要執行此操作,請開啟​External signal​活動,然後新增在工作流1的​End​活動中定義之每個參數的名稱和類型。

  2. 使用已儲存在工作流程1中的對象。 若要這麼做,請將​Read audience​活動拖放至工作流程中,然後開啟它。

  3. 選取​Use a dynamic audience​選項,然後使用​fileToTarget​參數作為要讀取的對象名稱:

    $(vars/@fileToTarget)
    

  4. 根據​segmentCode​參數為出站轉變命名。

    要執行此操作,請選擇​Transition​頁簽,然後選擇​Use a dynamic segment code​選項。

  5. 使用​segmentCode​參數作為出站轉變的名稱:

    $(vars/@segmentCode)
    

  6. 拖放​Email delivery​活動以傳送訊息給對象。

  7. 識別訊息中要使用的參數,以使用​discountDesc​參數進行個人化。 若要這麼做,請開啟活動的進階選項,然後新增參數名稱和值。

  8. 您現在可以設定訊息。 開啟活動,然後選取​Recurring email

  9. 選取要使用的範本,然後根據您的需求定義電子郵件屬性。

  10. 使用​discountDesc​參數作為個人化欄位。 若要這麼做,請從個人化欄位清單中選取它。

  11. 您現在可以完成訊息的設定,然後照常傳送。

執行工作流程

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

本頁內容