개요
- Upcart API 스크립트는 어디에 추가하나요?
- Upcart API를 사용하려면 개발자여야 하나요?
- Upcart API를 다른 서드파티 앱과 연동할 수 있나요?
- API 변경 사항이 잘 작동하는지 어떻게 테스트하나요?
- API 스크립트가 작동하지 않으면 어떻게 해야 하나요?
- 문제를 일으키는 스크립트를 추가했다면 어떻게 되돌리나요?
Upcart API 스크립트는 어디에 추가하나요?
Upcart의 Custom HTML은 어떻게 사용하나요?
- Upcart → Settings → Custom HTML로 이동하세요
- API 스크립트를 사용해 열림 타이밍이나 업셀 표시 같은 장바구니 동작을 수정하세요
- 상품 페이지 버튼 숨기기 등 Upcart 외부의 요소도 조정할 수 있어요
레거시 안내:
window.upcartOnCartLoaded 콜백은 여전히 작동하지만 더 이상 사용되지 않으며 콘솔 경고를 출력해요. 새 스크립트에는 모두 upcartSubscribeCartLoaded를 사용하세요. event.cart에는 item_count 속성이 없다는 점에 유의하세요 — 총 상품 개수는 event.cart.items.reduce((total, item) => total + item.quantity, 0)로 계산하세요.Upcart API를 사용하려면 개발자여야 하나요?
Upcart API를 다른 서드파티 앱과 연동할 수 있나요?
레거시 안내:
window.upcartOnAddToCart 콜백은 여전히 작동하지만 더 이상 사용되지 않으며 콘솔 경고를 출력해요. 새 스크립트에는 모두 upcartSubscribeAddedToCart를 사용하세요. 이벤트 속성은 별도의 매개변수가 아니라 event.item(variantId와 quantityAdded 포함)에 있다는 점에 유의하세요.API 변경 사항이 잘 작동하는지 어떻게 테스트하나요?
- 스토어를 새로 고침하고 상품을 장바구니에 담아 보세요.
- 캐시를 삭제하고 다시 시도해 최신 변경 사항을 확인하세요.
-
테스트 메시지 추가:
</script>앞에console.log("The script works!");를 삽입해 스크립트가 실행되는지 확인하세요. -
브라우저 콘솔을 확인하세요:
- 개발자 도구를 여세요(Windows에서는
F12또는Ctrl + Shift + J, Mac에서는Cmd + Option + J). - Console 탭으로 이동해 **“The script works!”**를 찾으세요.
- 메시지가 보이면 스크립트가 실행되고 있는 거예요! 보이지 않는다면 스크립트가 올바르게 실행되지 않는 것일 수 있어요.
- 개발자 도구를 여세요(Windows에서는
- 다양한 동작을 테스트해(예: 상품 제거) 기대한 대로 작동하는지 확인하세요.
API 스크립트가 작동하지 않으면 어떻게 해야 하나요?
- 오타 확인 – 작은 오류 하나도 스크립트를 망가뜨릴 수 있어요. 누락된 문자나 잘못된 문법을 찾아보세요.
- 스크립트 위치 확인 – 스크립트가 Upcart → Settings → Custom HTML의 올바른 섹션에 있는지 확인하세요. Upcart에는 10개의 스크립트 섹션(HTML 삽입 지점 9개와 Scripts-before-load 섹션 1개)이 있어요 — 여기에서 섹션을 확인하세요.
- 브라우저 콘솔 확인 – 위 단계에 따라 오류를 찾아보세요.
- 다른 스크립트 테스트 – 미리 작성된 다른 Upcart API 스크립트를 시도해 문제가 내 코드에 있는지 확인하세요.
- 여전히 막혔나요? – Shopify 테마를 수정하거나 서드파티 앱을 연동하는 경우라면 Shopify Partner Directory의 Shopify 전문가가 도와드릴 수 있어요.
문제를 일으키는 스크립트를 추가했다면 어떻게 되돌리나요?
- 스크립트를 추가했던 Upcart의 Custom HTML 설정으로 이동하세요.
-
스크립트를 제거하거나 각 줄 시작에
//를 추가해 일시적으로 비활성화하세요(주석으로 바뀌어 실행되지 않아요). - 변경 사항을 저장하고 스토어를 새로 고침해 문제가 해결됐는지 확인하세요.
🚧 고급 사용자 지정이 필요하신가요? 스토어 전체 사용자 지정이나 서드파티 앱 연동이 필요하신가요? Shopify 테마에 Upcart API를 추가하려면 개발자가 필요할 수 있어요. **Shopify Partner Directory**를 통해 Shopify 전문가를 고용하고, 저희 API 문서를 공유해 도움을 받는 것을 고려해 보세요