使用實例 use-case

以下使用案例顯示如何使用工作流程中的引數呼叫工作流程。

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

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

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

先決條件 prerequisites

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

步驟1:設定API呼叫 step-1--configuring-the-api-call

進行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 step-2--configuring-workflow-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 ​引數作為要傳輸的檔案:

    code language-none
    $(vars/@fileToTarget)
    

  4. 將資料從檔案載入資料庫。

    若要這麼做,請將​ Load file ​活動拖放至工作流程中,然後根據您的需求進行設定。

  5. 使用匯入檔案的資料插入並更新資料庫。

    若要這麼做,請拖放​ Update data ​活動,然後選取​ Identification ​索引標籤以新增調解條件(在此案例中為​ 電子郵件 ​欄位)。

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

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

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

    code language-none
    $long(vars/@recCount)>0
    

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

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

    code language-none
    $(vars/@fileToTarget)
    

  11. 拖放將使用引數呼叫工作流程2的​ End ​活動,然後開啟它。

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

  13. 定義您要在「工作流程2」中使用的引數及其相關值。

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

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

步驟3:設定工作流程2 step-3--configuring-workflow-2

工作流程2將建置如下:

  • External signal ​活動:必須宣告引數才能在工作流程中使用。
  • Read audience ​活動:讀取儲存在工作流程1中的對象。
  • Email delivery ​活動:傳送週期性訊息給目標對象,使用引數個人化。

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

  1. 宣告已在工作流程1中定義的引數。

    若要這麼做,請開啟​ External signal ​活動,然後新增Workflow 1的​ End ​活動中定義的每個引數的名稱和型別。

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

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

    code language-none
    $(vars/@fileToTarget)
    

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

    若要這麼做,請選取​ Transition ​索引標籤,然後選取​ Use a dynamic segment code ​選項。

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

    code language-none
    $(vars/@segmentCode)
    

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

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

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

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

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

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

執行工作流程 executing-the-workflows

一旦建立工作流程後,您就可以執行它們。 執行API呼叫之前,請確定兩個工作流程已開始。

recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff