使用訊號觸發協調的行銷活動 trigger-signal
您可以傳送訊號來觸發協調的行銷活動,而非依排程執行。 訊號會透過來自外部系統或應用程式的API呼叫傳送。 使用訊號時,您可以傳遞引數。 接著,這些變數便可在協調的行銷活動中作為執行內容中的事件變數使用,以用於目標定位、條件或運算式。
使用訊號觸發協調行銷活動的端對端程式:
排程要由訊號觸發的行銷活動 configure-signal
若要將協調的行銷活動設為從訊號而非排程開始,請遵循下列步驟:
-
使用訊號開啟您要觸發的「協調流程」行銷活動。
-
開啟排程設定。 瞭解如何排程協調的行銷活動。
-
選取由訊號觸發,讓行銷活動等待訊號而不是依排程執行。
{modal="regular"}
新增訊號承載的引數(選擇性) parameters
您可以在觸發訊號中傳遞引數,並在執行內容中的行銷活動中使用這些引數,例如,在鎖定目標、條件或運算式中。 先定義排程設定中的每個引數,然後在您呼叫觸發程式API時傳遞其值。
-
開啟行銷活動排程器,並選取新增引數。
-
定義要在訊號裝載中傳送的每個引數名稱和資料型別。 您也可以提供測試值,當您在測試模式中觸發行銷活動時,將會使用這些值。 瞭解如何測試觸發的行銷活動。
{modal="regular"}
建置及測試行銷活動 build-and-test
在畫布上建立您的行銷活動,然後在您發佈之前,選擇透過API觸發訊號,在草稿中測試。
-
在畫布上新增並連結活動(對象、目標定位、傳送)。 了解如何協調行銷活動
-
如果您已在訊號中定義引數,則可以將它們匯入畫布邏輯(例如,在條件或目標定位中)。 在此範例中,"channel"引數是當作 測試 活動中的條件。
若要在運算式編輯器中使用訊號引數(例如,在 建立對象 活動中建立查詢),請在運算式欄位中輸入
$(vars/@<parameterName>)。 以排程器中定義的引數名稱取代<parameterName>,例如$(vars/@channel)。 瞭解如何使用運算式編輯器。 -
開啟行銷活動排程器,選取「複製API請求」並選擇格式(cURL或HTTP請求)。
複製的資訊包括協調的行銷活動ID、沙箱名稱、組織ID以及引數的測試值(如果您已新增某些值)。
accordion 包含引數和測試值的範例cURL請求 code language-bash POST https://platform.adobe.io/ajo/campaign-orchestration/orchestratedCampaigns/1c7529c7-7a8c-491a-a2c6-3d8131d2e17d/trigger Headers: Authorization: Bearer ## Access token ## Content-Type: application/json x-api-key: ## Provide API Key here ## x-api-version: 1 x-gw-ims-org-id: 123456ABCDEFG@LumaOrg x-sandbox-name: prod Body: { "variables": { "channel": "sms" } } -
按一下 開始 以開始行銷活動。
-
使用您從排程器複製的範例要求傳送觸發API呼叫。
對測試結果感到滿意時,發佈行銷活動。
發佈並觸發行銷活動 publish
在您建置並測試行銷活動之後,請發佈行銷活動,以便從您的應用程式觸發。
-
在行銷活動畫布中按一下發佈。 必須先發佈行銷活動,才能從外部系統觸發。 進一步瞭解如何啟動及監視行銷活動。
-
開啟行銷活動排程器,選取「複製API請求」並選擇格式(cURL或HTTP請求)。
複製的資訊包括協調的行銷活動ID、沙箱名稱、組織ID以及引數(如果您已新增一些的話)。
-
從您的系統呼叫觸發程式API。
note important IMPORTANT 對於即時協調的行銷活動,節流護欄會強制兩個API觸發執行之間的最小間隔為一小時。 如果您在該間隔經過之前再次呼叫API,API會傳回 HTTP 429 錯誤(請求過多)。 當您觸發草稿版本以進行測試時,不會套用此護欄。 如果您將引數新增至訊號裝載,則行銷活動執行時,您在API呼叫中傳遞的值會顯示為行銷活動事件變數。 若要進行檢查,請從行銷活動畫布工具列開啟行銷活動記錄。 在 工作 標籤中,識別與訊號對應的工作,然後按一下鉛筆圖示以存取相關的事件變數。 瞭解如何存取記錄檔和工作。
{modal="regular"}