PDF 뷰어 설정(Viewer Configuration)
앱에서 4가지 뷰어 유형 중 하나를 선 택해, 고객에게 PDF가 어떻게 표시될지 설정할 수 있습니다.
어디에서 설정하나요?
PDF 상세 페이지의 Viewer Configuration 섹션에서 뷰어 유형을 설정합니다.
이 설정은 해당 PDF에 연결된 Theme App Extension에 적용됩니다(버튼 팝업과 임베디드 뷰어 모두).
매뉴얼 URL 블록은 앱 설정이 아니라 테마 블록 설정(스키마)에서 뷰어를 설정합니다. 매뉴얼 URL 블록 →
4가지 뷰어 유형
Custom Viewer (Full Featured)
PDF 보기 경험을 가장 강력하게 제어할 수 있는 옵션입니다.
기능(Features):
- 모든 내비게이션 컨트롤
- 검색 기능
- 확대/축소 도구 및 표시 옵션 커스터마이징
- 모바일 최적화
설정 옵션(Configuration options):
PDF Viewer Settings:
- Initial Page - 처음 표시할 페이지(1, 2, 3 등)
- Initial Zoom - 기본 줌 레벨(Auto Fit, Fit Width, Fit Page, 50%, 75%, 100%, 125%, 150%, 200%)
- Page Layout - 페이지 레이아웃(Single Page, Two Pages Odd, Two Pages Even)
- Scroll Direction - 스크롤 방향(Vertical, Horizontal, Wrapped, Page Scrolling)
Toolbar & Features:
- Enable Download - 고객의 PDF 다운로드 허용
- Show Toolbar - 내비게이션 툴바 표시
- Enable Add Image/Stamp Tool - 이미지/스탬프 추가 도구 사용
- Enable Highlighter Tool - 텍스트 하이라이트 기능 사용
- Enable Drawing Tools - PDF 위에 자유 그리기 도구 사용
- Enable Text Selection - 텍스트 선택/복사 허용
추천 사용 사례(Best for):
- 확대/축소와 검색이 필요한 기술 문서
- 내비게이션이 필요한 상품 매뉴얼
- 고객이 하이라이트/주석이 필요한 문서
- 데스크톱/모바일 모두에서의 열람
Light Viewer (Fast & Simple)
속도와 단순함에 최적화된 간단한 뷰어입니다.
기능(Features):
- 단순하고 빠르게 로딩되는 뷰어
- 최소 UI
- 빠른 미리보기에 적합
- 모바일 최적화
설정 옵션(Configuration options):
- 없음 — 별도 설정 없이 동작합니다.
추천 사용 사례(Best for):
- 빠르게 참고하는 문서(퀵 레퍼런스)
- 고급 기능이 필요 없는 단순 PDF
- 로딩 속도가 중요한 모바일 중심 스토어
- 보증서, 인증서, 간단한 서식(Form)
Native Browser Viewer (Standard)
브라우저 내장 PDF 뷰어를 사용해, 익숙하고 표준적인 경험을 제공합니다.
기능(Features):
- 브라우저 내장 PDF 보기 기능 사용
- 안정적이고 범용적으로 지원됨
- 추가 설정이 필요 없음
- 참고: 브라우저(Chrome/Safari/Firefox 등)에 따라 표시 경험이 달라질 수 있음
설정 옵션(Configuration options):
- 없음 — 브라우저 기본 설정을 사용합니다.
추천 사용 사례(Best for):
- 브라우저 기본 PDF 열람에 익숙한 고객 대상
- 커스텀 기능이 필요 없는 단순 문서
- 모든 브라우저에서 최대 호환성이 필요할 때
- 커스터마이징 없이 간단히 표시하고 싶을 때
중요: 브라우저 내장 PDF 뷰어를 사용하므로, 브라우저/기기별로 표시 경험이 다를 수 있습니다.
Flipbook Viewer (Interactive Pages)
실제 책을 넘기듯 페이지를 넘기는 인터랙티브(Flipbook) 경험을 제공합니다.
기능(Features):
- 페이지 넘김 애니메이션
- 책/잡지처럼 읽는 경험
- 시각 중심의 카탈로그형 콘텐츠에 적합
- 모바일 최적화가 되어 있지 않음
설정 옵션(Configuration options):
- Animation Style - 애니메이션 스타일(Smooth Animation, Fast Animation, No Animation)
- Page Shadows - 페이지 그림자/깊이 효과 표시
- Background Color - 배경색 선택(Light Gray, White, Off White, Medium Gray, Dark Gray)
추천 사용 사례(Best for):
- 카탈로그/브로셔
- 마케팅 자료/룩북
- 잡지 스타일 콘텐츠
- 데스크톱 열람 중심 경험
비추천(Not recommended for):
- 모바일 중심 스토어
- 기술 문서
- 텍스트 위주의 긴 PDF
연결(Linked) vs 매뉴얼(Manual) 뷰어 설정
| 구분 | 뷰어 설정 위치 | 적용 범위 |
|---|---|---|
연결(Linked) 블록 (pdf_embedded, pdf_button) | 앱의 PDF 상세 페이지 | PDF별 |
매뉴얼(Manual) 블록 (pdf_embedded_manual, pdf_button_manual) | 테마 블록 설정 | 블록별 |
매뉴얼 블록도 동일한 4가지 뷰어 유형을 지원합니다.
- Native Browser
- Custom Viewer
- Flipbook
- Light Viewer
매뉴얼 블록은 블록 단위 뷰어 설정 1개가 해당 블록의 모든 URL에 적용됩니다.
뷰어 설정 방법
- 앱에서 PDF 라이브러리로 이동합니다.
- 설정할 PDF를 클릭합니다.
- Viewer Configuration 섹션을 찾습니다.
- 섹션을 펼치기 위해 클릭합니다.
- 드롭다운에서 Viewer Type을 선택합니다.
- 해당 뷰어 유형에서 제공하는 옵션을 설정합니다.
- Save Configuration을 클릭합니다.
설정은 모든 곳에 적용됩니다
선택한 뷰어 설정은 다음에 모두 적용됩니다.
- ✅ 버튼 확장 팝업(고객이 버튼을 클릭할 때)
- ✅ 임베디드 뷰어(페이지 안에 PDF가 표시될 때)
- ✅ 이 PDF가 표시되는 모든 템플릿
- ✅ 이 PDF가 연결된 모든 리소스
한 번 설정하면 해당 PDF가 표시되는 모든 곳에서 동일하게 동작합니다.
매뉴얼 블록은 블록 설정에서 뷰어 옵션을 지정하며, 해당 블록의 모든 URL에 적용됩니다.
확장(Extension) 설정 vs 뷰어 설정
두 설정을 혼동하지 마세요.
| 뷰어 설정(Viewer Configuration, 앱) | 확장 설정(Extension settings, 테마 편집기) |
|---|---|
| Custom / Light / Native Browser / Flipbook | 버튼 색상, 텍스트, 정렬 |
| 줌, 툴바, 다운로드 옵션 | 뷰어 높이, 제목 텍스트 |
| 페이지 레이아웃, 스크롤 방향 | 컨테이너 테두리, 모달 크기 |
| PDF별로 1회 설정 | 확장(블록)별로 설정 |
| PDF 기능을 제어 | 스타일/레이아웃을 제어 |
매뉴얼 블록은 테마 설정에서 URL 목록 + 뷰어 유형 + 뷰어 옵션까지 함께 설정합니다.
예시:
- 다운로드를 허용하고 시작 줌을 100%로 설정한 Custom Viewer 선택 → 뷰어 설정(Viewer configuration)
- 버튼 색상을 파란색으로, 모달 크기를 80%로 설정 → 확장(Extension) 설정
뷰어 설정은 언제든 변경 가능
언제든 뷰어 유형을 바꿀 수 있습니다.
- PDF 상세 페이지를 엽니다.
- Viewer Configuration 섹션을 펼칩니다.
- 다른 뷰어 유형을 선택합니다.
- 설정을 조정합니다.
- Save Configuration을 클릭합니다.
변경 사항은 해당 PDF를 표시하는 모든 Theme App Extension에 즉시 적용됩니다.
뷰어 설정 팁
Custom Viewer부터 시작하기:
- 가장 범용적인 옵션
- 대부분의 사용 사례에 잘 맞음
- 설정 범위가 넓음
Light Viewer로 전환 추천:
- PDF 로딩이 느릴 때
- 가장 단순한 경험을 원할 때
- 모바일 속도가 특히 중요할 때
Native Browser Viewer 추천:
- 고객이 브라우저 기본 PDF 경험을 선호할 때
- 최대 호환성이 필요할 때
- 커스텀 기능이 필요 없을 때
Flipbook Viewer 추천:
- 데스크톱에서의 열람이 주 목적일 때
- 시각적 연출이 가장 중요할 때
- 카탈로그 스타일 콘텐츠일 때
선택 후 테스트:
- 데스크톱/모바일에서 모두 미리보기(Preview)로 확인
- 고객 피드백 수집
- PDF 참여도(열람/클릭) 모니터링