--- title: "설치: Spark! 문서 | Chargezen" description: "Shopify용 Spark! 단계별 설치 가이드. Chargezen Spark! 문서의 시작하기 섹션에 있어요." url: "https://chargezen.com/ko/docs/spark/getting-started/installation" lang: "ko" updated: "2026-01-19" --- Canonical URL: https://chargezen.com/ko/docs/spark/getting-started/installation # 설치 Shopify용 Spark! 단계별 설치 가이드 마지막 업데이트: 2026-01-19 이 가이드는 Shopify 스토어에 Spark!를 설치하는 방법을 안내해요. 약 5분이 걸리며 코딩 지식은 필요하지 않아요. 기존 Chargezen 사용자 Chargezen 앱이 이미 설치되어 있다면 대시보드에서 Spark!를 바로 사용할 수 있어요. Spark! 섹션으로 이동해 활성화하세요. ## 설치 단계 1 #### Shopify App Store에서 Chargezen 설치하기 2 #### 대시보드에서 Spark!로 이동하기 3 #### 스토어에서 Spark! 활성화하기 4 #### 추적 설치 확인하기 5 #### 포털 URL 설정하기 ## 설치 확인하기 Spark!가 올바르게 설치되었는지 확인하세요. * 시크릿 또는 비공개 브라우저 창에서 스토어 열기 * 개발자 도구 열기: F12 또는 마우스 오른쪽 클릭 → Inspect * Network 탭에서 “spark”로 필터링하기 * 페이지를 새로고침하고 spark.chargezen.com 요청 찾기 설치 진단 Spark! Settings → Installation → Run Diagnostics에서 내장 진단을 실행하세요. 추적 픽셀 설치, 쿠키 설정, API 연결을 확인해요. ## 맞춤 도메인 설정, 선택 사항 전문적인 제휴 포털을 위해 맞춤 도메인을 설정하세요. 1. `portal.chargezen.com`을 가리키는 CNAME 레코드 추가하기 2. Spark! Settings → Portal → Custom Domain에 맞춤 도메인 입력하기 3. SSL 인증서 준비 기다리기: 보통 5분 미만 ## 테마 연동 Spark!는 Shopify 테마와 자동 연동돼요. 고급 맞춤 설정은 다음과 같아요. * **제휴 링크 배지** — 장바구니나 체크아웃에 “Referred by \[Name\]” 표시 * **공유 위젯** — 페이지에 “Become an Affiliate” 버튼 추가 * **추천 추적** — 감사 페이지에 추천 기여도 표시 헤드리스·맞춤 스토어 헤드리스 스토어나 맞춤 체크아웃을 쓰나요? API 문서에서 수동 연동 방법을 확인하세요. [API 참조 보기 →](https://chargezen.com/ko/docs/spark/api/endpoints) ## 자주 발생하는 설치 문제 **추적 픽셀이 로드되지 않아요:** 광고 차단기나 개인정보 확장 프로그램이 스크립트를 막는지 확인하세요. Spark!는 차단 문제를 줄이기 위해 자사 추적을 사용해요. **포털에 404가 표시돼요:** Shopify 테마의 URL 설정에서 Spark! 포털 경로가 활성화되었는지 확인하세요. 일부 테마는 경로를 수동 설정해야 해요. **주문 기여도가 연결되지 않아요:** 브라우저 쿠키에서 `_spark_ref`를 찾아 추적 쿠키가 설정됐는지 확인하세요. 기본 유지 기간은 30일이에요. ## 다음 단계 [ ### 빠른 시작 가이드 첫 제휴 마케팅 프로그램 설정하기 자세히 보기 ](https://chargezen.com/ko/docs/spark/getting-started/quick-start)[ ### 프로그램 설정 커미션 비율과 승인 자동화 설정하기 자세히 보기 ](https://chargezen.com/ko/docs/spark/affiliate-management/program-setup) ### 관련 문서 [ #### 빠른 시작 첫 프로그램 설정하기 ](https://chargezen.com/ko/docs/spark/getting-started/quick-start)[ #### 프로그램 설정 제휴 프로그램 설정하기 ](https://chargezen.com/ko/docs/spark/affiliate-management/program-setup) 이 페이지가 도움이 되었나요? 도움이 더 필요하신가요? [고객 지원 문의](https://chargezen.com/ko/docs/checkoutos/troubleshooting/support)