觸發訊號活動

在Adobe Campaign Standard工作流中,可以有一個或多個​外部信號​活動。 這些活動是等待觸發的"聽眾"。

Campaign StandardAPI可讓您觸發​外部訊號​活動,以呼叫工作流程。 API呼叫可包含將納入工作流程事件變數的參數(要定位的對象名稱、要匯入的檔案名稱、訊息內容的一部分等)。 如此,您就可輕鬆將Campaign自動化與外部系統整合。

注意

外部信號活動無法比每10分鐘更頻繁地觸發,而且目標工作流必須已運行。

要觸發工作流,請執行以下步驟:

  1. 在工作流程中執行​GET​請求,以擷取「外部訊號」活動觸發URL。

    GET https://mc.adobe.io/<ORGANIZATION>/campaign/workflow/execution/<workflowID>

  2. 對傳回的URL執行​POST​要求,以觸發信號活動,並在裝載中使用​"source"​參數。 此屬性為必填屬性,可讓您指出觸發請求來源。

如果您想使用參數來呼叫工作流,請使用​"parameters"​屬性將其新增至裝載。 語法由參數的名稱及其值組成(支援下列類型:字串數字布林​和​日期/時間)。

  -X POST <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":"<SOURCE>",
  -d    "parameters":{
  -d      "<PARAMETER_NAME":"<PARAMETER_VALUE>",
  -d      "<PARAMETER_NAME":"<PARAMETER_VALUE>",
  -d      "<PARAMETER_NAME":"<PARAMETER_VALUE>",  
  -d      "<PARAMETER_NAME":"<PARAMETER_VALUE>"
  -d    }
  -d }
注意

將參數添加到負載時,請確保其​name​和​type​值與「外部信號」活動中聲明的資訊一致。 此外,有效載荷大小不應超過64Ko。


請求範例

對工作流執行GET請求。

-X GET https://mc.adobe.io/<ORGANIZATION>/campaign/workflow/execution/<workflowID> \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'

它會傳回工作流程訊號活動和相關的觸發url。

{
"PKey": "<PKEY>",
"activities": {
  "activity": {
    "signal1": {
      ...
      "trigger": {
        "href": "https://mc.adobe.io/<ORGANIZATION>/campaign/workflow/execution/<PKEY>/activities/activity/<PKEY>/trigger/"
        },
        ...
      }
    }
  }
}

若要觸發信號活動,請在觸發URL上使用"source"執行POST要求。 如果您想使用參數呼叫工作流,請新增「參數」屬性。

-X POST https://mc.adobe.io/<ORGANIZATION>/campaign/workflow/execution/<PKEY>/activities/activity/<PKEY>/trigger \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>' \
-i
-d '{
-d "source":"API",
-d "parameters":{
-d    "audience":"audience",
-d    "email":"anna.varney@mail.com",
-d    "template":"05",
-d    "contentURL":"http://www.adobe.com",
-d    "test":"true",
-d    "segmentCode":"my segment",
-d    "attribute":"2019-04-03 08:17:19.100Z"}
-d  }'

如果其中一個參數未在「外部信號」活動中宣告,POST請求會傳回以下錯誤,指出缺少哪個參數。

RST-360011 An error has occurred - please contact your administrator.
'contentURL' parameter isn't defined in signal activity.
XTK-170006 Unable to parse expression 'HandleTrigger(@name, $(source), $({parameters}))'.
RST-360000 Error while assessing 'HandleTrigger(@name, $(source), $({parameters}))' expression ('xtk:workflow:execution/activities/signal/trigger' resource)

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now