Show Menu
화제×

사용 사례

아래의 사용 사례는 워크플로우 내의 매개 변수를 사용하여 워크플로우를 호출하는 방법을 보여줍니다.
목표는 외부 매개 변수를 사용하는 API 호출에서 워크플로우를 트리거하는 것입니다. 이 워크플로우는 파일에서 데이터베이스에 데이터를 로드하고 관련 대상을 만듭니다. 대상이 만들어지면 API 호출에 정의된 외부 매개 변수를 사용하여 개인화된 메시지를 보내도록 두 번째 워크플로우가 트리거됩니다.
이 사용 사례를 수행하려면 아래 작업을 수행해야 합니다.
  1. 외부 매개 변수를 사용하여 Workflow 1을 트리거하는 API 호출을 만듭니다. 1단계 를 참조하십시오.API 호출 구성
  2. 빌드 워크플로 1 :워크플로우는 파일을 전송하고 데이터베이스로 로드합니다. 그런 다음 데이터가 비어 있는지 여부를 테스트하고, 결국 프로필에 저장합니다. 마지막으로 워크플로우 2가 트리거됩니다. 2단계 를 참조하십시오.워크플로우 구성 1 .
  3. 빌드 워크플로우 2 :워크플로우는 워크플로우 1에서 만든 고객을 읽은 다음, 매개 변수에 맞게 맞춤화된 세그먼트 코드와 함께 개인화된 메시지를 프로필에 보냅니다. 3단계 를 참조하십시오.워크플로우 구성 2 .

사전 요구 사항

워크플로우를 구성하려면 먼저 각각 활동 내용이 포함된 Workflow 1과 2를 만들어야 External signal 합니다. 이렇게 하면 워크플로우를 호출할 때 이러한 신호 활동을 타깃팅할 수 있습니다.

1단계:API 호출 구성

매개 변수를 사용하여 워크플로우 1을 트리거하는 API 호출을 만듭니다. API 호출 구문에 대한 자세한 내용은 Campaign Standard REST API 설명서를 참조하십시오 .
Adobe에서는 아래 매개 변수를 사용하여 워크플로우를 호출하려고 합니다.
  • 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

Workflow 1은 다음과 같이 빌드됩니다.
  • External signal 활동:여기서 외부 매개 변수를 선언해야 워크플로우 내에서 사용할 수 있습니다.
  • Transfer file 활동:매개 변수에 정의된 이름으로 파일을 가져옵니다.
  • Load file 활동:가져온 파일의 데이터를 데이터베이스로 로드합니다.
  • Update data 활동:가져온 파일의 데이터로 데이터베이스를 삽입하거나 업데이트합니다.
  • Test 활동:가져온 데이터가 있는지 확인합니다.
  • Save audience 활동:파일에 데이터가 들어 있으면 해당 프로필을 대상에 저장합니다.
  • End activity 활동:워크플로 2를 호출합니다.
