使用實例 use-case

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

中繼
開發人員

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

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

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

進行API呼叫 以使用外部引數觸發工作流程1。請參閱步驟1：設定API呼叫。
建置工作流程1：工作流程將傳輸檔案並將其載入資料庫。然後它會測試資料是否空白，最終將設定檔儲存至受眾。最後，它會觸發工作流程2。請參閱步驟2：設定工作流程1。
建置工作流程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。

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

宣告API呼叫中已定義的引數。若要這麼做，請開啟 External signal 活動，然後新增引數的名稱和型別。
新增 Transfer file 活動以將資料匯入資料庫。若要這麼做，請拖放活動、開啟活動，然後選取 Protocol 索引標籤。

選取 Use a dynamic file path 選項，然後使用 fileToTarget 引數作為要傳輸的檔案：

code language-none
`$(vars/@fileToTarget)`

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

若要這麼做，請將 Load file 活動拖放至工作流程中，然後根據您的需求進行設定。
使用匯入檔案的資料插入並更新資料庫。

若要這麼做，請拖放 Update data 活動，然後選取 Identification 索引標籤以新增調解條件（在此案例中為 電子郵件 欄位）。
選取 Fields to update 標籤，然後指定要更新資料庫中的欄位（在我們的案例中為 firstname 和 email 欄位）。
檢查是否從檔案擷取資料。若要這麼做，請將 Test 活動拖放至工作流程中，然後按一下 Add an element 按鈕以新增條件。

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

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

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

選取 Use a dynamic label 選項，然後使用 fileToTarget 引數做為對象的標籤：

code language-none
`$(vars/@fileToTarget)`

拖放將使用引數呼叫工作流程2的 End 活動，然後開啟它。
選取 External signal 標籤，然後指定要觸發的工作流程及其相關訊號活動。
定義您要在「工作流程2」中使用的引數及其相關值。

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

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

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

工作流程2將建置如下：

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

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

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

若要這麼做，請開啟 External signal 活動，然後新增Workflow 1的 End 活動中定義的每個引數的名稱和型別。
使用工作流程1中儲存的對象。若要這麼做，請將 Read audience 活動拖放到工作流程中，然後開啟它。