신호 활동 트리거

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

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

워크플로우를 트리거하려면 아래 단계를 따르십시오.

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

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

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

매개 변수를 사용하여 워크플로를 호출하려면 "parameters" 특성을 사용하여 페이로드에 추가합니다. 구문은 매개 변수의 이름 뒤에 해당 값이 오는 대로 구성됩니다(다음 유형이 지원됩니다.string, number, boolean 및 date/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 }

샘플 요청

워크플로우에서 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에 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)