利用 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,根據使用者互動從外部系統建立及觸發行銷活動。