활용 사례

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

적용 대상:
Campaign Standard

주제:

작성 대상:

중간
개발자

아래 사용 사례에서는 워크플로우 내에서 매개 변수를 사용하여 워크플로우를 호출하는 방법을 보여 줍니다.

목표는 외부 매개 변수를 사용하여 API 호출에서 워크플로우를 트리거하는 것입니다. 이 워크플로우는 파일에서 데이터베이스에 데이터를 로드하고 연결된 대상을 만듭니다. 대상자가 만들어지면 API 호출에 정의된 외부 매개 변수로 개인화된 메시지를 보내기 위한 두 번째 워크플로우가 트리거됩니다.

이 사용 사례를 수행하려면 다음 작업을 수행해야 합니다.

외부 매개 변수로 워크플로우 1을 트리거하려면 API를 호출하십시오. 1단계: API 호출 구성을 참조하십시오.
워크플로 빌드 1: 워크플로가 파일을 전송하고 데이터베이스에 로드합니다. 그런 다음 데이터가 비어 있는지 테스트하고, 최종적으로 프로필을 대상자에 저장합니다. 마지막으로 워크플로우 2가 트리거됩니다. 2단계: 워크플로 구성을 참조하십시오.
워크플로 2: 워크플로에서 워크플로 1에서 만든 대상을 읽은 다음, 매개 변수로 사용자 지정된 세그먼트 코드와 함께 개인화된 메시지를 프로필에 보냅니다. 3단계: 워크플로 2 구성을 참조하십시오.

필수 구성 요소

워크플로우를 구성하기 전에 각 워크플로우에 External signal 활동이 있는 워크플로우 1 및 2를 만들어야 합니다. 이렇게 하면 워크플로우를 호출할 때 이러한 신호 활동을 타깃팅할 수 있습니다.

1단계: API 호출 구성

매개 변수를 사용하여 워크플로우 1을 트리거하기 위해 API 호출을 만듭니다. API 호출 구문에 대한 자세한 내용은 Campaign Standard REST API 설명서를 참조하세요.

이 예제에서는 아래 매개 변수를 사용하여 워크플로우를 호출하려고 합니다.

fileToTarget: 데이터베이스로 가져올 파일의 이름입니다.
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 구성

워크플로 1은 다음과 같이 빌드됩니다.

External signal 활동: 워크플로우에서 외부 매개 변수를 사용하려면 선언해야 합니다.
Transfer file 활동: 매개 변수에 정의된 이름으로 파일을 가져옵니다.
Load file 활동: 가져온 파일의 데이터를 데이터베이스에 로드합니다.
Update data 활동: 가져온 파일의 데이터를 사용하여 데이터베이스를 삽입하거나 업데이트합니다.
Test 활동: 가져온 데이터가 있는지 확인합니다.
Save audience 활동: 파일에 데이터가 포함되어 있으면 프로필이 대상에 저장됩니다.
End activity 활동: 활동 내에서 사용할 매개 변수를 사용하여 워크플로우 2를 호출합니다.

아래 단계에 따라 워크플로우를 구성합니다.

API 호출에 정의된 매개 변수를 선언합니다. 이렇게 하려면 External signal 활동을 연 다음 매개 변수의 이름과 형식을 추가합니다.
데이터를 데이터베이스로 가져올 Transfer file 활동을 추가합니다.이렇게 하려면 활동을 끌어다 놓고 연 다음 Protocol 탭을 선택합니다.
Use a dynamic file path 옵션을 선택한 다음 fileToTarget 매개 변수를 전송할 파일로 사용합니다.
$(vars/@fileToTarget)
파일의 데이터를 데이터베이스에 로드합니다.

이렇게 하려면 Load file 활동을 워크플로우로 끌어서 놓은 다음 필요에 따라 구성합니다.
가져온 파일의 데이터를 사용하여 데이터베이스를 삽입 및 업데이트합니다.

