HIKO Wish Keeper

두 가지가 필요합니다. 테마의 app embed를 켜는 것, 그리고 앱 설정에서 위시리스트를 켜는 것입니다.

1단계 — app embed 켜기

1. Shopify 관리자에서 HIKO Wish Keeper를 엽니다
2. 페이지 헤더의 '테마에서 활성화' 버튼을 클릭합니다 — 이 app embed가 선택된 상태로 테마 편집기가 열립니다
3. 토글이 켜짐인지 확인하고 테마 편집기에서 저장합니다

2단계 — 앱 설정에서 위시리스트 켜기

1. HIKO Wish Keeper의 설정 페이지로 돌아갑니다
2. 제품 페이지에서 '제품 페이지에서 위시리스트 사용'을 켭니다
3. 컬렉션 페이지에서 '제품 그리드에서 위시리스트 사용'을 켭니다
4. 저장을 클릭합니다

두 단계를 마치면 위시리스트 버튼이 스토어에 자동으로 나타납니다. 테마 코드를 수정할 필요는 없습니다.

"아무것도 안 보인다"의 가장 흔한 원인이 app embed입니다. 이 앱이 스토어에 그리는 모든 것 — 위시리스트 버튼, 계정 페이지, 공유 페이지 — 이 그 하나의 embed로 로드됩니다.

가능합니다. HIKO Wish Keeper의 설정에서 '로그인 필요'를 켜세요. 켜져 있는 동안 로그인하지 않은 방문자에게는 위시리스트가 아예 로드되지 않으며 버튼도 보이지 않습니다.

비회원도 저장할 수 있게 하려면 꺼두세요. 비회원의 목록은 본인 브라우저에 저장되고, 처음 로그인할 때 계정으로 합쳐지므로 저장한 것이 사라지지 않습니다.

인사이트 페이지에서 고객 행동을 이해하는 데 필요한 분석을 볼 수 있습니다.

• 위시리스트를 가진 모든 고객과 저장한 제품
• 스토어 전체에서 가장 많이 저장된 제품
• 알림 전달률, 열람률, 클릭률
• 플랫폼별 소셜 공유 활동(Facebook, Twitter, Pinterest, WhatsApp, LINE)
• 제품 조회 패턴과 인기 추이
• 주문 초안의 전환과 청구 상태
• 일간·주간 활동 비교
• 고객 이메일과 위시리스트 데이터를 CSV로 내보내기

계정 페이지는 이 앱이 고객을 위해 보관하는 모든 것을 한곳에 모은 스토어 페이지입니다. 주소는 /apps/hwl/account이며 탭으로 구성됩니다. 위시리스트, 그리고 로그인 후에는 주문·주소·프로필·알림 설정·주문 초안입니다.

기본적으로 켜져 있습니다. 계정 페이지 > 계정 페이지에서 끌 수 있지만, 꺼져 있는 동안에는 그 주소가 동작하지 않고 스토어에서 연결되는 링크도 사라집니다.

계정 페이지는 app embed가 그립니다. 위시리스트 버튼과 같은 것입니다. embed가 꺼져 있으면 고객은 페이지에 도착하지만 계정 대신 "아직 불러오는 중"이라는 짧은 안내를 보게 됩니다.

둘 다 지원하며, 따로 설정할 것은 없습니다. 앱은 스토어가 어느 버전을 쓰는지 묻지 않습니다.

이유는 계정 페이지가 어디에 있는지에 있습니다. 이 페이지는 스토어프론트에 있는 페이지(/apps/hwl/account)로, 테마가 직접 그립니다. Shopify가 호스팅하는 계정 영역 안의 페이지가 아닙니다. 로그인한 고객과 주문, 주소를 테마를 통해 읽어오며, 그 방식은 다른 템플릿과 완전히 같습니다. 이 값들은 두 버전에서 동일하게 동작합니다.

로그인도 양쪽 모두에서 작동합니다. 앱이 제공하는 로그인 링크는 /customer_authentication/login을 가리키고, Shopify가 스토어 버전에 맞는 로그인 화면으로 보낸 뒤 고객을 원래 있던 곳으로 되돌립니다.

