使用案例

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

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

要執行此使用案例,您需要執行以下操作:

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

必要條件

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

步驟1:設定API呼叫

進行API呼叫,以使用參數觸發Workflow 1。 有關API調用語法的詳細資訊,請參閱Campaign StandardREST 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​標籤以新增協調條件(在本例中為​email​欄位)。

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

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

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

    $long(vars/@recCount)>0
    

  9. 如果擷取資料,請將其儲存至觀眾。 若要這麼做,請新增​Save audience​活動至​Target not empty​轉場,然後開啟它。

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

    $(vars/@fileToTarget)
    

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

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

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

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

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​參數命名出站轉場。

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

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

    $(vars/@segmentCode)
    

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

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

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

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

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

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

執行工作流程

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

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now