--- title: 채널 description: ABC User Feedback에서 피드백 수집 채널을 생성, 설정, 관리하고 커스텀 필드 및 이미지 설정을 다루는 방법을 설명합니다. sidebar_position: 3 --- # 채널 **채널(Channel)** 은 피드백을 수집하는 경로 또는 목적에 따라 구분되는 단위입니다. 각 채널은 독립된 필드 구조, 이미지 설정, AI 기능을 가져 다양한 피드백 수집 시나리오에 맞게 설정할 수 있습니다. --- ## 채널 개요 ### 채널의 역할 채널은 다음 역할을 합니다: - **피드백 수집 경로 구분**: 웹, 앱, 고객센터, 설문조사 등 - **데이터 구조 정의**: 채널별 고유한 필드 설정 - **수집 정책 관리**: 이미지 허용, 검색 기간, 보안 설정 등 - **분석 단위 제공**: 채널별 독립적인 통계 및 분석 --- ## 채널 생성하기 ### 접근 방법 새 채널을 생성하는 방법은 다음과 같습니다: 1. **프로젝트 생성 직후**: 프로젝트 완료 화면에서 **Create Channel** 버튼 클릭 2. **추가 채널 생성**: **Settings > Channel List**에서 **Create Channel** 버튼 클릭 ### Step 1: 채널 기본 정보 ![channel-create-1](/img/channel/1.png) | 항목 | 설명 | 예시 | | ---------------------------------- | ---------------------------------------------------- | ---------------------------------- | | **Name** | 채널명 (필수) | `웹 피드백`, `앱 리뷰`, `고객센터` | | **Description** | 채널 간단한 설명 (선택) | `웹사이트 사용자 의견 수집` | | **Maximum Feedback Search Period** | 피드백 검색 가능한 최대 기간 (30/90/180/365일, 전체) | `90일` | #### 피드백 검색 가능한 최대 기간 설정 시 주의사항 - **영향 범위**: 피드백 다운로드 기능에 직접적으로 영향을 줍니다 - **다운로드 동작**: 설정된 검색 기간 내의 모든 피드백이 다운로드 대상이 됩니다 - **성능 테스트**: 일일 피드백 수가 많은 경우, 다양한 기간으로 테스트하여 최적값을 찾는 것을 권장합니다 - **점진적 조정**: 초기에는 짧은 기간으로 시작하여 필요에 따라 점진적으로 늘려가는 것이 안전합니다 **완료 후**: 정보를 입력한 후 **Next** 버튼을 클릭합니다. ### Step 2: 필드 설정 ![channel-create-2](/img/channel/2.png) 채널에서 수집할 데이터 구조를 정의합니다. 이는 API 요청 구조와 피드백 테이블 구성에 직접적으로 영향을 줍니다. #### 기본 시스템 필드 모든 채널에 자동으로 포함되는 필드들: | Key | Format | 속성 | 설명 | | ----------- | ----------- | --------- | ---------------- | | `id` | number | Read Only | 피드백 고유 ID | | `createdAt` | date | Read Only | 피드백 생성 시각 | | `updatedAt` | date | Read Only | 피드백 수정 시각 | | `issues` | multiSelect | Editable | 연결된 이슈 목록 | > 이 필드들은 삭제하거나 주요 속성을 수정할 수 없습니다. #### 커스텀 필드 추가 실제 비즈니스 요구사항에 맞는 필드를 추가합니다. 1. **Add Field** 버튼을 클릭합니다 2. 필드 정보를 입력합니다 | 항목 | 설명 | 예시 | | ---------------- | -------------------------------------------------- | ------------------------------ | | **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 형식 관련**: 자세한 이미지 설정 방법은 [이미지 설정](/docs/01-user-guide/07-settings/06-image-setting.md) 문서를 참고하세요. > > **aiField 형식 관련**: AI 필드 설정 및 템플릿 구성 방법은 [AI 설정](/docs/01-user-guide/07-settings/05-ai-setting.md) 문서를 참고하세요. ### 필드 구성 예시 #### 웹 피드백 채널 | 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. 채널 생성 완료 ![create-channel-3](/img/channel/3.png) 모든 단계를 완료하면 **요약 화면**이 나타납니다: - 채널 정보: 이름, 설명, 시간대 - 필드 정보 --- ## 필드 관리 ![field-management.png](/img/channel/field-management.png) ### 필드 수정 기존 필드를 수정하려면 필드 목록에서 수정하려는 필드 행을 클릭하여 정보를 수정합니다. > **주의**: `Key`와 `Format`은 생성 후 수정할 수 없습니다. 데이터 일관성을 위해 제한됩니다. ### 필드 삭제 피드백 데이터의 무결성과 일관성을 보장하기 위해 **필드 삭제 기능은 제공하지 않습니다**. #### 삭제 대신 권장하는 방법 1. **Inactive 상태로 변경**: 필드를 비활성화하여 새로운 피드백 수집에서 제외 2. **데이터 보존**: 기존에 수집된 피드백 데이터는 그대로 유지 3. **필터링 활용**: 필드 목록에서 Active 필드만 표시하여 관리 효율성 확보 #### 완전 제거가 필요한 경우 필드를 완전히 제거해야 하는 상황에서는: - 채널 전체를 삭제하고 새로 생성하는 방법을 고려 - 데이터 Export 후 새 구조로 마이그레이션 - 개발팀과 상의하여 데이터베이스 레벨에서 처리 ### 필드 상태 관리 #### Active / Inactive 전환 - **Active**: 피드백 수집 시 사용되는 필드 - **Inactive**: 일시적으로 비활성화된 필드 (데이터는 보존) #### 필터링 옵션 상단 컨트롤로 다음 조건으로 필드를 필터링할 수 있습니다: - **Status**: `Active` / `Inactive` - **Property**: `Editable` / `Read Only` --- ## 채널 정보 관리 ![channel-setting](/img/channel/channel-setting.png) ### 채널 기본 정보 수정 생성된 채널의 기본 정보를 수정할 수 있습니다. #### 접근 방법 1. **Settings > Channel List > [채널 선택]** 2. **Channel Information** 탭 클릭 #### 수정 가능한 항목 | 항목 | 수정 가능 여부 | 주의사항 | | ---------------------------------- | -------------- | ------------------------ | | **Channel ID** | ❌ 불가능 | 시스템 내부 식별자 | | **Channel Name** | ✅ 가능 | 팀원들에게 표시되는 이름 | | **Description** | ✅ 가능 | 채널 목적 명시 | | **Maximum Feedback Search Period** | ✅ 가능 | 성능에 영향을 줄 수 있음 | ### 채널 삭제 더 이상 사용하지 않는 채널을 삭제할 수 있습니다. #### 삭제 절차 1. Channel Information 화면 하단의 **Delete Channel** 버튼 클릭 2. 확인 팝업에서 채널 이름을 정확히 입력 3. **Delete** 버튼으로 최종 확정 #### 삭제 시 유의사항 - 해당 채널의 **모든 피드백 데이터가 영구 삭제**됩니다 - **되돌릴 수 없으므로** 사전 백업 또는 Export를 권장합니다 - 관련된 API 키 설정도 함께 확인이 필요합니다 --- ## 관련 문서 - [프로젝트 관리](./02-project-management.md) - 프로젝트 설정 및 권한 관리 - [피드백 관리](./04-feedback-management.md) - 수집된 피드백 분석 및 활용 - [API 연동](/docs/02-developer-guide/02-api-integration.md) - 외부 시스템과의 연동 방법 - [AI 연동](/docs/01-user-guide/07-settings/05-ai-setting.md) - AI 기능 설정