한 가지 차이가 있는데, 이는 당사가 아니라 Shopify의 제약입니다. 새 고객 계정에서는 Shopify가 호스팅하는 계정 페이지에 테마 앱의 내용을 표시할 수 없어 위시리스트 진입점이 없습니다. 그래서 앱이 테마 헤더의 계정 아이콘을 계정 페이지로 보냅니다. 기존 고객 계정에서는 그 아이콘이 Shopify 자체 계정 페이지로 계속 이동하며(그쪽은 정상 동작합니다), 고객은 하트 아이콘이나 직접 추가한 링크로 계정 페이지에 들어옵니다.

계정 페이지 > 탭으로 가세요. 탭마다 스위치와 아이콘이 있고, 위아래 화살표로 순서를 바꿀 수 있습니다. 여러분이 정한 순서가 고객이 보는 순서입니다.

탭은 프로필, 주소, 위시리스트, 주문, 주문 초안, 알림 설정입니다. 주문 초안과 알림 설정은 유료 요금제가 필요하므로, 그 둘을 뺀 나머지는 기본적으로 켜져 있습니다.

알아둘 규칙이 두 가지 있습니다.

• 위시리스트를 제외한 모든 탭은 고객이 로그인해야 합니다. 로그인하지 않은 방문자에게는 무엇을 켜두든 위시리스트만 보입니다.
• 탭을 끄면 고객에게서 숨겨질 뿐 아무것도 삭제되지 않습니다. 다시 켜면 데이터는 그대로 있습니다.

모두 계정 페이지 안에 있고, 옆의 실시간 미리보기가 변경을 따라갑니다.

1. 디자인 — 네 가지 레이아웃 중 선택: 사이드바, 탭, 대시보드(타일), 아코디언
2. 색상 — 밝게, 어둡게, 따뜻하게, 자동(자동은 방문자의 시스템 설정을 따릅니다)
3. 브랜드 색상 — 버튼, 링크, 현재 탭에 사용됩니다. 어두운 색상 테마에서는 자동으로 밝아지므로 어두운 브랜드 색상이 사라지지 않습니다
4. 사용자 지정 CSS — 설정으로 다루지 못하는 부분용이며, 계정 페이지 안에만 적용됩니다

유료 요금제에서 가능합니다. 계정 페이지 > 탭에서 프로필을 펼치고 필드를 추가하세요. 텍스트, 직접 정한 선택지의 드롭다운, 날짜, 체크박스 중에서 고를 수 있습니다.

고객의 답변은 Shopify 고객의 메타필드로 저장되므로 Shopify Flow, 세그먼트, 테마에서 쓸 수 있습니다. 해당 페이지의 필드가 저장되는 위치 패널에 각 필드의 정확한 namespace와 key가 표시됩니다.

추가하기 전에 알아둘 것이 세 가지 있습니다.

• 필드 유형은 나중에 바꿀 수 없습니다. Shopify의 제약입니다. 처음부터 맞게 고르세요. 바꾸려면 새 필드를 추가해야 합니다.
• 필드를 제거해도 양식에서 빠질 뿐입니다. 고객이 이미 입력한 답변도 정의도 Shopify에 남습니다. 의도한 설계입니다 — 한 번의 실수 클릭으로 스토어 전체의 고객 데이터가 지워져서는 안 됩니다.
• 무료 요금제에서도 기존 필드의 편집과 제거는 됩니다. 추가만 안 됩니다.

스토어 헤더의 하트는 그 고객이 실제로 목록을 볼 수 있는 곳으로 데려갑니다.

• 로그인 전 — 단독 위시리스트 페이지
• 로그인 후, 위시리스트 탭이 켜져 있음 — 계정 페이지의 위시리스트 탭
• 로그인 후, 위시리스트 탭이 꺼져 있음 — 단독 위시리스트 페이지

위시리스트를 팝업이나 슬라이드로 열도록 설정했다면, 하트는 그 동작을 유지하고 어디로도 이동하지 않습니다.

계정 페이지 > 로그인 후에서 셋 중 하나를 고릅니다. 계정 페이지(기본값), 홈페이지, 또는 직접 지정한 페이지입니다.

직접 지정할 때는 /pages/members처럼 슬래시로 시작하는 경로를 입력하세요. 전체 URL은 거부됩니다 — 로그인 리디렉션은 자기 스토어 안의 경로만 받으며, 거부된 값은 조용히 계정 페이지로 되돌아갑니다.

이 설정은 테마 헤더의 계정 아이콘을 포함해 어느 입구로 로그인하든 적용됩니다.

