신호 활동 트리거 triggering-a-signal-activity

Adobe Campaign Standard 워크플로에서는 하나 이상의 외부 신호 활동이 있을 수 있습니다. 이러한 활동은 트리거되기를 기다리는 '리스너'입니다.

Campaign Standard API를 사용하면 워크플로우를 호출하는 외부 신호 활동을 트리거할 수 있습니다. API 호출에는 워크플로우의 이벤트 변수(타겟팅할 대상 이름, 가져올 파일 이름, 메시지 콘텐츠의 일부 등)에 수집될 매개 변수가 포함될 수 있습니다. 이렇게 하면 Campaign 자동화를 외부 시스템과 쉽게 통합할 수 있습니다.

NOTE
외부 신호 활동은 10분보다 더 자주 트리거할 수 없으며 대상 워크플로우가 이미 실행 중이어야 합니다.

워크플로우를 트리거하려면 아래 단계를 수행합니다.

  1. 워크플로우에서 GET 요청을 수행하여 외부 신호 활동 트리거 URL을 검색합니다.

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

  2. 페이로드에 "source" 매개 변수를 사용하여 반환된 URL에서 POST 요청을 수행하여 신호 활동을 트리거합니다. 이 속성은 필수이며 트리거 요청 소스를 나타낼 수 있도록 해줍니다.

매개 변수를 사용하여 워크플로우를 호출하려면 "parameters" 특성을 사용하여 페이로드에 추가하십시오. 구문은 매개 변수의 이름 뒤에 해당 값으로 구성됩니다. 지원되는 유형은 string, number, booleandate/time ​입니다.

  -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 }
NOTE
매개 변수를 페이로드에 추가할 때 해당 nametype 값이 외부 신호 활동에서 선언된 정보와 일치하는지 확인하십시오. 또한 페이로드 크기는 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/"
        },
        ...
      }
    }
  }
}

신호 활동을 트리거하려면 "source"를 사용하여 트리거 URL에 대한 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)
recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff