11 KiB
title, description, sidebar_position
| title | description | sidebar_position |
|---|---|---|
| 채널 | ABC User Feedback에서 피드백 수집 채널을 생성, 설정, 관리하고 커스텀 필드 및 이미지 설정을 다루는 방법을 설명합니다. | 3 |
채널
채널(Channel) 은 피드백을 수집하는 경로 또는 목적에 따라 구분되는 단위입니다. 각 채널은 독립된 필드 구조, 이미지 설정, AI 기능을 가져 다양한 피드백 수집 시나리오에 맞게 설정할 수 있습니다.
채널 개요
채널의 역할
채널은 다음 역할을 합니다:
- 피드백 수집 경로 구분: 웹, 앱, 고객센터, 설문조사 등
- 데이터 구조 정의: 채널별 고유한 필드 설정
- 수집 정책 관리: 이미지 허용, 검색 기간, 보안 설정 등
- 분석 단위 제공: 채널별 독립적인 통계 및 분석
채널 생성하기
접근 방법
새 채널을 생성하는 방법은 다음과 같습니다:
- 프로젝트 생성 직후: 프로젝트 완료 화면에서 Create Channel 버튼 클릭
- 추가 채널 생성: Settings > Channel List에서 Create Channel 버튼 클릭
Step 1: 채널 기본 정보
| 항목 | 설명 | 예시 |
|---|---|---|
| Name | 채널명 (필수) | 웹 피드백, 앱 리뷰, 고객센터 |
| Description | 채널 간단한 설명 (선택) | 웹사이트 사용자 의견 수집 |
| Maximum Feedback Search Period | 피드백 검색 가능한 최대 기간 (30/90/180/365일, 전체) | 90일 |
피드백 검색 가능한 최대 기간 설정 시 주의사항
- 영향 범위: 피드백 다운로드 기능에 직접적으로 영향을 줍니다
- 다운로드 동작: 설정된 검색 기간 내의 모든 피드백이 다운로드 대상이 됩니다
- 성능 테스트: 일일 피드백 수가 많은 경우, 다양한 기간으로 테스트하여 최적값을 찾는 것을 권장합니다
- 점진적 조정: 초기에는 짧은 기간으로 시작하여 필요에 따라 점진적으로 늘려가는 것이 안전합니다
완료 후: 정보를 입력한 후 Next 버튼을 클릭합니다.
Step 2: 필드 설정
채널에서 수집할 데이터 구조를 정의합니다. 이는 API 요청 구조와 피드백 테이블 구성에 직접적으로 영향을 줍니다.
기본 시스템 필드
모든 채널에 자동으로 포함되는 필드들:
| Key | Format | 속성 | 설명 |
|---|---|---|---|
id |
number | Read Only | 피드백 고유 ID |
createdAt |
date | Read Only | 피드백 생성 시각 |
updatedAt |
date | Read Only | 피드백 수정 시각 |
issues |
multiSelect | Editable | 연결된 이슈 목록 |
이 필드들은 삭제하거나 주요 속성을 수정할 수 없습니다.
커스텀 필드 추가
실제 비즈니스 요구사항에 맞는 필드를 추가합니다.
- Add Field 버튼을 클릭합니다
- 필드 정보를 입력합니다
| 항목 | 설명 | 예시 |
|---|---|---|
| Key | 고유 식별자 (영문 대/소문자, 숫자, _) |
message, rating |
| Display Name | UI에 표시될 이름 | 피드백 내용, 사용자 이메일 |
| Format | 데이터 형식 (아래 표 참고) | text, keyword, number |
| Property | Editable (입력 가능) / Read Only (조회만 가능) |
Editable |
| Status | Active / Inactive |
Active |
| Description | 팀원이 이해하기 쉬운 설명 (선택) | 사용자가 입력한 피드백 내용 |
필드 Format 종류
| Format | 설명 | 사용 예시 | API 예시 |
|---|---|---|---|
text |
자유 텍스트 입력 | 피드백 내용, 상세 설명 | "앱이 자꾸 멈춰요" |
keyword |
짧은 키워드/태그 | 버전 정보, 페이지명 | "v1.2.3" |
number |
숫자 | 평점, 나이, 사용 시간 | 5 |
date |
날짜 | 발생일, 만료일 | "2024-03-01T00:00:00Z" |
select |
단일 선택 | 카테고리, 우선순위 | "기능 요청" |
multiSelect |
다중 선택 | 태그, 관련 기능 | ["버그", "UI"] |
images |
이미지 URL 배열 | 스크린샷, 첨부 파일 | ["https://..."] |
aiField |
AI 분석 결과 필드 | 감정 분석, 요약, 키워드 추출 | "긍정" |
images 형식 관련: 자세한 이미지 설정 방법은 이미지 설정 문서를 참고하세요.
aiField 형식 관련: AI 필드 설정 및 템플릿 구성 방법은 AI 설정 문서를 참고하세요.
필드 구성 예시
웹 피드백 채널
| Key | Display Name | Format | 용도 |
|---|---|---|---|
message |
피드백 내용 | text | 사용자 의견 |
userEmail |
이메일 | keyword | 연락처 (선택) |
pageUrl |
페이지 URL | keyword | 피드백 발생 위치 |
category |
카테고리 | select | 버그/기능요청/개선사항 |
priority |
우선순위 | select | 높음/보통/낮음 |
screenshots |
스크린샷 | images | 문제 상황 캡처 |
모바일 앱 리뷰 채널
| Key | Display Name | Format | 용도 |
|---|---|---|---|
message |
리뷰 내용 | text | 사용자 리뷰 |
rating |
평점 | number | 1-5점 평가 |
appVersion |
앱 버전 | keyword | 버그 추적용 |
deviceType |
기기 타입 | select | iOS/Android |
crashLogs |
크래시 로그 | text | 기술적 오류 정보 |
필드 미리보기
필드 설정을 완료한 후 Preview 버튼으로 실제 피드백 입력 화면을 미리 확인할 수 있습니다.
이 미리보기는 API 요청 시 필요한 필드 구조와 동일합니다.
완료 후: Next 버튼으로 다음 단계로 진행합니다.
Step3. 채널 생성 완료
모든 단계를 완료하면 요약 화면이 나타납니다:
- 채널 정보: 이름, 설명, 시간대
- 필드 정보
필드 관리
필드 수정
기존 필드를 수정하려면 필드 목록에서 수정하려는 필드 행을 클릭하여 정보를 수정합니다.
주의:
Key와Format은 생성 후 수정할 수 없습니다. 데이터 일관성을 위해 제한됩니다.
필드 삭제
피드백 데이터의 무결성과 일관성을 보장하기 위해 필드 삭제 기능은 제공하지 않습니다.
삭제 대신 권장하는 방법
- Inactive 상태로 변경: 필드를 비활성화하여 새로운 피드백 수집에서 제외
- 데이터 보존: 기존에 수집된 피드백 데이터는 그대로 유지
- 필터링 활용: 필드 목록에서 Active 필드만 표시하여 관리 효율성 확보
완전 제거가 필요한 경우
필드를 완전히 제거해야 하는 상황에서는:
- 채널 전체를 삭제하고 새로 생성하는 방법을 고려
- 데이터 Export 후 새 구조로 마이그레이션
- 개발팀과 상의하여 데이터베이스 레벨에서 처리
필드 상태 관리
Active / Inactive 전환
- Active: 피드백 수집 시 사용되는 필드
- Inactive: 일시적으로 비활성화된 필드 (데이터는 보존)
필터링 옵션
상단 컨트롤로 다음 조건으로 필드를 필터링할 수 있습니다:
- Status:
Active/Inactive - Property:
Editable/Read Only
채널 정보 관리
채널 기본 정보 수정
생성된 채널의 기본 정보를 수정할 수 있습니다.
접근 방법
- Settings > Channel List > [채널 선택]
- Channel Information 탭 클릭
수정 가능한 항목
| 항목 | 수정 가능 여부 | 주의사항 |
|---|---|---|
| Channel ID | ❌ 불가능 | 시스템 내부 식별자 |
| Channel Name | ✅ 가능 | 팀원들에게 표시되는 이름 |
| Description | ✅ 가능 | 채널 목적 명시 |
| Maximum Feedback Search Period | ✅ 가능 | 성능에 영향을 줄 수 있음 |
채널 삭제
더 이상 사용하지 않는 채널을 삭제할 수 있습니다.
삭제 절차
- Channel Information 화면 하단의 Delete Channel 버튼 클릭
- 확인 팝업에서 채널 이름을 정확히 입력
- Delete 버튼으로 최종 확정
삭제 시 유의사항
- 해당 채널의 모든 피드백 데이터가 영구 삭제됩니다
- 되돌릴 수 없으므로 사전 백업 또는 Export를 권장합니다
- 관련된 API 키 설정도 함께 확인이 필요합니다