利用 API 觸發行銷活動 trigger-campaigns
關於API觸發的行銷活動 about
透過Journey Optimizer，您可以使用互動式訊息執行REST API，根據使用者觸發從外部系統建立行銷活動，然後叫用它們。 這可讓您涵蓋各種行銷和異動訊息需求，例如密碼重設、OTP權杖等。
若要這麼做，您首先需要在Journey Optimizer中建立API觸發的行銷活動，然後透過API呼叫啟動其執行。
API觸發的行銷活動的可用管道包括電子郵件、簡訊和推播訊息。
➡️ 在影片中探索此功能
建立API觸發的行銷活動 create
設定並啟用行銷活動 create-activate
若要建立API觸發的行銷活動，請遵循下列步驟。 有關如何建立行銷活動的詳細資訊，請參閱本節。
-
使用 API觸發的 型別建立新的行銷活動。
-
根據您要傳送的通訊型別，選擇 行銷 或 異動 類別。
-
選擇其中一個支援的頻道和相關聯的頻道介面來傳送您的訊息，然後按一下[建立]。
-
指定行銷活動的標題和說明，然後按一下 編輯內容 來設定要傳送的訊息。
note note NOTE 您可以將其他資料傳遞至API裝載，以便用於個人化您的訊息。 了解更多 在內容中使用大量或繁重的內容相關資料可能會影響效能。 -
在 對象 區段中，指定要用來識別個人的名稱空間。
-
如果您正在建立 交易 型別的行銷活動，則需要在API呼叫中定義目標設定檔。 建立新設定檔 選項可讓您自動建立資料庫中不存在的設定檔。 進一步瞭解行銷活動執行時的設定檔建立作業
note note NOTE 單一API呼叫支援最多20個不重複收件者。 每個收件者必須具有唯一的使用者ID，不允許重複的使用者ID。 進一步瞭解互動式訊息執行API檔案 -
針對 行銷 型別的行銷活動，按一下 對象 按鈕以選擇要鎖定的對象。
-
-
設定行銷活動的開始和結束日期。
如果您設定行銷活動的特定開始和/或結束日期，則不會在這些日期以外執行，而如果行銷活動由API觸發，API呼叫將會失敗。
-
按一下 檢閱以啟用，檢查您的行銷活動是否已正確設定，然後啟用。
您現在已準備好從API執行行銷活動。 了解更多
執行行銷活動 execute
啟動行銷活動後，您需要擷取產生的範例cURL請求，並將其用於API中以建置您的裝載並觸發行銷活動。
-
開啟行銷活動，然後從 cURL請求 區段複製並貼上裝載請求。 此裝載包含訊息中使用的所有個人化（設定檔和內容）變數。 行銷活動上線後，即可使用此功能。
-
將此cURL請求用於API以建置您的裝載並觸發行銷活動。 如需詳細資訊，請參閱互動式訊息執行API檔案。
此頁面中也提供API呼叫範例。
note note NOTE 如果您在建立行銷活動時已設定特定的開始和/或結束日期，則不會在這些日期以外執行，並且API呼叫將會失敗。
在API觸發的行銷活動中使用內容屬性 contextual
透過API觸發的行銷活動，您可以在API裝載中傳遞其他資料，並在行銷活動中使用這些資料，以個人化您的訊息。
讓我們舉個例子，客戶想要重設密碼，而您想要傳送第三方工具產生的密碼重設URL。 透過API觸發的行銷活動，您可以將此產生的URL傳遞至API裝載，並運用至行銷活動以將其新增至訊息。
為了在您的行銷活動中使用這些資料，您需要將這些資料傳遞至API裝載，並使用個人化編輯器將其新增至您的訊息中。 若要這麼做，請使用{{context.<contextualAttribute>}}語法，其中<contextualAttribute>應符合包含您要傳遞之資料的API裝載中的變數名稱。
{{context.<contextualAttribute>}}語法只對應到String資料型別。
context.system語法限製為僅限Adobe內部使用，且不應用來傳遞內容屬性。請注意，目前左側邊欄功能表中沒有可用的內容屬性。 屬性必須直接在個人化運算式中輸入，Journey Optimizer不會執行任何檢查。
在行銷活動執行時建立設定檔 profile-creation
在某些情況下，您可能需要將交易式訊息傳送至系統中不存在的設定檔。 例如，如果未知的使用者嘗試重設您網站上的密碼。
當資料庫中不存在設定檔時，Journey Optimizer可讓您在執行行銷活動時自動建立該設定檔，以允許傳送訊息至此設定檔。
若要在行銷活動執行時啟用設定檔建立，請在 對象 區段中將 建立新設定檔 選項切換為開啟。 如果停用此選項，則會拒絕任何傳送的未知設定檔，且API呼叫將失敗。
操作說明影片 video
瞭解如何使用互動式訊息執行REST API，根據使用者互動從外部系統建立及觸發行銷活動。