본문으로 건너뛰기

채널

채널(Channel) 은 피드백을 수집하는 경로 또는 목적에 따라 구분되는 단위입니다. 각 채널은 독립된 필드 구조, 이미지 설정, AI 기능을 가져 다양한 피드백 수집 시나리오에 맞게 설정할 수 있습니다.

채널 개요​

채널의 역할​

채널은 다음 역할을 합니다:

  • 피드백 수집 경로 구분: 웹, 앱, 고객센터, 설문조사 등
  • 데이터 구조 정의: 채널별 고유한 필드 설정
  • 수집 정책 관리: 이미지 허용, 검색 기간, 보안 설정 등
  • 분석 단위 제공: 채널별 독립적인 통계 및 분석

채널 생성하기​

접근 방법​

새 채널을 생성하는 방법은 다음과 같습니다:

  1. 프로젝트 생성 직후: 프로젝트 완료 화면에서 Create Channel 버튼 클릭
  2. 추가 채널 생성: Settings > Channel List에서 Create Channel 버튼 클릭

Step 1: 채널 기본 정보​

channel-create-1

항목설명예시
Name채널명 (필수)웹 피드백, 앱 리뷰, 고객센터
Description채널 간단한 설명 (선택)웹사이트 사용자 의견 수집
Maximum Feedback Search Period피드백 검색 가능한 최대 기간 (30/90/180/365일, 전체)90일

피드백 검색 가능한 최대 기간 설정 시 주의사항​

  • 영향 범위: 피드백 다운로드 기능에 직접적으로 영향을 줍니다
  • 다운로드 동작: 설정된 검색 기간 내의 모든 피드백이 다운로드 대상이 됩니다
  • 성능 테스트: 일일 피드백 수가 많은 경우, 다양한 기간으로 테스트하여 최적값을 찾는 것을 권장합니다
  • 점진적 조정: 초기에는 짧은 기간으로 시작하여 필요에 따라 점진적으로 늘려가는 것이 안전합니다

완료 후: 정보를 입력한 후 Next 버튼을 클릭합니다.

Step 2: 필드 설정​

channel-create-2

채널에서 수집할 데이터 구조를 정의합니다. 이는 API 요청 구조와 피드백 테이블 구성에 직접적으로 영향을 줍니다.

기본 시스템 필드​

모든 채널에 자동으로 포함되는 필드들:

KeyFormat속성설명
idnumberRead Only피드백 고유 ID
createdAtdateRead Only피드백 생성 시각
updatedAtdateRead Only피드백 수정 시각
issuesmultiSelectEditable연결된 이슈 목록

이 필드들은 삭제하거나 주요 속성을 수정할 수 없습니다.

커스텀 필드 추가​

실제 비즈니스 요구사항에 맞는 필드를 추가합니다.

  1. Add Field 버튼을 클릭합니다
  2. 필드 정보를 입력합니다
항목설명예시
Key고유 식별자 (영문 대/소문자, 숫자, _)message, rating
Display NameUI에 표시될 이름피드백 내용, 사용자 이메일
Format데이터 형식 (아래 표 참고)text, keyword, number
PropertyEditable (입력 가능) / Read Only (조회만 가능)Editable
StatusActive / InactiveActive
Description팀원이 이해하기 쉬운 설명 (선택)사용자가 입력한 피드백 내용

필드 Format 종류​

Format설명사용 예시API 예시
text자유 텍스트 입력피드백 내용, 상세 설명"앱이 자꾸 멈춰요"
keyword짧은 키워드/태그버전 정보, 페이지명"v1.2.3"
number숫자평점, 나이, 사용 시간5
date날짜발생일, 만료일"2024-03-01T00:00:00Z"
select단일 선택카테고리, 우선순위"기능 요청"
multiSelect다중 선택태그, 관련 기능["버그", "UI"]
images이미지 URL 배열스크린샷, 첨부 파일["https://..."]
aiFieldAI 분석 결과 필드감정 분석, 요약, 키워드 추출"긍정"

images 형식 관련: 자세한 이미지 설정 방법은 이미지 설정 문서를 참고하세요.

aiField 형식 관련: AI 필드 설정 및 템플릿 구성 방법은 AI 설정 문서를 참고하세요.

필드 구성 예시​

웹 피드백 채널​

KeyDisplay NameFormat용도
message피드백 내용text사용자 의견
userEmail이메일keyword연락처 (선택)
pageUrl페이지 URLkeyword피드백 발생 위치
category카테고리select버그/기능요청/개선사항
priority우선순위select높음/보통/낮음
screenshots스크린샷images문제 상황 캡처

모바일 앱 리뷰 채널​

KeyDisplay NameFormat용도
message리뷰 내용text사용자 리뷰
rating평점number1-5점 평가
appVersion앱 버전keyword버그 추적용
deviceType기기 타입selectiOS/Android
crashLogs크래시 로그text기술적 오류 정보

필드 미리보기​

필드 설정을 완료한 후 Preview 버튼으로 실제 피드백 입력 화면을 미리 확인할 수 있습니다.

이 미리보기는 API 요청 시 필요한 필드 구조와 동일합니다.

완료 후: Next 버튼으로 다음 단계로 진행합니다.

Step3. 채널 생성 완료​

create-channel-3

모든 단계를 완료하면 요약 화면이 나타납니다:

  • 채널 정보: 이름, 설명, 시간대
  • 필드 정보

필드 관리​

field-management.png

필드 수정​

기존 필드를 수정하려면 필드 목록에서 수정하려는 필드 행을 클릭하여 정보를 수정합니다.

주의: Key와 Format은 생성 후 수정할 수 없습니다. 데이터 일관성을 위해 제한됩니다.

필드 삭제​

피드백 데이터의 무결성과 일관성을 보장하기 위해 필드 삭제 기능은 제공하지 않습니다.

삭제 대신 권장하는 방법​

  1. Inactive 상태로 변경: 필드를 비활성화하여 새로운 피드백 수집에서 제외
  2. 데이터 보존: 기존에 수집된 피드백 데이터는 그대로 유지
  3. 필터링 활용: 필드 목록에서 Active 필드만 표시하여 관리 효율성 확보

완전 제거가 필요한 경우​

필드를 완전히 제거해야 하는 상황에서는:

  • 채널 전체를 삭제하고 새로 생성하는 방법을 고려
  • 데이터 Export 후 새 구조로 마이그레이션
  • 개발팀과 상의하여 데이터베이스 레벨에서 처리

필드 상태 관리​

Active / Inactive 전환​

  • Active: 피드백 수집 시 사용되는 필드
  • Inactive: 일시적으로 비활성화된 필드 (데이터는 보존)

필터링 옵션​

상단 컨트롤로 다음 조건으로 필드를 필터링할 수 있습니다:

  • Status: Active / Inactive
  • Property: Editable / Read Only

채널 정보 관리​

channel-setting

채널 기본 정보 수정​

생성된 채널의 기본 정보를 수정할 수 있습니다.

접근 방법​

  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 키 설정도 함께 확인이 필요합니다

관련 문서​