文件 Journey Optimizer Journey Optimizer 指南

利用 API 觸發行銷活動 trigger-campaigns

Last update: Wed Jun 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

undefined
undefined

關於API觸發的行銷活動 about

替換為 Journey Optimizer，您可以建立行銷活動，然後使用根據使用者觸發條件從外部系統叫用它們互動式訊息執行REST API. 這可讓您涵蓋各種行銷和異動訊息需求，例如密碼重設、OTP權杖等。

若要這麼做，您首先需要在Journey Optimizer中建立API觸發的行銷活動，然後透過API呼叫啟動其執行。

API觸發的行銷活動的可用管道包括電子郵件、簡訊和推播訊息。

NOTE

截至目前，推播通知API觸發的行銷活動不支援快速傳送模式。

➡️ 在影片中探索此功能

建立API觸發的行銷活動 create

設定並啟用行銷活動 create-activate

若要建立API觸發的行銷活動，請遵循下列步驟。有關如何建立行銷活動的詳細資訊，請參閱本節.

使用建立新的行銷活動 API觸發 型別。
選擇行銷或異動類別取決於您要傳送的通訊型別。
選擇其中一個支援的頻道和相關聯的頻道介面，以用於傳送您的訊息，然後按一下建立.

指定行銷活動的標題和說明，然後按一下 編輯內容 以設定要傳送的訊息。

note note
NOTE
您可以將其他資料傳遞至API裝載，以便用於個人化您的訊息。了解更多
在內容中使用大量或繁重的內容相關資料可能會影響效能。

在對象區段，指定用於識別個人的名稱空間。

如果您要建立異動-type campaign，必須在API呼叫中定義目標設定檔。此 建立新設定檔 選項可讓您自動建立資料庫中不存在的設定檔。瞭解有關在行銷活動執行時建立設定檔的更多資訊

note note
NOTE
單一API呼叫支援最多20個不重複收件者。每個收件者必須具有唯一的使用者ID，不允許重複的使用者ID。進一步瞭解互動式訊息執行API檔案

的行銷-type行銷活動，按一下對象按鈕以選擇要鎖定的對象。

設定行銷活動的開始和結束日期。

如果您設定行銷活動的特定開始和/或結束日期，則不會在這些日期以外執行，而如果行銷活動由API觸發，API呼叫將會失敗。
按一下 檢閱以啟動 以檢查您的行銷活動是否已正確設定，然後啟用它。

您現在已準備好從API執行行銷活動。了解更多

執行行銷活動 execute

啟動行銷活動後，您需要擷取產生的範例cURL請求，並將其用於API中以建置您的裝載並觸發行銷活動。

開啟行銷活動，然後從複製並貼上裝載請求 cURL要求 區段。此裝載包含訊息中使用的所有個人化（設定檔和內容）變數。行銷活動上線後，即可使用此功能。

將此cURL請求用於API以建置您的裝載並觸發行銷活動。如需詳細資訊，請參閱互動式訊息執行API檔案.

API呼叫範例也適用於此頁面.

note note
NOTE
如果您在建立行銷活動時已設定特定的開始和/或結束日期，則不會在這些日期以外執行，並且API呼叫將會失敗。

在API觸發的行銷活動中使用內容屬性 contextual

透過API觸發的行銷活動，您可以在API裝載中傳遞其他資料，並在行銷活動中使用這些資料，以個人化您的訊息。

讓我們舉個例子，客戶想要重設密碼，而您想要傳送第三方工具產生的密碼重設URL。透過API觸發的行銷活動，您可以將此產生的URL傳遞至API裝載，並運用至行銷活動以將其新增至訊息。

NOTE

與設定檔啟用的事件不同，在REST API中傳遞的內容資料用於一次性通訊，而不是針對設定檔儲存。設定檔的建立次數上限為名稱空間詳細資訊（如果找不到的話）。

為了在您的行銷活動中使用這些資料，您需要將這些資料傳遞至API裝載，並使用個人化編輯器將其新增至您的訊息中。若要這麼做，請使用 {{context.<contextualAttribute>}} 語法，其中 <contextualAttribute> 應該符合包含您要傳遞之資料的API裝載中的變數名稱。

此 {{context.<contextualAttribute>}} 語法僅對應到String資料型別。