Skip to main content
이 문서는 Upcart와의 앱 호환성 문제를 해결하는 방법과 최적의 성능을 위한 모범 사례를 안내해요.

​
개요

Upcart는 대부분의 Shopify 앱과 원활하게 통합되도록 설계되었어요. 하지만 일부 서드파티 앱은 Shopify의 카트, 체크아웃, 가격 책정 또는 통화 로직을 수정하는 방식에 따라 기능 문제를 일으킬 수 있어요.
​ Upcart는 카트 드로어 오버레이로 작동하며, Shopify의 기본 카트나 체크아웃을 완전히 대체하지 않고 쇼핑 카트 경험을 향상시켜요.
​ Shopify의 카트 동작을 재정의하거나, Add to Cart 액션을 가로채거나, Shopify의 기본 가격 책정 또는 통화 시스템을 대체하는 앱은 Upcart와 충돌할 수 있어요. 가능한 한 Shopify의 기본 기능(통화 변환에는 Shopify Markets 등)을 사용하시길 권장해요. Shopify의 기본 카트 구조를 크게 변경하는 서드파티 앱에 대해서는 저희 팀의 지원 범위가 제한적이에요. 앱이 Shopify App Store에 있더라도 여전히 서드파티 앱으로 분류될 수 있으며, Upcart와 함께 사용할 때 특정 제한이 있을 수 있어요.

​
호환되지 않는 앱

다음 앱들은 Upcart와 지속적으로 문제를 일으키는 것으로 확인되어 지원되지 않아요: BUCKS (통화 변환 앱)
Upcart는 서드파티 통화 변환 앱과 호환되지 않아요. Upcart는 Shopify Markets를 통한 Shopify의 기본 통화 변환을 사용해요. BUCKS 같은 통화 변환 앱은 스토어프론트에서 가격을 시각적으로만 변경할 뿐 실제 카트 통화를 수정하지 않아요. 따라서 Upcart 내부의 통화 표시에 영향을 주지 않고 불일치를 일으킬 수 있어요. 다중 통화 기능이 필요하다면 Shopify Markets 사용을 권장해요. CloudFox Checkout
서드파티 체크아웃 대체 앱은 Upcart와 호환되지 않아요. CartPanda
서드파티 체크아웃 시스템은 지원되지 않아요.

​
문제를 일으킬 수 있는 앱

다음 앱들은 충돌을 일으키거나 Upcart와 함께 사용할 때 의도한 대로 완전히 작동하지 않을 수 있다고 보고되었어요:
  • qikify Quick View Popups
  • Vitals
  • Bundle Bear
이 앱들이 일부 경우에는 작동할 수 있지만, Upcart의 특정 요소나 기능이 예상대로 표시되거나 작동하지 않을 수 있어요. 이 앱들을 사용하는 중에 문제가 발생하면 아래에 설명된 호환성 설정을 활성화하시길 권장해요.
​ 개발자는 Upcart Public API를 활용해 해결을 시도할 수도 있어요.

​
Enhanced AJAX API Compatibility

다른 앱과 충돌이 발생하고 있다면 다음 설정을 활성화하시길 권장해요: Enhanced AJAX API Compatibility 이 설정을 활성화하려면: Upcart → Cart editor → Settings → Cart settings → Advanced Settings → Enhanced Ajax API compatibility로 이동하세요. Upcart 관리자에는 최상위 Settings 메뉴가 없어요 — 이 설정은 카트 에디터 안, 접혀 있는 Advanced Settings 항목 안에 있어요. 이 설정은 Upcart가 Add to Cart 호출을 가로채는 것을 중단하도록 해요. 또한 이름에서 드러나지 않는 두 번째 기능도 있어요: Upcart가 Shopify의 Ajax cart API 호출(/cart/add, /cart/add.js, /cart/update.js, /cart/change.js)을 큐에 넣어 한 번에 하나씩 실행되도록 해서, 서로 다른 스크립트의 동시 업데이트가 서로를 덮어쓰는 것을 방지해요. 이 큐잉은 페이지의 모든 카트 네트워크 요청을 패치하므로, 필요할 때만 설정을 켜고 이후 스토어프론트를 테스트하세요. 이를 통해 번들 앱, 페이지 빌더, 커스터마이징 앱, 상품 옵션 앱 같은 다른 앱들이 간섭 없이 작동할 수 있어요.

​
중요:

이 설정에는 트레이드오프가 있어요. Upcart가 더 이상 Add to Cart 호출을 가로채지 않기 때문에, 다른 앱이 고객을 기본 카트 페이지로 리디렉션하는 것을 막을 수 없어요. 이 설정을 활성화한 후 고객이 카트 드로어에서 벗어나 리디렉션된다면:
  1. 충돌하는 앱의 설정을 확인하세요.
  2. 다음과 같은 옵션을 찾아보세요:
    • Disable redirect to cart
    • Stay on page after add to cart
    • Enable AJAX add to cart
  3. 강제 카트 페이지 리디렉션을 방지하도록 해당 설정을 조정하세요.
이 설정을 활성화한 후에는 테스트를 강력히 권장해요. 위에 나열된 앱들은 Upcart와 호환성 문제를 보인 앱의 예시예요. 아직 확인되지 않은 추가 앱이 있을 수 있어요. 새로운 사례가 보고되면 이 목록이 업데이트될 거예요.

​
Upcart가 열리지 않거나 리디렉션되는 경우

Upcart가 제대로 열리지 않거나 대신 카트 페이지로 리디렉션된다면 문제 해결 가이드를 참조해 주세요: Upcart가 열리지 않거나 카트 페이지로 리디렉션되는 문제 해결 이 가이드는 다음을 포함해 일반적인 원인과 단계별 해결 방법을 안내해요:
  • 테마 또는 커스텀 코드와의 충돌
  • AJAX 카트 설정 문제
  • 앱 호환성 확인
  • 브라우저 및 캐시 문제 해결 단계
가이드를 따라도 문제가 지속되면 스토어 URL과 문제에 대한 간단한 설명과 함께 지원팀에 문의해 주세요.

​
테스트 권장 사항

변경 사항을 라이브로 적용하기 전에 테마의 복제본에서 Upcart를 테스트하시길 권장해요. 방법은 다음과 같아요:
  • Shopify 관리자에서 Online Store > Themes로 이동하세요
  • 라이브 테마 옆의 Actions를 클릭한 다음 Duplicate를 선택하세요
  • 복제된 테마를 열고 Preview를 클릭하세요
  • 카트 상호작용, 번들, 할인, 통화 표시, 업셀을 테스트하세요
  • 확인이 끝나면 업데이트된 테마를 게시하세요
사전에 테스트하면 고객에게 영향을 미치기 전에 표시나 성능 문제를 예방할 수 있어요.