아래 절차에 따라 워크플로우를 구성합니다.
  1. API 호출에 정의된 매개 변수를 선언합니다. 이렇게 하려면 활동을 연 다음 매개 변수의 이름과 유형을 추가합니다. External signal
  2. 데이터를 데이터베이스에 가져올 Transfer file 활동을 추가합니다.이렇게 하려면 활동을 드래그 앤 드롭한 다음 열고 Protocol 탭을 선택합니다.
  3. 옵션을 Use a dynamic file path 선택한 다음 fileToTarget 매개 변수를 전송할 파일로 사용합니다.
    $(vars/@fileToTarget)
    
    
  4. 파일의 데이터를 데이터베이스로 로드합니다.
    이렇게 하려면 작업을 워크플로우로 드래그 앤 드롭한 다음 필요에 따라 구성합니다. Load file
  5. 가져온 파일의 데이터로 데이터베이스를 삽입하고 업데이트합니다.
    이렇게 하려면 Update data 활동을 끌어다 놓은 다음 Identification 탭을 선택하여 조정 기준을 추가합니다(이메일 ​필드).
  6. 탭을 Fields to update 선택한 다음 데이터베이스에서 업데이트할 필드를 지정합니다( 이름 이메일 필드).
  7. 파일에서 데이터가 검색되는지 확인합니다. 이렇게 하려면 Test 활동을 워크플로우로 드래그 앤 드롭한 다음 Add an element 단추를 클릭하여 조건을 추가합니다.
  8. 조건의 이름을 지정하고 정의합니다. 이 경우 아웃바운드 전환 시 아래 구문을 포함한 데이터가 들어 있는지 테스트하려고 합니다.
    $long(vars/@recCount)>0
    
    
  9. 데이터가 검색되면 대상에 저장합니다. 이렇게 하려면 Save audience Target에 빈 ​전환이 아닌 활동을 추가한 다음 엽니다.
  10. 옵션을 Use a dynamic label 선택한 다음 fileToTarget 매개 변수를 대상 레이블로 사용합니다.
    $(vars/@fileToTarget)
    
    
  11. 매개 변수를 사용하여 Workflow 2를 호출할 End 활동을 드래그하여 놓은 다음 엽니다.
  12. 탭을 External signal 선택한 다음 트리거할 워크플로우와 연관된 신호 활동을 지정합니다.
  13. 워크플로우 2 내에서 사용할 매개 변수와 관련 값을 정의합니다.
    이 경우, API 호출에 원래 정의된 매개 변수(fileToTarget discountDesc )와 상수 값이 있는 추가 segmentCode 매개 변수("20% 할인")를 전달하려고 합니다 .
워크플로우 1이 구성되었으므로 이제 워크플로우 2를 작성할 수 있습니다. 이 작업에 대한 자세한 정보는 이 섹션 을 참조하십시오.

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

Workflow 2는 다음과 같이 빌드됩니다.
  • External signal 활동:여기서 는 워크플로우 내에서 사용하기 위해 매개 변수를 선언해야 합니다.
  • Read audience 활동:워크플로우 1에 저장된 대상을 읽습니다.
  • Email delivery 활동:매개 변수를 사용하여 개인화된 타깃팅된 대상자에게 반복 메시지를 보냅니다.
아래 절차에 따라 워크플로우를 구성합니다.
  1. 워크플로우 1에서 정의된 매개 변수를 선언합니다.
    이렇게 하려면 External signal 활동을 연 다음 워크플로우 1의 활동에 정의된 각 매개 변수의 이름과 유형을 End 추가합니다.
  2. 워크플로우 1에서 저장된 대상을 사용합니다. 이렇게 하려면 활동을 워크플로우로 드래그하여 놓은 다음 Read audience 엽니다.
  3. 옵션을 Use a dynamic audience 선택한 다음 fileToTarget 매개 변수를 읽을 대상 이름으로 사용합니다.
    $(vars/@fileToTarget)
    
    
  4. segmentCode 매개 변수에 따라 아웃바운드 전환 이름을 지정합니다.
    To do this, select the Transition tab, then the Use a dynamic segment code option.
  5. 아웃바운드 전환 이름으로 segmentCode 매개 변수를 사용합니다.
    $(vars/@segmentCode)
    
    
  6. 대상을 대상으로 메시지를 보낼 Email delivery 활동을 끌어다 놓습니다.
  7. 메시지에 사용할 매개 변수를 식별하여 discountDesc 매개 변수로 개인화합니다 . 이렇게 하려면 활동의 고급 옵션을 연 다음 매개 변수 이름과 값을 추가합니다.
  8. 이제 메시지를 구성할 수 있습니다. 활동을 열고 선택합니다 Recurring email .
  9. 사용할 템플릿을 선택한 다음 필요에 따라 이메일 속성을 정의합니다.
  10. personalization 필드로 discountDesc 매개 변수를 사용합니다. 이렇게 하려면 개인화 필드 목록에서 선택합니다.
  11. 이제 메시지 구성을 완료한 다음 평소대로 보낼 수 있습니다.

워크플로우 실행

워크플로우가 만들어지면 실행할 수 있습니다. API 호출을 수행하기 전에 두 개의 워크플로우가 시작되었는지 확인합니다.