HIKO Wish Keeper의 유료 요금제는 하나이며, 월간 또는 연간으로 결제합니다.

• 무료 — 위시리스트 전체 기능. 스토어가 보유할 수 있는 목록 수와 저장 개수에 제한이 없으며, 인사이트 분석과 소셜 공유도 포함됩니다
• Professional — 월 $6.99 또는 연 $62. 여기에 이메일 알림, API 접근, 주문 초안과 청구, 계정 페이지의 사용자 지정 프로필 필드가 더해집니다

유료 요금제에는 7일 무료 체험이 포함됩니다. 업그레이드 페이지에서 언제든 변경할 수 있습니다.

아니요. Shopify가 자동으로 일할 계산하여 현재 요금제의 미사용분을 새 요금제에 충당합니다. 차액만 결제하면 됩니다.

월간에서 연간으로 바꾸면 월간 주기의 남은 일수가 연간 요금에 충당됩니다. 예를 들어 월 중간에 바꾸면 쓰지 않은 반달치가 연간 요금에서 차감됩니다.

이 과정은 모두 Shopify 결제 시스템이 처리하므로 따로 할 일은 없습니다.

7일 체험이 끝나면 Shopify가 정기 결제 승인을 요청하는 이메일을 보냅니다. 자동으로 청구되지 않습니다 — Shopify는 명시적인 승인을 반드시 요구합니다.

승인하면 구독이 그대로 이어집니다. 2일 안에 승인하지 않으면 요금제가 무료로 내려가고, 다시 구독할 때까지 유료 기능을 쓸 수 없습니다.

나중에 업그레이드 페이지에서 다시 구독할 수 있습니다. 다운그레이드로 데이터가 사라지지는 않습니다 — 목록, 사용자 지정 필드, 설정 모두 그대로 있습니다.

버튼의 모습은 세세하게 조정할 수 있습니다. 모두 설정 페이지에서 합니다.

1. 설정 > 전역 스타일 에서 아이콘 모양, 색상, 크기 변경
2. 활성 색상(저장됨)과 비활성 색상을 각각 조정
3. 애니메이션 효과 설정: 펄스, 바운스, 없음
4. 아이콘 크기와 선 두께 조정
5. 실시간 미리보기로 바꾸면서 확인

가능합니다. 컬렉션 페이지와 제품 페이지에서 각각 지정할 수 있습니다.

1. 컬렉션 페이지: 위치(오른쪽 위, 왼쪽 위, 오른쪽 아래, 왼쪽 아래)와 여백
2. 제품 페이지: 표시 모드 — '이미지 오버레이' 또는 '표준 버튼'
3. 버튼 배치: 장바구니 담기 옆, 가격 아래, 또는 사용자 지정 위치
4. 버튼 스타일: '아이콘 + 텍스트' 또는 '아이콘만'

이 앱은 15개 언어의 번역을 기본 제공합니다: 영어, 번체 중국어, 간체 중국어, 일본어, 한국어, 독일어, 프랑스어, 스페인어, 이탈리아어, 포르투갈어, 러시아어, 베트남어, 태국어, 아랍어, 히브리어. 고객은 자기 브라우저에 맞는 언어를 보게 되며, 따로 할 일은 없습니다.

번역 페이지는 언어를 추가하는 곳이 아니라 표현을 바꾸는 곳입니다.

1. 내비게이션에서 번역 페이지로 갑니다
2. 드롭다운에서 기본 언어를 고릅니다
3. 다르게 쓰고 싶은 버튼 이름, 메시지, 목록 이름을 수정합니다
4. 저장합니다

사용자 지정 번역으로 어떤 언어든 추가할 수 있습니다.

1. 번역 페이지로 갑니다
2. '언어 추가'를 클릭합니다
3. 언어 코드를 입력합니다(한국어는 ko, 독일어는 de)
4. 모든 텍스트 항목을 번역합니다 — 버튼 이름, 토스트 메시지, 목록 이름, 모달 문구 등
5. 저장을 클릭합니다

고객 브라우저의 언어가 입력한 코드와 일치하면 여러분의 번역이 사용됩니다. 고객에게 보이는 모든 표현을 직접 정할 수 있습니다.

고객은 어떤 사용자 지정 목록이든 전용 링크로 친구나 가족에게 공유할 수 있습니다.

