Adobe Campaign Standard 워크플로우에는 하나 이상의 외부 신호 활동이 있을 수 있습니다. 이러한 활동은 트리거하기를 기다리는 '리스너'입니다.
Campaign Standard API를 사용하면 외부 신호 활동을 트리거하여 워크플로우를 호출할 수 있습니다. API 호출에는 워크플로우의 이벤트 변수(타깃팅할 대상 이름, 가져올 파일 이름, 메시지 내용의 일부 등)에 인제스트될 매개 변수가 포함될 수 있습니다. 이렇게 하면 캠페인 자동화를 외부 시스템과 쉽게 통합할 수 있습니다.
외부 신호 활동은 10분마다 이상 트리거할 수 없으며 대상 워크플로우가 이미 실행 중이어야 합니다.
워크플로우를 트리거하려면 아래 단계를 따르십시오.
외부 신호 활동 트리거 URL을 검색하기 위해 워크플로우에서 GET 요청을 수행합니다.
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 }
페이로드에 매개 변수를 추가할 때 해당 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에 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)