이렇게 하려면 Update data 활동을 끌어다 놓은 다음 Identification 탭을 선택하여 조정 기준(여기서는 전자 메일 필드)을 추가하십시오.
Fields to update 탭을 선택한 다음 데이터베이스에서 업데이트할 필드(이 경우 firstname 및 email 필드)를 지정하십시오.
파일에서 데이터가 검색되는지 확인합니다. 이렇게 하려면 Test 활동을 워크플로우로 끌어서 놓은 다음 Add an element 단추를 클릭하여 조건을 추가합니다.
조건의 이름을 지정하고 정의합니다. 이 예제에서는 아웃바운드 전환에 아래 구문이 있는 데이터가 포함되어 있는지 테스트하려고 합니다.
$long(vars/@recCount)>0
데이터가 검색되면 대상자에 저장합니다. 이렇게 하려면 Target이 비어 있지 않음 전환에 Save audience 활동을 추가한 다음 여십시오.
Use a dynamic label 옵션을 선택한 다음 fileToTarget 매개 변수를 대상자의 레이블로 사용하십시오.
$(vars/@fileToTarget)
매개 변수를 사용하여 워크플로우 2를 호출할 End 활동을 끌어다 놓은 다음 엽니다.
External signal 탭을 선택한 다음 트리거할 워크플로우와 연결된 신호 활동을 지정합니다.
워크플로우 2 내에서 사용할 매개 변수와 관련 값을 정의합니다.

이 예제에서는 API 호출에 원래 정의된 매개 변수(fileToTarget 및 discountDesc)와 상수 값("20% 할인")을 사용하는 추가 segmentCode 매개 변수를 전달하려고 합니다.

워크플로우 1이 구성되었으므로 이제 워크플로우 2를 작성할 수 있습니다. 이 작업에 대한 자세한 정보는 이 섹션을 참조하십시오.

3단계: 워크플로우 구성 2

워크플로 2는 다음과 같이 빌드됩니다.

External signal 활동: 워크플로우에서 사용하려면 매개 변수를 선언해야 합니다.
Read audience 활동: 워크플로우 1에 저장된 대상자를 읽습니다.
Email delivery 활동: 매개 변수를 사용하여 개인화된 타겟팅된 대상자에게 반복 메시지를 보냅니다.

아래 단계에 따라 워크플로우를 구성합니다.

워크플로우 1에 정의된 매개 변수를 선언합니다.

이렇게 하려면 External signal 활동을 연 다음 워크플로 1의 End 활동에 정의된 각 매개 변수의 이름과 유형을 추가합니다.
워크플로우 1에 저장된 대상자를 사용합니다. 이렇게 하려면 Read audience 활동을 워크플로우로 끌어서 놓은 다음 엽니다.
Use a dynamic audience 옵션을 선택한 다음 fileToTarget 매개 변수를 읽을 대상 이름으로 사용합니다.
$(vars/@fileToTarget)
segmentCode 매개 변수에 따라 아웃바운드 전환 이름을 지정합니다.

이렇게 하려면 Transition 탭을 선택한 다음 Use a dynamic segment code 옵션을 선택합니다.
segmentCode 매개 변수를 아웃바운드 전환 이름으로 사용합니다.
$(vars/@segmentCode)
Email delivery 활동을 끌어다 놓아 대상자에게 메시지를 보냅니다.
discountDesc 매개 변수를 사용하여 메시지를 개인화하는 데 사용할 매개 변수를 식별하십시오. 이렇게 하려면 활동의 고급 옵션을 연 다음 매개 변수 이름과 값을 추가합니다.
이제 메시지를 구성할 수 있습니다. 활동을 열고 Recurring email 을(를) 선택합니다.
사용할 템플릿을 선택한 다음 필요에 따라 이메일 속성을 정의합니다.
discountDesc 매개 변수를 개인화 필드로 사용하십시오. 이렇게 하려면 개인화 필드 목록에서 선택합니다.
이제 메시지 구성을 완료한 다음 평소대로 전송할 수 있습니다.