1. 위시리스트 페이지를 열고 사용자 지정 목록을 고릅니다
2. '공유' 버튼을 눌러 공유 링크를 복사합니다
3. 누구에게나 보낼 수 있습니다 — 받는 사람은 계정 없이도 볼 수 있습니다
4. 공유 페이지에는 제품 정보와 가격이 포함된 모든 항목이 표시됩니다

사용자 지정 목록에는 고유한 공유 토큰이 자동으로 붙습니다. 기본 '즐겨찾기'와 '나중에 보기'도 공유할 수 있습니다.

가능합니다. 공유 링크를 연 사람은 그 목록을 구독할 수 있습니다.

1. 친구가 보낸 공유 링크를 엽니다
2. '구독'을 눌러 자기 위시리스트 페이지에 추가합니다
3. 구독한 목록은 자기 목록과 나란히 표시됩니다
4. 목록 주인이 바꾼 내용은 구독자에게 자동으로 반영됩니다

고객은 저장한 제품을 소셜 플랫폼에 공유할 수 있습니다.

• Facebook — 이미지와 설명을 포함해 제품 공유
• Twitter / X — 제품 링크를 넣어 트윗
• Pinterest — 제품 이미지 핀
• WhatsApp — 메시지로 제품 링크 전송
• LINE — LINE으로 공유
• Email — 이메일로 제품 링크 전송
• 링크 복사 — 제품 URL을 클립보드로

설정 > 소셜 공유 에서 켭니다. 표시할 플랫폼을 고르고 공유 메시지 템플릿을 바꿀 수 있습니다.

위시리스트에 담긴 제품이 할인되면 고객에게 자동으로 알립니다.

1. 알림 > 설정 으로 갑니다
2. '가격 인하 알림'을 켭니다
3. 인하 기준을 정합니다(모든 인하, 비율, 금액)
4. 확인 일정을 정합니다(매시간, 매일 등)
5. 수신에 동의한 고객에게 자동으로 메일이 갑니다

재입고 알림은 제품이 품절에서 재고 있음으로 바뀔 때만 발송됩니다. 앱이 제품의 재고 상태를 처음 기록할 때는 의도적으로 보내지 않습니다 — 그렇지 않으면 설치한 날 모든 고객에게 알림이 갑니다.

알림을 보내려면 이메일 제공업체를 설정해야 합니다.

1. 알림 > 설정 으로 갑니다
2. 제공업체를 고릅니다: Resend, SendGrid, Brevo, 또는 사용자 지정 SMTP
3. API 키와 발신자 정보를 입력합니다
4. '테스트 메일 보내기'로 설정을 확인합니다
5. 보낼 알림 유형을 켭니다
6. 자동 확인 일정을 설정합니다

가장 간단한 것은 Resend입니다. resend.com에서 무료 API 키를 받을 수 있습니다.

가능합니다. 스토어에 어울리는 메일을 만들 수 있습니다.

1. 알림 > 템플릿 으로 갑니다
2. 알림 유형을 고릅니다(가격 인하, 재입고 등)
3. 템플릿 언어를 고릅니다
4. 메일 제목을 수정합니다
5. HTML 본문을 브랜드에 맞게 편집합니다
6. HTML을 지원하지 않는 메일 앱을 위해 일반 텍스트 버전도 넣습니다
7. {{product_title}}, {{new_price}}, {{product_url}} 같은 변수로 동적 내용을 넣습니다
8. 저장 전에 미리 봅니다

AI 지원 기능으로 잘 정돈된 템플릿을 빠르게 만들 수 있습니다.

주문 초안은 고객이 저장한 제품으로 여러분이 대신 주문을 만드는 기능입니다. 유료 요금제 기능입니다.

• 고객의 저장 항목에서 바로 주문 초안 생성
• 청구서를 보내 고객이 결제를 마치도록 안내
• 상태 추적: 초안, 발송됨, 열람, 클릭, 완료
• 언제든 주문 초안 취소 또는 삭제
• 주문 초안 페이지에서 모든 초안과 상태 확인

계정 페이지의 주문 초안 탭입니다. 계정 페이지 > 탭에서 켜세요 — 유료 요금제가 필요하므로 기본값은 꺼짐입니다.

고객에게는 아직 결제하지 않은 청구서가 모두 보이고, 결제 링크와 취소 버튼이 함께 표시됩니다. 보낸 청구 메일도 그곳으로 바로 연결됩니다.

