피드백 통합 가이드

웹사이트에 피드백 위젯을 추가하여 방문자로부터 의견을 수집하는 방법을 알아보세요.

작동 방식

PrivateStater 피드백 위젯은 다음 기능을 제공합니다:

스크립트 설치

만약 이미 스크립트를 설치했다면 이 섹션을 건너뛰세요. 모든 기능은 하나의 통합된 privatestater.js 스크립트로 제공됩니다.

웹사이트의 <head> 섹션에 다음 스크립트를 추가하세요:

<script> window.PrivateStaterConfig = { prstSite: "YOUR_SITE_ID" }; </script>
<script src="https://privatestater.com/privatestater.js"></script>

YOUR_SITE_ID를 대시보드에서 생성한 웹사이트 ID로 교체하세요.

2단계: 대시보드에서 피드백 활성화

  1. 대시보드 > 웹사이트 > 피드백 > 설정으로 이동합니다
  2. 피드백 활성화를 켭니다
  3. 필요한 옵션을 설정합니다

설정 옵션

설정 설명 기본값
활성화 피드백 위젯 사용 여부 비활성화
로컬호스트 허용 localhost에서 테스트 허용 비활성화
텍스트 입력 텍스트 피드백 수집 여부 활성화
이모지 평가 이모지 평가 수집 여부 활성화
이메일 수집 이메일 필드 표시 여부 비활성화
위젯 위치 플로팅 버튼 위치 오른쪽 하단

위젯 위치 옵션

값 설명
bottom-right 화면 오른쪽 하단 (기본)
bottom-left 화면 왼쪽 하단

자동 위젯 표시

피드백을 활성화하면 웹사이트에 자동으로 플로팅 버튼이 나타납니다. 별도의 HTML 코드 추가가 필요 없습니다.

작동 흐름

  1. 방문자가 플로팅 버튼 클릭
  2. 피드백 팝업 표시
  3. 이모지 평가 선택 (설정 시)
  4. 카테고리 및 텍스트 입력 (선택)
  5. 스크린샷 첨부 (선택)
  6. 메타데이터 동의 선택 (선택)
  7. 이메일 입력 (설정 시)
  8. 제출

프로그래밍 방식 호출

자체 버튼이나 특정 이벤트에서 피드백 위젯을 열고 싶다면:

window.PrivateStater.showFeedback();

사용 예시

<!-- 커스텀 피드백 버튼 -->
<button onclick="window.PrivateStater.showFeedback()">
    의견 남기기
</button>

// 특정 조건에서 피드백 요청
if (userCompletedPurchase) {
    window.PrivateStater.showFeedback();
}

옵션

window.PrivateStater.showFeedback({
    onClose: function() {
        console.log('피드백 위젯이 닫혔습니다');
    }
});

수집되는 데이터

기본 수집 데이터

필드 설명 조건
평가 (rating) 이모지 평가 (1~4) 이모지 평가 활성화 시
텍스트 (text) 피드백 내용 (최대 2000자) 텍스트 입력 활성화 시
이메일 (email) 응답용 이메일 이메일 수집 활성화 시
카테고리 (category) 피드백 분류 항상
스크린샷 (screenshot) 화면 캡처 이미지 사용자가 첨부 시

카테고리

값 한국어 영어
issue 버그 신고 Bug
idea 기능 제안 Feature
other 일반 의견 General

이모지 평가

값 이모지 한국어 영어
1 😠 별로예요 Hate
2 😕 아쉬워요 Dislike
3 😊 좋아요 Like
4 😍 최고예요 Love

메타데이터 (사용자 동의 시)

사용자가 동의한 경우에만 다음 정보가 수집됩니다:

데이터 설명
브라우저 정보 Chrome, Firefox, Safari 등
기기 유형 Desktop, Mobile, Tablet
언어 브라우저 언어 설정
페이지 URL 피드백을 보낸 페이지 주소

메타데이터 동의는 피드백 제출 화면에서 체크박스로 선택할 수 있습니다.

대시보드에서 피드백 관리

피드백 목록

대시보드에서 수집된 피드백을 확인할 수 있습니다:

상태 관리

상태 설명
읽음 확인한 피드백
중요 중요 표시한 피드백

기능

통계

통계 설명
총 피드백 선택 기간 내 전체 피드백 수
평균 평점 이모지 평가 평균 (1~4)
미읽음 아직 확인하지 않은 피드백 수
중요 중요 표시된 피드백 수

스타일

피드백 위젯은 Shadow DOM으로 격리되어 있어 외부 CSS의 영향을 받지 않습니다. 위젯은 자동으로 다크 모드와 라이트 모드에 맞게 표시됩니다 (prefers-color-scheme 감지).

다국어 지원

피드백 위젯은 브라우저 언어에 따라 자동으로 한국어 또는 영어로 표시됩니다. 추가로 필요한 언어가 있다면 문의해 주시면 빠르게 추가해 드리겠습니다.

폼 데이터 임시 저장

사용자가 피드백 작성 중 위젯을 닫아도 입력한 내용이 임시 저장됩니다. 다시 열면 이전에 작성하던 내용이 복원됩니다.

프라이버시

문제 해결

위젯이 표시되지 않아요

  1. 대시보드에서 피드백이 활성화되어 있는지 확인하세요
  2. 스크립트가 올바르게 설치되었는지 확인하세요
  3. 브라우저 콘솔에서 에러를 확인하세요

localhost에서 작동하지 않아요

대시보드에서 로컬호스트 허용 옵션을 활성화하세요.

스크린샷 첨부가 안 돼요