> For the complete documentation index, see [llms.txt](https://docs.hackle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hackle.io/crm-marketing/user-journey-guide/create-user-journey.md).
# 사용자 여정 만들기
이 페이지에서는 사용자 여정의 기본 설정 방법을 설명합니다.
이외 다양한 사용자 여정 활용 방법은 [사용자 여정 활용 예시](/crm-marketing/user-journey-guide/example.md)에서 확인할 수 있습니다.
{% stepper %}
{% step %}
### **사용자 여정 생성하기**
대시보드의 메뉴의 **`사용자 여정`** 메뉴 우측 상단에 위치한 **`+ 캠페인 만들기`** 버튼을 클릭해서 새로운 사용자 여정을 생성하실 수 있습니다.
#### **사용자 여정 구성**
1. 패널 : 원하는 노드를 직접 드래그 앤 드랍하여 단계를 추가할 수 있습니다
2. 자동 정렬하기 : 클릭 시 화면 내 추가한 항목들이 자동으로 정렬됩니다.
3. 사용자 여정 설정 : 여정을 위한 기본 설정입니다.
{% hint style="info" %}
#### 화면 조작 가이드
* 스크롤 : 상하 이동
* 드래그 : 캔버스 이동
* command / ctrl + 마우스 휠 : 확대 / 축소
* 마우스 패드 오므리기 / 펼치기 : 확대 / 축소
{% endhint %}
#### **사용자 여정 설정하기**
원하는 노드를 패널에서 선택하여 드래그하여 추가한 후, 각 노드 하단의 동그라미를 드래그하여 노드를 연결할 수 있습니다.
항목 클릭 시 상세 화면을 확인할 수 있습니다. 항목별 필요한 설정을 완료하세요.
{% endstep %}
{% step %}
### **대상, 진입 조건 & 이탈 조건 설정**
사용자 여정 시작을 위해서 필요한 기본 설정을 완료해야 합니다.
#### **대상**
여정에 진입할 사용자를 설정할 수 있습니다. 특정 속성을 만족하는 사용자 또는 특정 코호트에 해당하는 사용자를 선택할 수 있습니다.
#### **진입 조건**
사용자가 특정 행동을 하거나 조건을 충족하면 여정이 시작됩니다. 예를 들어, 서비스에 신규 가입하거나 특정 페이지를 방문하면 자동으로 진입할 수 있습니다.
* 진입 이벤트는 최대 10개까지 추가 가능합니다.
* 진입 이벤트 발생시 즉시 여정이 시작됩니다.
* 설정한 기간 내에 조건을 만족하는 사용자를 대상으로 여정이 진행됩니다.
#### **이탈 조건 (선택)**
사용자가 특정 조건을 만족하면 여정에서 이탈합니다. 예를 들어, 목표 행동(구매, 클릭 등)을 완료하거나 일정 기간 동안 반응이 없으면 여정에서 제외됩니다.
{% endstep %}
{% step %}
### 채널
채널 노드는 사용자에게 실제 메시지나 요청을 전달하는 단계입니다. 목적에 맞는 채널을 선택하고, 각 채널에 필요한 발송 내용을 설정하세요.
{% tabs %}
{% tab title="푸시 메시지" icon="message-dot" %}
푸시 메시지 노드에서는 발송할 플랫폼과 메시지 내용을 설정합니다.
* 제목, 본문, 이미지, 딥링크를 입력할 수 있습니다.
* 개인화 문구와 미리보기로 실제 노출 형태를 확인할 수 있습니다.
* 테스트 발송으로 기기에서 메시지를 미리 검증할 수 있습니다.
자세한 설정은 [푸시 메시지 캠페인 만들기](/crm-marketing/push-message-guide/create-campaign.md)에서 확인하세요.
{% endtab %}
{% tab title="알림톡 메시지" icon="message-smile" %}
알림톡 메시지 노드에서는 검수된 템플릿을 선택하고 변수를 연결합니다.
* 템플릿을 선택한 뒤 개인화 변수를 매핑합니다.
* 사용자 메시지 미리보기로 치환 결과를 확인할 수 있습니다.
* 테스트 발송으로 실제 수신 화면을 점검할 수 있습니다.
자세한 설정은 [카카오 알림톡 작성하기](/crm-marketing/kakao-message-guide/alimtalk.md)에서 확인하세요.
{% endtab %}
{% tab title="브랜드 메시지" icon="message-dots" %}
브랜드 메시지 노드에서는 카카오 채널 기반 광고성 메시지를 설정합니다.
* 발송 조건을 충족한 뒤 템플릿을 선택합니다.
* 개인화 변수를 연결해 맞춤형 메시지를 구성할 수 있습니다.
* 브랜드 메시지(기본형) 발송을 위해서는 [브랜드 메시지 타겟팅](https://dashboard.hackle.io/workspaces/115054/config/platform-integrations?tab=KAKAOTALK_CHANNEL)을 따로 신청해주세요.
자세한 설정은 [카카오 브랜드 메시지 작성하기](/crm-marketing/kakao-message-guide/brand-message-targeting.md)에서 확인하세요.
{% endtab %}
{% tab title="문자 메시지" icon="message-sms" %}
문자 메시지 노드에서는 발신 정보와 메시지 유형을 함께 설정합니다.
* 발신 번호와 수신 거부 번호를 확인합니다.
* SMS, LMS, MMS 중 목적에 맞는 유형을 선택합니다.
* 광고 문구, 개인화 변수를 설정할 수 있습니다.
자세한 설정은 [문자 메시지 작성하기](/crm-marketing/sms/send-text-message.md)에서 확인하세요.
{% endtab %}
{% tab title="웹훅" icon="webhook" %}
웹훅 노드에서는 외부 시스템으로 요청을 보내는 조건을 설정합니다.
* URL, Method, Parameters, Headers, Body를 입력합니다.
* 사용자 속성이나 이벤트 속성으로 요청 값을 개인화할 수 있습니다.
* 테스트 발송으로 응답 결과를 바로 확인할 수 있습니다.
자세한 설정은 [웹훅 발송하기](/crm-marketing/webhook-guide/send-webhook.md)에서 확인하세요.
{% endtab %}
{% endtabs %}
#### **발송 결과에 따른 분기**
메시지의 경우, 발송 결과에 따라 분기를 나누어 사용자의 다음 여정을 설정할 수 있습니다. 다음과 같은 사유 등으로 메시지가 전송 되지 않을 수 있습니다.
**발송 실패 사유**
* 발송 제한 시간 동안 발송 요청된 경우 (공통)
| 푸시 메시지 | 카카오 메시지 | 문자 메시지 |
| ----------------- | ---------------- | ---------------- |
| 푸시 토큰이 존재하지 않는 경우 | 전화번호가 수집되지 않은 경우 | 전화번호가 수집되지 않은 경우 |
| 푸시 토큰이 만료된 경우 | 캐시가 부족한 경우 | 캐시가 부족한 경우 |
| | 채널 친구가 아닌 경우 | |
| {% endstep %} | | |
{% step %}
### 분기
분기는 사용자 여정에서 특정 조건에 따라 경로를 나누는 기능입니다. 이를 통해 사용자의 행동, 속성, 이벤트 발생 여부에 따라 맞춤형 경험을 제공할 수 있습니다.
A/B 테스트 기반 분기
{% hint style="info" %}
분기된 각 그룹에 대해 이름을 설정할 수 있습니다. 그룹 이름을 수정하여 캠페인 성과를 더 쉽게 파악하세요.
{% endhint %}
#### **사용자 기반 분기**
사용자의 속성(Ex. 가입일, 지역, 구매 이력 등)에 따라 경로를 분기합니다. 예를 들어, VIP 고객과 일반 고객에게 다른 메시지를 발송할 수 있습니다.
#### **이벤트 기반 분기**
사용자의 특정 행동(Ex. 버튼 클릭, 장바구니 담기 등)에 따라 여정을 분기합니다. 예를 들어, 구매한 사용자와 구매하지 않은 사용자에게 다른 메시지를 발송할 수 있습니다.
#### **A/B 테스트 기반 분기**
분기에 진입한 사용자를 대상으로 A/B 테스트를 진행할 수 있습니다. 사용자는 각 그룹에 균등하게 분배되며, 그룹별로 다른 메시지나 액션을 연결할 수 있습니다. 지표를 설정하여 A/B 테스트의 성과를 측정해보세요.
**A/B 테스트 시작**
여정 시작 시, A/B 테스트도 함께 시작되며 상세 화면에서 A/B 테스트 진행 상태 및 지표 데이터를 확인할 수 있습니다.
**A/B 테스트 종료**
여정에서 A/B 테스트 노드의 실험을 종료하는 방법은 아래와 같습니다.
1. **개별 테스트 노드에서 종료**
여정의 상태와 별개로 원하는 시점에 종료할 수 있습니다. A/B 테스트 상세 화면에서 \[종료하기]를 눌러 테스트 결과 확인 후 종료하세요.
2. **여정 종료**
여정 종료 시, 여정에 포함된 모든 테스트 또한 함께 종료됩니다. 종료 모달에서 모든 A/B 테스트 노드의 실험 결과를 각각 확인 후 일괄 종료 처리할 수 있습니다.
{% hint style="info" icon="lightbulb" %}
#### 이렇게 활용해보세요!
* **채널 비교**: 어떤 채널이 더 잘 반응하는지 검증
* 알림톡 vs 푸시 vs 문자
* **발송 로직 비교**: 어떤 흐름이 전환율이 높은지 비교
* ex. 쿠폰을 바로 주는 그룹 vs. 콘텐츠 먼저 보내고 쿠폰 주는 그룹
* **시간대 테스트**: 최적 타이밍 찾기
* ex. 동일 메시지를 1시간 후 발송 vs. 24시간 후 발송
[활용 예시 더보기](/crm-marketing/user-journey-guide/example.md)
{% endhint %}
{% endstep %}
{% step %}
### 대기 시간
특정 시간 동안 대기한 후 다음 단계를 진행합니다. 예를 들어, 장바구니 담기 후 24시간 대기한 뒤 구매하지 않은 사용자에게 메시지를 보낼 수 있습니다.
{% endstep %}
{% step %}
### **시작하기**
모든 설정이 완료되었다면, 우측 상단의 \[시작하기] 버튼을 클릭하여 사용자 여정을 활성화할 수 있습니다.
{% hint style="warning" %}
여정을 시작하기 전 모든 항목들이 제대로 연결되었는지 확인해주세요!
{% endhint %}
**진행 중 여정 수정하기**
* 활성화 상태에도 여정을 수정할 수 있습니다.
* 우측 상단 \[수정하기] 버튼을 눌러 진행해주시면 됩니다. 수정 사항 저장 시 변경된 내용이 사용자에게 **즉시 반영**되니 유의하세요.
* 분기 노드 내 그룹 조건은 수정 가능하지만, 그룹 삭제/추가는 불가능합니다. (A/B 테스트 노드는 그룹 제외 가능)
{% endstep %}
{% step %}
### **사용자 여정 생성하기**
대시보드의 메뉴의 **`사용자 여정`** 메뉴 우측 상단에 위치한 **`+ 캠페인 만들기`** 버튼을 클릭해서 새로운 사용자 여정을 생성하실 수 있습니다.
#### **사용자 여정 구성**
1. 패널 : 원하는 노드를 직접 드래그 앤 드랍하여 단계를 추가할 수 있습니다
2. 자동 정렬하기 : 클릭 시 화면 내 추가한 항목들이 자동으로 정렬됩니다.
3. 사용자 여정 설정 : 여정을 위한 기본 설정입니다.
{% hint style="info" %}
#### 화면 조작 가이드
* 스크롤 : 상하 이동
* 드래그 : 캔버스 이동
* command / ctrl + 마우스 휠 : 확대 / 축소
* 마우스 패드 오므리기 / 펼치기 : 확대 / 축소
{% endhint %}
#### **사용자 여정 설정하기**
원하는 노드를 패널에서 선택하여 드래그하여 추가한 후, 각 노드 하단의 동그라미를 드래그하여 노드를 연결할 수 있습니다.
항목 클릭 시 상세 화면을 확인할 수 있습니다. 항목별 필요한 설정을 완료하세요.
{% endstep %}
{% step %}
### **대상, 진입 조건 & 이탈 조건 설정**
사용자 여정 시작을 위해서 필요한 기본 설정을 완료해야 합니다.
#### **대상**
여정에 진입할 사용자를 설정할 수 있습니다. 특정 속성을 만족하는 사용자 또는 특정 코호트에 해당하는 사용자를 선택할 수 있습니다.
#### **진입 조건**
사용자가 특정 행동을 하거나 조건을 충족하면 여정이 시작됩니다. 예를 들어, 서비스에 신규 가입하거나 특정 페이지를 방문하면 자동으로 진입할 수 있습니다.
* 진입 이벤트는 최대 10개까지 추가 가능합니다.
* 진입 이벤트 발생시 즉시 여정이 시작됩니다.
* 설정한 기간 내에 조건을 만족하는 사용자를 대상으로 여정이 진행됩니다.
#### **이탈 조건 (선택)**
사용자가 특정 조건을 만족하면 여정에서 이탈합니다. 예를 들어, 목표 행동(구매, 클릭 등)을 완료하거나 일정 기간 동안 반응이 없으면 여정에서 제외됩니다.
{% endstep %}
{% step %}
### 채널
채널 노드는 사용자에게 실제 메시지나 요청을 전달하는 단계입니다. 목적에 맞는 채널을 선택하고, 각 채널에 필요한 발송 내용을 설정하세요.
{% tabs %}
{% tab title="푸시 메시지" icon="message-dot" %}
푸시 메시지 노드에서는 발송할 플랫폼과 메시지 내용을 설정합니다.
* 제목, 본문, 이미지, 딥링크를 입력할 수 있습니다.
* 개인화 문구와 미리보기로 실제 노출 형태를 확인할 수 있습니다.
* 테스트 발송으로 기기에서 메시지를 미리 검증할 수 있습니다.
자세한 설정은 [푸시 메시지 캠페인 만들기](/crm-marketing/push-message-guide/create-campaign.md)에서 확인하세요.
{% endtab %}
{% tab title="알림톡 메시지" icon="message-smile" %}
알림톡 메시지 노드에서는 검수된 템플릿을 선택하고 변수를 연결합니다.
* 템플릿을 선택한 뒤 개인화 변수를 매핑합니다.
* 사용자 메시지 미리보기로 치환 결과를 확인할 수 있습니다.
* 테스트 발송으로 실제 수신 화면을 점검할 수 있습니다.
자세한 설정은 [카카오 알림톡 작성하기](/crm-marketing/kakao-message-guide/alimtalk.md)에서 확인하세요.
{% endtab %}
{% tab title="브랜드 메시지" icon="message-dots" %}
브랜드 메시지 노드에서는 카카오 채널 기반 광고성 메시지를 설정합니다.
* 발송 조건을 충족한 뒤 템플릿을 선택합니다.
* 개인화 변수를 연결해 맞춤형 메시지를 구성할 수 있습니다.
* 브랜드 메시지(기본형) 발송을 위해서는 [브랜드 메시지 타겟팅](https://dashboard.hackle.io/workspaces/115054/config/platform-integrations?tab=KAKAOTALK_CHANNEL)을 따로 신청해주세요.
자세한 설정은 [카카오 브랜드 메시지 작성하기](/crm-marketing/kakao-message-guide/brand-message-targeting.md)에서 확인하세요.
{% endtab %}
{% tab title="문자 메시지" icon="message-sms" %}
문자 메시지 노드에서는 발신 정보와 메시지 유형을 함께 설정합니다.
* 발신 번호와 수신 거부 번호를 확인합니다.
* SMS, LMS, MMS 중 목적에 맞는 유형을 선택합니다.
* 광고 문구, 개인화 변수를 설정할 수 있습니다.
자세한 설정은 [문자 메시지 작성하기](/crm-marketing/sms/send-text-message.md)에서 확인하세요.
{% endtab %}
{% tab title="웹훅" icon="webhook" %}
웹훅 노드에서는 외부 시스템으로 요청을 보내는 조건을 설정합니다.
* URL, Method, Parameters, Headers, Body를 입력합니다.
* 사용자 속성이나 이벤트 속성으로 요청 값을 개인화할 수 있습니다.
* 테스트 발송으로 응답 결과를 바로 확인할 수 있습니다.
자세한 설정은 [웹훅 발송하기](/crm-marketing/webhook-guide/send-webhook.md)에서 확인하세요.
{% endtab %}
{% endtabs %}
#### **발송 결과에 따른 분기**
메시지의 경우, 발송 결과에 따라 분기를 나누어 사용자의 다음 여정을 설정할 수 있습니다. 다음과 같은 사유 등으로 메시지가 전송 되지 않을 수 있습니다.
**발송 실패 사유**
모든 채널에는 공통 실패 사유가 있습니다.
* 발송 제한 시간 동안 발송 요청된 경우
채널별 실패 사유는 아래와 같습니다.
**푸시 메시지**
* 푸시 토큰이 존재하지 않는 경우
* 푸시 토큰이 만료된 경우
**카카오 메시지**
* 전화번호가 수집되지 않은 경우
* 캐시가 부족한 경우
* 채널 친구가 아닌 경우
**문자 메시지**
* 전화번호가 수집되지 않은 경우
* 캐시가 부족한 경우
{% endstep %}
{% step %}
### 분기
분기는 사용자 여정에서 특정 조건에 따라 경로를 나누는 기능입니다. 이를 통해 사용자의 행동, 속성, 이벤트 발생 여부에 따라 맞춤형 경험을 제공할 수 있습니다.
A/B 테스트 기반 분기
{% hint style="info" %}
분기된 각 그룹에 대해 이름을 설정할 수 있습니다. 그룹 이름을 수정하여 캠페인 성과를 더 쉽게 파악하세요.
{% endhint %}
#### **사용자 기반 분기**
사용자의 속성(Ex. 가입일, 지역, 구매 이력 등)에 따라 경로를 분기합니다. 예를 들어, VIP 고객과 일반 고객에게 다른 메시지를 발송할 수 있습니다.
#### **이벤트 기반 분기**
사용자의 특정 행동(Ex. 버튼 클릭, 장바구니 담기 등)에 따라 여정을 분기합니다. 예를 들어, 구매한 사용자와 구매하지 않은 사용자에게 다른 메시지를 발송할 수 있습니다.
#### **A/B 테스트 기반 분기**
분기에 진입한 사용자를 대상으로 A/B 테스트를 진행할 수 있습니다. 사용자는 각 그룹에 균등하게 분배되며, 그룹별로 다른 메시지나 액션을 연결할 수 있습니다. 지표를 설정하여 A/B 테스트의 성과를 측정해보세요.
**A/B 테스트 시작**
여정 시작 시, A/B 테스트도 함께 시작되며 상세 화면에서 A/B 테스트 진행 상태 및 지표 데이터를 확인할 수 있습니다.
**A/B 테스트 종료**
여정에서 A/B 테스트 노드의 실험을 종료하는 방법은 아래와 같습니다.
1. **개별 테스트 노드에서 종료**
여정의 상태와 별개로 원하는 시점에 종료할 수 있습니다. A/B 테스트 상세 화면에서 \[종료하기]를 눌러 테스트 결과 확인 후 종료하세요.
2. **여정 종료**
여정 종료 시, 여정에 포함된 모든 테스트 또한 함께 종료됩니다. 종료 모달에서 모든 A/B 테스트 노드의 실험 결과를 각각 확인 후 일괄 종료 처리할 수 있습니다.
{% hint style="info" icon="lightbulb" %}
#### 이렇게 활용해보세요!
* **채널 비교**: 어떤 채널이 더 잘 반응하는지 검증
* 알림톡 vs 푸시 vs 문자
* **발송 로직 비교**: 어떤 흐름이 전환율이 높은지 비교
* ex. 쿠폰을 바로 주는 그룹 vs. 콘텐츠 먼저 보내고 쿠폰 주는 그룹
* **시간대 테스트**: 최적 타이밍 찾기
* ex. 동일 메시지를 1시간 후 발송 vs. 24시간 후 발송
{% endhint %}
{% endstep %}
{% step %}
### 대기 시간
특정 시간 동안 대기한 후 다음 단계를 진행합니다. 예를 들어, 장바구니 담기 후 24시간 대기한 뒤 구매하지 않은 사용자에게 메시지를 보낼 수 있습니다.
{% endstep %}
{% step %}
### **시작하기**
모든 설정이 완료되었다면, 우측 상단의 \[시작하기] 버튼을 클릭하여 사용자 여정을 활성화할 수 있습니다.
{% hint style="warning" %}
여정을 시작하기 전 모든 항목들이 제대로 연결되었는지 확인해주세요!
{% endhint %}
**진행 중 여정 수정하기**
* 활성화 상태에도 여정을 수정할 수 있습니다.
* 우측 상단 \[수정하기] 버튼을 눌러 진행해주시면 됩니다. 수정 사항 저장 시 변경된 내용이 사용자에게 **즉시 반영**되니 유의하세요.
* 분기 노드 내 그룹 조건은 수정 가능하지만, 그룹 삭제/추가는 불가능합니다. (A/B 테스트 노드는 그룹 제외 가능)
{% endstep %}
{% endstepper %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.hackle.io/crm-marketing/user-journey-guide/create-user-journey.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.