이전 버전에서는 테마 편집기에서 손으로 추가하는 테마 블록을 제공했습니다. 그것들은 제거되었습니다 — 계정 페이지의 탭이 대신하므로 테마에 추가할 것이 없습니다.

HIKO Wish Keeper의 주문 초안 페이지에서 만듭니다.

1. 주문 초안 페이지에서 고객을 찾거나 검색합니다
2. 고객을 클릭해 저장한 제품을 봅니다
3. 체크박스로 포함할 항목을 고릅니다
4. '주문 초안 만들기 (N)'를 클릭합니다(N은 선택 개수)
5. 모달에서 할인(비율 또는 정액), 재고 확보 기간, 주문 메모를 선택적으로 설정합니다
6. '만들기'를 눌러 가격 내역이 포함된 주문 요약을 확인합니다
7. '확인'으로 초안을 만들거나, '확인 후 발송'으로 만들면서 청구서를 바로 보냅니다

고객에게는 결제 링크가 담긴 메일이 갑니다. 모든 상태(초안, 발송됨, 열람, 클릭, 완료)는 주문 초안 페이지에서 추적할 수 있습니다.

주문 초안에는 Professional 요금제(월 $6.99 또는 연 $62)가 필요합니다.

버튼이 안 보이면 차례대로 확인하세요.

• 설정 > 제품 페이지 또는 컬렉션 페이지 에서 기능이 켜져 있는지
• 테마 편집기의 App embeds에서 이 앱의 embed가 켜져 있는지
• 설정의 '로그인 필요'가 켜져 있지 않은지 — 켜져 있으면 로그인하지 않은 방문자에게는 위시리스트가 로드되지 않습니다
• 브라우저 캐시를 비우고 새로고침
• 테마가 app block을 지원하는지(Online Store 2.0 테마)
• 시크릿 창에서 확인
• 그래도 안 되면 지원에 문의

계정 페이지는 app embed가 그립니다. "아직 불러오는 중"이라는 안내가 보이면 embed가 꺼져 있는 것입니다.

1. 앱 페이지 헤더의 '테마에서 활성화'를 클릭합니다
2. 토글이 켜짐인지 확인하고 테마 편집기에서 저장합니다

그 주소가 "찾을 수 없음"을 반환한다면 계정 페이지 자체가 꺼진 것입니다 — 계정 페이지 > 계정 페이지에서 다시 켜세요.

메일이 도착하지 않으면 흔한 원인을 확인하세요.

• 알림 > 설정 의 제공업체 API 키가 정확한지
• 발신 주소가 제공업체에서 인증되었는지
• 고객이 알림 수신에 동의했는지
• 인사이트 > 알림 탭의 발송 기록에 오류가 없는지
• 테스트 메일을 보내 설정이 동작하는지 확인
• 제공업체 관리 화면에서 반송이나 전달 문제 확인

기꺼이 도와드립니다.

• 기술적인 문제는 [email protected] 으로
• 앱 안의 지원 버튼으로 바로 메시지
• 자주 묻는 질문은 이 FAQ에서 확인

Authorization 헤더에 Bearer 토큰으로 API 키를 넣으세요: Authorization: Bearer your_api_key. 키는 API 연동 페이지에서 발급합니다.

숫자 ID(예: 1234567890)와 전체 Shopify GID(예: gid://shopify/Customer/1234567890) 모두 됩니다. 모든 엔드포인트가 두 형식을 받습니다.

표준 HTTP 상태 코드를 사용합니다.

• 200 - 성공: 요청이 정상 처리되었습니다
• 400 - 잘못된 요청: 매개변수가 유효하지 않거나 필수 항목이 없습니다
• 401 - 인증 실패: API 키가 없거나 유효하지 않습니다
• 404 - 찾을 수 없음: 리소스가 존재하지 않습니다
• 429 - 요청 과다: 속도 제한을 초과했습니다
• 500 - 서버 오류: 저희 쪽에서 문제가 발생했습니다

목록 엔드포인트는 page와 limit 쿼리 매개변수를 받습니다. 응답의 pagination 객체에 현재 페이지, 전체 페이지 수, 전체 건수가 들어 있어 많은 결과도 차례로 훑을 수 있습니다.

가능합니다. API 연동 페이지에서 webhook URL을 설정하면 위시리스트 이벤트가 생길 때 앱이 그곳으로 POST합니다. 폴링할 필요가 없습니다.