> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Upcart와의 앱 호환성

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

<div id="overview">
  ## **개요**
</div>

Upcart는 대부분의 Shopify 앱과 원활하게 통합되도록 설계되었어요. 하지만 일부 서드파티 앱은 Shopify의 카트, 체크아웃, 가격 책정 또는 통화 로직을 수정하는 방식에 따라 기능 문제를 일으킬 수 있어요.\
​

Upcart는 카트 드로어 오버레이로 작동하며, Shopify의 기본 카트나 체크아웃을 완전히 대체하지 않고 쇼핑 카트 경험을 향상시켜요.\
​

Shopify의 카트 동작을 재정의하거나, Add to Cart 액션을 가로채거나, Shopify의 기본 가격 책정 또는 통화 시스템을 대체하는 앱은 Upcart와 충돌할 수 있어요.

가능한 한 Shopify의 기본 기능(통화 변환에는 Shopify Markets 등)을 사용하시길 권장해요. **Shopify의 기본 카트 구조를 크게 변경하는 서드파티 앱에 대해서는 저희 팀의 지원 범위가 제한적이에요.**

앱이 Shopify App Store에 있더라도 여전히 서드파티 앱으로 분류될 수 있으며, Upcart와 함께 사용할 때 특정 제한이 있을 수 있어요.

<div id="incompatible-apps">
  ## **호환되지 않는 앱**
</div>

다음 앱들은 Upcart와 지속적으로 문제를 일으키는 것으로 확인되어 지원되지 않아요:

**BUCKS (통화 변환 앱)**\
Upcart는 서드파티 통화 변환 앱과 호환되지 않아요. Upcart는 Shopify Markets를 통한 Shopify의 기본 통화 변환을 사용해요. BUCKS 같은 통화 변환 앱은 스토어프론트에서 가격을 시각적으로만 변경할 뿐 실제 카트 통화를 수정하지 않아요. 따라서 Upcart 내부의 통화 표시에 영향을 주지 않고 불일치를 일으킬 수 있어요.

다중 통화 기능이 필요하다면 **Shopify Markets** 사용을 권장해요.

**CloudFox Checkout**\
서드파티 체크아웃 대체 앱은 Upcart와 호환되지 않아요.

**CartPanda**\
서드파티 체크아웃 시스템은 지원되지 않아요.

***

<div id="apps-that-may-cause-issues">
  ## **문제를 일으킬 수 있는 앱**
</div>

다음 앱들은 충돌을 일으키거나 Upcart와 함께 사용할 때 의도한 대로 완전히 작동하지 않을 수 있다고 보고되었어요:

* **qikify Quick View Popups**
* **Vitals**
* **Bundle Bear**

이 앱들이 일부 경우에는 작동할 수 있지만, Upcart의 특정 요소나 기능이 예상대로 표시되거나 작동하지 않을 수 있어요.

이 앱들을 사용하는 중에 문제가 발생하면 아래에 설명된 호환성 설정을 활성화하시길 권장해요.\
​

개발자는 [<u>Upcart Public AP</u>](https://rokt.notion.site/upcart-public-api)I를 활용해 해결을 시도할 수도 있어요.

***

<div id="enhanced-ajax-api-compatibility">
  ## **Enhanced AJAX API Compatibility**
</div>

다른 앱과 충돌이 발생하고 있다면 다음 설정을 활성화하시길 권장해요:

**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`)을 큐에 넣어 한 번에 하나씩 실행되도록 해서, 서로 다른 스크립트의 동시 업데이트가 서로를 덮어쓰는 것을 방지해요. 이 큐잉은 페이지의 모든 카트 네트워크 요청을 패치하므로, 필요할 때만 설정을 켜고 이후 스토어프론트를 테스트하세요.

이를 통해 번들 앱, 페이지 빌더, 커스터마이징 앱, 상품 옵션 앱 같은 다른 앱들이 간섭 없이 작동할 수 있어요.

<div id="important">
  ### **중요:**
</div>

이 설정에는 트레이드오프가 있어요.

Upcart가 더 이상 Add to Cart 호출을 가로채지 않기 때문에, 다른 앱이 고객을 기본 카트 페이지로 리디렉션하는 것을 막을 수 없어요.

이 설정을 활성화한 후 고객이 카트 드로어에서 벗어나 리디렉션된다면:

1. 충돌하는 앱의 설정을 확인하세요.
2. 다음과 같은 옵션을 찾아보세요:
   * Disable redirect to cart
   * Stay on page after add to cart
   * Enable AJAX add to cart
3. 강제 카트 페이지 리디렉션을 방지하도록 해당 설정을 조정하세요.

이 설정을 활성화한 후에는 테스트를 강력히 권장해요.

위에 나열된 앱들은 Upcart와 호환성 문제를 보인 앱의 예시예요. 아직 확인되지 않은 추가 앱이 있을 수 있어요. 새로운 사례가 보고되면 이 목록이 업데이트될 거예요.

<div id="if-upcart-is-not-opening-or-is-redirecting">
  ### Upcart가 열리지 않거나 리디렉션되는 경우
</div>

Upcart가 제대로 열리지 않거나 대신 카트 페이지로 리디렉션된다면 문제 해결 가이드를 참조해 주세요:

[Upcart가 열리지 않거나 카트 페이지로 리디렉션되는 문제 해결](/ko/upcart/troubleshooting_upcart_not_opening_or_redirecting)

이 가이드는 다음을 포함해 일반적인 원인과 단계별 해결 방법을 안내해요:

* 테마 또는 커스텀 코드와의 충돌
* AJAX 카트 설정 문제
* 앱 호환성 확인
* 브라우저 및 캐시 문제 해결 단계

가이드를 따라도 문제가 지속되면 스토어 URL과 문제에 대한 간단한 설명과 함께 지원팀에 문의해 주세요.

***

<div id="testing-recommendation">
  ## **테스트 권장 사항**
</div>

변경 사항을 라이브로 적용하기 전에 테마의 복제본에서 Upcart를 테스트하시길 권장해요.

방법은 다음과 같아요:

* Shopify 관리자에서 **Online Store > Themes**로 이동하세요
* 라이브 테마 옆의 **Actions**를 클릭한 다음 **Duplicate**를 선택하세요
* 복제된 테마를 열고 **Preview**를 클릭하세요
* 카트 상호작용, 번들, 할인, 통화 표시, 업셀을 테스트하세요
* 확인이 끝나면 업데이트된 테마를 게시하세요

사전에 테스트하면 고객에게 영향을 미치기 전에 표시나 성능 문제를 예방할 수 있어요.

***