Skip to main content

개요

이 설정은 두 가지 역할을 해요:
  1. Shopify Ajax 카트 호출을 큐에 넣어요. 여러 스크립트가 Shopify의 Ajax 카트 API(/cart/add, /cart/add.js, /cart/update.js, /cart/change.js)를 동시에 호출하면 Shopify가 변경 사항 중 하나를 누락시키는 경우가 있어요. Upcart는 해당 호출들이 한 번에 하나씩 실행되도록 강제하여 모든 업데이트가 반영되게 해요. 이것이 이 설정의 주요 목적이에요.
  2. Add to Cart에서 한 발 물러나요. Upcart의 내장 Add to Cart 처리도 비활성화하여, 해당 흐름을 완전히 제어해야 하는 앱이나 테마와 충돌하지 않도록 해요.
두 동작은 하나의 체크박스에 묶여 있어요 — Upcart의 Add to Cart 처리를 포기하지 않고 요청 큐잉만 활성화할 수는 없어요.

위치 안내

카트 편집기를 열고 Settings > Cart settings로 이동한 다음 Advanced Settings를 펼치세요.
**“Enhanced Ajax API compatibility”**를 찾으세요.

작동 방식

Upcart가 Add to Cart 프로세스를 완전히 제어해요. 이렇게 하면 일관된 동작이 보장되고 다른 앱이나 스크립트가 카트 흐름을 재정의하는 것을 Upcart가 방지할 수 있어요. 이것이 대부분의 스토어에 권장되는 설정이에요. Upcart가 테마나 다른 앱의 카트 추가 이벤트를 가로채지 못하는 특정 문제를 겪고 있는 경우가 아니라면 비활성화 상태로 유지하세요.

활성화

Upcart가 더 이상 Add to Cart 프로세스를 관리하지 않아요. 이렇게 하면 다른 앱, 커스텀 JavaScript, 테마가 간섭 없이 카트를 수정할 수 있어요. 다음 경우에만 이 설정을 활성화하세요:
  • 스토어가 비표준 AJAX 카트 API를 사용하는 경우
  • Upcart가 테마나 다른 앱의 카트 추가 이벤트를 가로채지 못하는 경우
  • 서드파티 앱이 카트 동작을 직접 제어해야 하는 경우
활성화 시 중요한 트레이드오프:
  • 다른 앱이 Upcart 드로어를 여는 대신 고객을 Shopify 카트 페이지로 리디렉션할 수 있어요
  • 리디렉션 루프나 예상치 못한 카트 동작이 발생할 수 있어요
  • Upcart가 외부 앱이 카트 동작을 변경하는 것을 방지할 수 없어요
활성화 후 리디렉션 루프가 발생하면:
  1. 이 설정을 비활성화하세요
  2. 대신 수동 Upcart API(upcartRegisterAddToCart)를 사용하세요
  3. 특정 앱의 연동 가이드를 참고하세요 (예: Replo)

테스트하기

이 설정을 변경한 후:
  1. Save를 클릭하세요
  2. 제품을 카트에 추가하며 테스트하세요
  3. Upcart 드로어가 올바르게 열리는지 확인하세요
  4. Shopify 카트 페이지로 리디렉션되지 않는지 확인하세요
활성화 후 문제가 발생하면 설정을 비활성화하고 대체 솔루션을 위해 지원팀에 문의하세요.