신호 활동 트리거 triggering-a-signal-activity
Adobe Campaign Standard 워크플로에서는 하나 이상의 외부 신호 활동이 있을 수 있습니다. 이러한 활동은 트리거되기를 기다리는 '리스너'입니다.
Campaign Standard API를 사용하면 워크플로우를 호출하는 외부 신호 활동을 트리거할 수 있습니다. API 호출에는 워크플로우의 이벤트 변수(타겟팅할 대상 이름, 가져올 파일 이름, 메시지 콘텐츠의 일부 등)에 수집될 매개 변수가 포함될 수 있습니다. 이렇게 하면 Campaign 자동화를 외부 시스템과 쉽게 통합할 수 있습니다.
워크플로우를 트리거하려면 아래 단계를 수행합니다.
-
워크플로우에서 GET 요청을 수행하여 외부 신호 활동 트리거 URL을 검색합니다.
GET https://mc.adobe.io/<ORGANIZATION>/campaign/workflow/execution/<workflowID> -
페이로드에 "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/"
},
...
}
}
}
}
신호 활동을 트리거하려면 "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)