Guide

제품 가이드

Extension과 SDK 중 어떤 방식으로 시작할지 먼저 정합니다.

Reader

처음 도입 경로를 고르는 팀

Outcome

Extension과 SDK 중 시작 경로를 정합니다.

다음 단계

이 문서 다음에 이어서 볼 가이드입니다.

시작 준비 단계로 이동

한 줄 요약

이슈스티커는 두 가지 방식으로 사용할 수 있습니다. 포인트는 “누가 이슈를 남기는가”입니다.

  • 내부 QA, PM, 개발자가 직접 검수한다면 Extension이 편리합니다.
  • 실제 고객이나 베타 테스터에게서 이슈를 수집한다면 SDK를 씁니다.
    • 피드백 도구가 제품과 별개로 존재해도 되면 SDK Widget
    • 제품에 통합된 기능처럼 보여야 하면 SDK Headless

이 문서가 필요한 경우

  • 이슈스티커가 처음이라 어떻게 시작해야 하는지 모르는 경우
  • Extension과 SDK의 차이를 알아보고 적절한 방법을 선택하고 싶은 경우

Chrome Extension

Extension은 브라우저에 설치해서 사용하는 방식으로, 다음과 같은 경우에 더 편리합니다.

  • 프로젝트 코드에 대한 권한이 없는 경우(예: QA팀과 제품 팀이 분리된 경우, 타사 서비스에 대한 의견을 공유하고 싶은 경우 등)
  • 여러 프로젝트를 오가며 검수하는 팀
  • 스테이징과 운영 환경을 번갈아 보는 QA 작업
  • 다중 탭/창 이슈 등 브라우저 레벨에서 환경 정보를 수집하고 이슈를 파악해야 하는 경우

Extension 시작하기

SDK Widget

SDK Widget은 서비스 코드에서 이슈스티커 모듈을 초기화해 기본 위젯 UI를 그대로 띄우는 방식입니다. 피드백 도구가 제품과 별개로 얹혀 있다는 인상이 남아도 괜찮거나, 오히려 그 편이 자연스러운 경우에 맞습니다.

  • 실제 고객, 베타 테스터 등 외부에서 이슈를 수집하는 경우
    • 이슈를 남기는 사람에게 Extension 설치를 요구하기 어려움
    • 로그인 과정 없이 이슈를 수집할 수 있어야 함
  • 외주로 만든 제품을 검수하는 경우처럼, 피드백 도구가 제품과 분리된 채로 있어야 하는 경우
  • 위젯 UI를 그대로 쓰고 빠르게 통합하는 것이 우선인 경우

SDK 시작하기

SDK Headless

SDK Headless는 기본 위젯 UI 대신 화면을 직접 만들어 붙이는 방식입니다. 이슈 생성에 필요한 동작만 메서드로 제공하므로, 피드백을 외부 도구가 아니라 제품의 기능으로 보이게 만들 수 있습니다.

  • 실제 고객, 베타 테스터 등 외부에서 이슈를 수집하는 경우
    • 이슈를 남기는 사람에게 Extension 설치를 요구하기 어려움
    • 로그인 과정 없이 이슈를 수집할 수 있어야 함
  • 실제 제품의 고객에게 피드백을 받는 창구라, 브랜드 가이드에 맞춰 제품 기능으로 통합하고 싶은 경우
  • 원하는 시점에 사용자 입력 없이 자동으로 이슈를 생성하도록 제어하고 싶은 경우
    • 앱 레벨 에러 바운더리에 에러가 전파된 시점, 특정 에러 코드를 감지한 시점 등

SDK Headless 시작하기

끝나면 확인할 것

  • 검증 주체가 내부 팀인지, 제품 사용자까지 포함하는지 정했습니다.
  • Extension, SDK Widget, SDK Headless 중 첫 연결 경로를 하나 골랐습니다.

다음 단계

이슈스티커를 사용하기 위해서는 워크스페이스와 프로젝트를 생성해야 합니다. 다음 단계에서 기본 설정 방법을 확인해주세요.

시작 준비 단계로 이동

Ready

설정이 끝나면 실제 프로젝트에서 확인하세요

무료 플랜에서도 Extension, SDK, 외부 연동을 실제 프로젝트에 연결해 볼 수 있습니다.

제품 가이드 — 이슈스티커 Guide