활용 사례 use-case

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

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

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

  1. API 호출 만들기 외부 매개 변수로 워크플로우 1을 트리거합니다. 다음을 참조하십시오 1단계: API 호출 구성.
  2. 빌드 워크플로우 1: 워크플로우가 파일을 전송하고 데이터베이스에 로드합니다. 그런 다음 데이터가 비어 있는지 테스트하고, 최종적으로 프로필을 대상자에 저장합니다. 마지막으로 워크플로우 2가 트리거됩니다. 다음을 참조하십시오 2단계: 워크플로우 1 구성.
  3. 빌드 워크플로 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를 호출합니다.

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

  1. API 호출에 정의된 매개 변수를 선언합니다. 이렇게 하려면 External signal 활동을 추가한 다음 매개 변수의 이름과 유형을 추가합니다.

  2. 추가 Transfer file 활동을 사용하여 데이터를 데이터베이스로 가져옵니다. 이렇게 하려면 활동을 끌어다 놓고 연 다음 Protocol 탭.

  3. 다음 항목 선택 Use a dynamic file path 옵션을 선택한 다음 파일 대상 매개 변수를 전송할 파일로:

    code language-none
    $(vars/@fileToTarget)
    

  4. 파일의 데이터를 데이터베이스에 로드합니다.

    이렇게 하려면 을(를) 끌어다 놓습니다. Load file 활동을 워크플로우에 가져온 다음 필요에 따라 구성합니다.

  5. 가져온 파일의 데이터를 사용하여 데이터베이스를 삽입 및 업데이트합니다.

    이렇게 하려면 을(를) 끌어다 놓습니다. Update data 활동을 선택한 다음 Identification 조정 기준을 추가하는 탭(이 예제에서는 이메일 field).

  6. 다음 항목 선택 Fields to update 그런 다음 데이터베이스에서 업데이트할 필드를 지정합니다(이 예제에서는 이름이메일 필드).

  7. 파일에서 데이터가 검색되는지 확인합니다. 이렇게 하려면 을(를) 끌어다 놓습니다. Test 활동을 워크플로우에 가져온 다음, Add an element 단추를 클릭하여 조건을 추가합니다.

  8. 조건의 이름을 지정하고 정의합니다. 이 예제에서는 아웃바운드 전환에 아래 구문이 있는 데이터가 포함되어 있는지 테스트하려고 합니다.

    code language-none
    $long(vars/@recCount)>0
    

  9. 데이터가 검색되면 대상자에 저장합니다. 이렇게 하려면 다음을 추가합니다. Save audience 에 대한 활동 대상이 비어 있지 않음 전환한 다음 엽니다.

  10. 다음 항목 선택 Use a dynamic label 옵션을 선택한 다음 파일 대상 매개 변수를 대상자의 레이블로 사용:

    code language-none
    $(vars/@fileToTarget)
    

  11. 드래그 앤 드롭 End 매개 변수를 사용하여 워크플로우 2를 호출한 다음 여는 활동입니다.

  12. 다음 항목 선택 External signal 그런 다음 트리거할 워크플로우와 관련 신호 활동을 지정합니다.

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

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

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

3단계: 워크플로우 구성 2 step-3--configuring-workflow-2

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

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

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

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

    이렇게 하려면 External signal 활동을 추가한 다음 End 워크플로우 1의 활동.

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

  3. 다음 항목 선택 Use a dynamic audience 옵션을 선택한 다음 파일 대상 매개 변수를 읽을 대상자의 이름으로 사용:

    code language-none
    $(vars/@fileToTarget)
    

  4. 에 따라 아웃바운드 전환 이름을 지정합니다. segmentCode 매개 변수.

    이렇게 하려면 Transition 탭을 클릭한 다음 Use a dynamic segment code 옵션을 선택합니다.

  5. 사용 segmentCode 아웃바운드 전환의 이름으로 사용되는 매개 변수:

    code language-none
    $(vars/@segmentCode)
    

  6. 드래그 앤 드롭 Email delivery 활동을 통해 대상자에게 메시지를 보낼 수 있습니다.

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

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

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

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

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

워크플로우 실행 executing-the-workflows

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

recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff