Skip to main content

개요

Upcart API 사용에 관해 가장 자주 묻는 질문에 대한 답변을 소개할게요.

Upcart API 스크립트는 어디에 추가하나요?

Upcart의 Custom HTML 설정이나 Shopify 테마 코드에 직접 스크립트를 추가할 수 있어요. 어떤 방식이 최선인지는 필요한 사용자 지정 수준에 따라 달라요.

Upcart의 Custom HTML은 어떻게 사용하나요?

  1. Upcart → Settings → Custom HTML로 이동하세요
  2. API 스크립트를 사용해 열림 타이밍이나 업셀 표시 같은 장바구니 동작을 수정하세요
  3. 상품 페이지 버튼 숨기기 등 Upcart 외부의 요소도 조정할 수 있어요

💡 예시: 장바구니가 비어 있을 때 고정 장바구니 버튼 숨기기

레거시 안내: window.upcartOnCartLoaded 콜백은 여전히 작동하지만 더 이상 사용되지 않으며 콘솔 경고를 출력해요. 새 스크립트에는 모두 upcartSubscribeCartLoaded를 사용하세요. event.cart에는 item_count 속성이 없다는 점에 유의하세요 — 총 상품 개수는 event.cart.items.reduce((total, item) => total + item.quantity, 0)로 계산하세요.

Upcart API를 사용하려면 개발자여야 하나요?

아니에요! Upcart API는 코딩 지식이 없어도 쉽게 사용할 수 있어요. 많은 기능이 기본으로 제공되고, 저희 사용자 지정 문서에는 Upcart의 Custom HTML 설정에 복사해 넣기만 하면 되는 미리 작성된 스크립트가 포함되어 있어요 — 코딩이 필요 없어요! 직접 스크립트를 작성하고 싶다면 기본적인 JavaScript 지식이 도움이 돼요. JavaScript가 처음이어도 걱정하지 마세요! W3SchoolsMDN Web Docs 같은 초보자 친화적인 자료로 시작할 수 있어요.

Upcart API를 다른 서드파티 앱과 연동할 수 있나요?

네! Upcart API는 번역, 분석, 업셀 등 다양한 앱과 함께 작동해요. 일부는 자동으로 연동되고, 일부는 간단한 스크립트가 필요할 수 있어요. 예를 들어 추적용으로 **TripleWhale**을 사용한다면, 장바구니 활동을 올바르게 기록하도록 다음 스크립트를 추가해야 해요:
레거시 안내: window.upcartOnAddToCart 콜백은 여전히 작동하지만 더 이상 사용되지 않으며 콘솔 경고를 출력해요. 새 스크립트에는 모두 upcartSubscribeAddedToCart를 사용하세요. 이벤트 속성은 별도의 매개변수가 아니라 event.item(variantIdquantityAdded 포함)에 있다는 점에 유의하세요.
앱마다 다르므로, 추가 코드가 필요한지 해당 앱의 지원팀에 문의하세요. Upcart는 서드파티 앱용 스크립트 지원을 제공하지 않지만, 앱 제공업체에 연동 가이드가 있을 수 있어요.

API 변경 사항이 잘 작동하는지 어떻게 테스트하나요?

Upcart의 Custom HTML 설정에 스크립트를 추가한 후, 다음 단계에 따라 잘 작동하는지 확인하세요:
  1. 스토어를 새로 고침하고 상품을 장바구니에 담아 보세요.
  2. 캐시를 삭제하고 다시 시도해 최신 변경 사항을 확인하세요.
  3. 테스트 메시지 추가: </script> 앞에 console.log("The script works!");를 삽입해 스크립트가 실행되는지 확인하세요.
  4. 브라우저 콘솔을 확인하세요:
    • 개발자 도구를 여세요(Windows에서는 F12 또는 Ctrl + Shift + J, Mac에서는 Cmd + Option + J).
    • Console 탭으로 이동해 **“The script works!”**를 찾으세요.
    • 메시지가 보이면 스크립트가 실행되고 있는 거예요! 보이지 않는다면 스크립트가 올바르게 실행되지 않는 것일 수 있어요.
  5. 다양한 동작을 테스트해(예: 상품 제거) 기대한 대로 작동하는지 확인하세요.
오타나 콘솔 오류를 확인하고 필요에 따라 코드를 조정하며 문제를 해결하세요.

API 스크립트가 작동하지 않으면 어떻게 해야 하나요?

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 문서를 공유해 도움을 받는 것을 고려해 보세요