활용 사례 use-case
아래 사용 사례에서는 워크플로우 내에서 매개 변수를 사용하여 워크플로우를 호출하는 방법을 보여 줍니다.
목표는 외부 매개 변수를 사용하여 API 호출에서 워크플로우를 트리거하는 것입니다. 이 워크플로우는 파일에서 데이터베이스에 데이터를 로드하고 연결된 대상을 만듭니다. 대상자가 만들어지면 API 호출에 정의된 외부 매개 변수로 개인화된 메시지를 보내기 위한 두 번째 워크플로우가 트리거됩니다.
이 사용 사례를 수행하려면 다음 작업을 수행해야 합니다.
- API 호출 만들기 외부 매개 변수로 워크플로우 1을 트리거합니다. 다음을 참조하십시오 1단계: API 호출 구성.
- 빌드 워크플로우 1: 워크플로우가 파일을 전송하고 데이터베이스에 로드합니다. 그런 다음 데이터가 비어 있는지 테스트하고, 최종적으로 프로필을 대상자에 저장합니다. 마지막으로 워크플로우 2가 트리거됩니다. 다음을 참조하십시오 2단계: 워크플로우 1 구성.
- 빌드 워크플로 2: 워크플로우가 워크플로우 1에서 만든 대상자를 읽은 다음, 개인화된 메시지를 프로필에 보내며, 세그먼트 코드는 매개 변수로 사용자 지정합니다. 다음을 참조하십시오 3단계: 워크플로우 구성 2.
필수 구성 요소 prerequisites
워크플로우를 구성하기 전에 External signal 각 활동. 이렇게 하면 워크플로우를 호출할 때 이러한 신호 활동을 타깃팅할 수 있습니다.
1단계: API 호출 구성 step-1--configuring-the-api-call
매개 변수를 사용하여 워크플로우 1을 트리거하기 위해 API 호출을 만듭니다. API 호출 구문에 대한 자세한 내용은 Campaign Standard REST API 설명서.
이 예제에서는 아래 매개 변수를 사용하여 워크플로우를 호출하려고 합니다.
- 파일 대상: 데이터베이스로 가져올 파일의 이름입니다.
- discountDesc: 할인을 위해 게재에 표시할 설명입니다.
-X POST https://mc.adobe.io/<ORGANIZATION>/campaign/<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:":"API",
-d "parameters":{
-d "fileToTarget":"profile.txt",
-d "discountDesc":"Running shoes"
-d }
2단계: 워크플로우 1 구성 step-2--configuring-workflow-1
워크플로 1은 다음과 같이 빌드됩니다.
- External signal 활동: 워크플로우에서 사용하려면 외부 매개 변수를 선언해야 합니다.
- Transfer file activity: 매개 변수에 정의된 이름으로 파일을 가져옵니다.
- Load file 활동: 가져온 파일의 데이터를 데이터베이스에 로드합니다.
- Update data 활동: 가져온 파일의 데이터로 데이터베이스를 삽입하거나 업데이트합니다.
- Test 활동: 가져온 데이터가 있는지 확인합니다.
- Save audience 활동: 파일에 데이터가 포함되어 있으면 프로필이 대상에 저장됩니다.
- End activity 활동: 내에서 사용할 매개 변수를 사용하여 워크플로우 2를 호출합니다.
아래 단계에 따라 워크플로우를 구성합니다.
-
API 호출에 정의된 매개 변수를 선언합니다. 이렇게 하려면 External signal 활동을 추가한 다음 매개 변수의 이름과 유형을 추가합니다.
-
추가 Transfer file 활동을 사용하여 데이터를 데이터베이스로 가져옵니다. 이렇게 하려면 활동을 끌어다 놓고 연 다음 Protocol 탭.
-
다음 항목 선택 Use a dynamic file path 옵션을 선택한 다음 파일 대상 매개 변수를 전송할 파일로:
code language-none $(vars/@fileToTarget)
-
파일의 데이터를 데이터베이스에 로드합니다.
이렇게 하려면 을(를) 끌어다 놓습니다. Load file 활동을 워크플로우에 가져온 다음 필요에 따라 구성합니다.
-
가져온 파일의 데이터를 사용하여 데이터베이스를 삽입 및 업데이트합니다.
이렇게 하려면 을(를) 끌어다 놓습니다. Update data 활동을 선택한 다음 Identification 조정 기준을 추가하는 탭(이 예제에서는 이메일 field).
-
다음 항목 선택 Fields to update 그런 다음 데이터베이스에서 업데이트할 필드를 지정합니다(이 예제에서는 이름 및 이메일 필드).
-
파일에서 데이터가 검색되는지 확인합니다. 이렇게 하려면 을(를) 끌어다 놓습니다. Test 활동을 워크플로우에 가져온 다음, Add an element 단추를 클릭하여 조건을 추가합니다.
-
조건의 이름을 지정하고 정의합니다. 이 예제에서는 아웃바운드 전환에 아래 구문이 있는 데이터가 포함되어 있는지 테스트하려고 합니다.
code language-none $long(vars/@recCount)>0
-
데이터가 검색되면 대상자에 저장합니다. 이렇게 하려면 다음을 추가합니다. Save audience 에 대한 활동 대상이 비어 있지 않음 전환한 다음 엽니다.
-
다음 항목 선택 Use a dynamic label 옵션을 선택한 다음 파일 대상 매개 변수를 대상자의 레이블로 사용:
code language-none $(vars/@fileToTarget)
-
드래그 앤 드롭 End 매개 변수를 사용하여 워크플로우 2를 호출한 다음 여는 활동입니다.
-
다음 항목 선택 External signal 그런 다음 트리거할 워크플로우와 관련 신호 활동을 지정합니다.
-
워크플로우 2 내에서 사용할 매개 변수와 관련 값을 정의합니다.
이 예제에서는 API 호출에 원래 정의된 매개 변수를 전달하려고 합니다(파일 대상 및 discountDesc) 및 추가 segmentCode 상수 값이 있는 매개 변수("20% 할인")입니다.
워크플로우 1이 구성되었으므로 이제 워크플로우 2를 작성할 수 있습니다. 이 작업에 대한 자세한 정보는 이 섹션을 참조하십시오.
3단계: 워크플로우 구성 2 step-3--configuring-workflow-2
워크플로 2는 다음과 같이 빌드됩니다.
- External signal 활동: 워크플로우 내에서 사용하려면 매개 변수를 선언해야 합니다.
- Read audience 활동: 워크플로우 1에 저장된 대상자를 읽습니다.
- Email delivery 활동: 매개 변수를 사용하여 개인화된 타겟팅된 대상자에게 반복 메시지를 보냅니다.
아래 단계에 따라 워크플로우를 구성합니다.
-
워크플로우 1에 정의된 매개 변수를 선언합니다.
이렇게 하려면 External signal 활동을 추가한 다음 End 워크플로우 1의 활동.
-
워크플로우 1에 저장된 대상자를 사용합니다. 이렇게 하려면 을(를) 끌어다 놓습니다. Read audience 활동을 워크플로우에 가져온 다음 엽니다.
-
다음 항목 선택 Use a dynamic audience 옵션을 선택한 다음 파일 대상 매개 변수를 읽을 대상자의 이름으로 사용:
code language-none $(vars/@fileToTarget)
-
에 따라 아웃바운드 전환 이름을 지정합니다. segmentCode 매개 변수.
이렇게 하려면 Transition 탭을 클릭한 다음 Use a dynamic segment code 옵션을 선택합니다.
-
사용 segmentCode 아웃바운드 전환의 이름으로 사용되는 매개 변수:
code language-none $(vars/@segmentCode)
-
드래그 앤 드롭 Email delivery 활동을 통해 대상자에게 메시지를 보낼 수 있습니다.
-
을(를) 통해 개인화할 메시지에 사용할 매개 변수를 식별합니다. discountDesc 매개 변수. 이렇게 하려면 활동의 고급 옵션을 연 다음 매개 변수 이름과 값을 추가합니다.
-
이제 메시지를 구성할 수 있습니다. 활동을 열고 을 선택합니다. Recurring email.
-
사용할 템플릿을 선택한 다음 필요에 따라 이메일 속성을 정의합니다.
-
사용 discountDesc 매개 변수를 개인화 필드로 사용하십시오. 이렇게 하려면 개인화 필드 목록에서 선택합니다.
-
이제 메시지 구성을 완료한 다음 평소대로 전송할 수 있습니다.
워크플로우 실행 executing-the-workflows
워크플로우가 빌드되면 실행할 수 있습니다. API 호출을 수행하기 전에 두 워크플로우가 시작되었는지 확인하십시오.