설명서CampaignCampaign Standard 설명서

활용 사례 use-case

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

작성 대상:

  • 중간
  • 개발자

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

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

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

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

필수 구성 요소 prerequisites

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

1단계: API 호출 구성 step-1--configuring-the-api-call

매개 변수를 사용하여 워크플로우 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 구성 step-2--configuring-workflow-1

워크플로 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 매개 변수를 전송할 파일로 사용합니다.

    code language-none 
    $(vars/@fileToTarget)

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

    이렇게 하려면 Load file 활동을 워크플로우로 끌어서 놓은 다음 필요에 따라 구성합니다.

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

    이렇게 하려면 Update data 활동을 끌어다 놓은 다음 Identification 탭을 선택하여 조정 기준(여기서는 전자 메일 필드)을 추가하십시오.

  6. Fields to update 탭을 선택한 다음 데이터베이스에서 업데이트할 필드(이 경우 firstname 및 email 필드)를 지정하십시오.

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

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

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

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

  10. Use a dynamic label 옵션을 선택한 다음 fileToTarget 매개 변수를 대상자의 레이블로 사용하십시오.

    code language-none 
    $(vars/@fileToTarget)

  11. 매개 변수를 사용하여 워크플로우 2를 호출할 End 활동을 끌어다 놓은 다음 엽니다.

  12. External signal 탭을 선택한 다음 트리거할 워크플로우와 연결된 신호 활동을 지정합니다.

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

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

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

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

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

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

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

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

    이렇게 하려면 External signal 활동을 연 다음 워크플로 1의 End 활동에 정의된 각 매개 변수의 이름과 유형을 추가합니다.

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

  3. Use a dynamic audience 옵션을 선택한 다음 fileToTarget 매개 변수를 읽을 대상 이름으로 사용합니다.

    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