신호 활동 트리거

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

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

노트

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

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

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

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

  2. 다음 작업을 수행합니다. POST 반환된 URL에 대해 를 사용하여 신호 활동을 트리거하도록 요청 "source" 매개 변수를 채우는 방법을 설명합니다. 이 속성은 필수로, 요청 소스를 트리거할 수 있도록 해줍니다.

매개 변수를 사용하여 워크플로우를 호출하려면 를 사용하여 페이로드에 추가합니다. "parameters" 속성을 사용합니다. 구문은 매개 변수의 이름 뒤에 해당 값이 옵니다. 다음 유형이 지원됩니다. string, number, 부울날짜/시간).

  -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 }
노트

페이로드에 매개 변수를 추가할 때는 매개 변수가 있는지 확인합니다 이름유형 값은 외부 신호 활동에 선언된 정보와 일치합니다. 또한 페이로드 크기는 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)

이 페이지에서는