활용 사례

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

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

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

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

필수 구성 요소

워크플로우를 구성하기 전에 External signal 활동 각각에 포함되어 있습니다. 이 방법으로 워크플로우를 호출할 때 이러한 신호 활동을 타깃팅할 수 있습니다.

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 활동: 에서는 내에서 사용할 매개 변수로 Workflow 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. 끌어서 놓기 End 매개 변수를 사용하여 워크플로우 2를 호출한 다음 엽니다.

  12. 을(를) 선택합니다 External signal 탭한 다음, 트리거할 워크플로우 및 관련 신호 활동을 지정합니다.

  13. 워크플로우 2 내에서 사용할 매개 변수와 관련 값을 정의합니다.

    이 경우 API 호출에 원래 정의된 매개 변수(fileToTargetdiscountDesc) 및 추가 segmentCode 상수 값이 있는 매개 변수("20% 할인").

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

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

워크플로우 2는 다음과 같이 작성됩니다.

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

아래 절차에 따라 워크플로우를 구성하십시오.

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

    이렇게 하려면 External signal 활동을 만든 다음, End 워크플로우 1 활동.

  2. 워크플로우 1에 저장된 대상자를 사용합니다. 이렇게 하려면 을(를) 끌어다 놓습니다 Read audience 활동을 워크플로우에 끌어와 다음 엽니다.

  3. 을(를) 선택합니다 Use a dynamic audience 옵션을 선택한 다음 fileToTarget 매개 변수를 읽을 대상자의 이름으로 지정합니다.

    $(vars/@fileToTarget)
    

  4. 아웃바운드 전환 이름을 segmentCode 매개 변수.

    이렇게 하려면 Transition 탭을 클릭한 다음 Use a dynamic segment code 선택 사항입니다.

  5. 를 사용하십시오 segmentCode 매개 변수를 아웃바운드 전환 이름으로 지정합니다.

    $(vars/@segmentCode)
    

  6. 끌어서 놓기 Email delivery 활동을 통해 대상자에게 메시지를 보냅니다.

  7. 메시지에서 사용할 매개 변수를 식별하고 를 사용하여 개인화합니다. discountDesc 매개 변수. 이렇게 하려면 활동의 고급 옵션을 연 다음, 매개 변수 이름과 값을 추가합니다.

  8. 이제 메시지를 구성할 수 있습니다. 활동을 열고 을 선택합니다 Recurring email.

  9. 사용할 템플릿을 선택한 다음 필요에 따라 이메일 속성을 정의합니다.

  10. 를 사용하십시오 discountDesc 매개 변수를 개인화 필드로 사용할 수 있습니다. 이렇게 하려면 개인화 필드 목록에서 선택합니다.

  11. 이제 메시지 구성을 완료한 다음 평소대로 보낼 수 있습니다.

워크플로우 실행

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

이 페이지에서는