> ## 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 API 자주 묻는 질문

> 설정, 문제 해결, 서드파티 연동 등 Upcart API 사용에 관한 자주 묻는 질문에 대한 답변을 확인하세요.

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

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

* **[Upcart API 스크립트는 어디에 추가하나요?](#where-to-add-upcart-api-scripts)**
* **[Upcart API를 사용하려면 개발자여야 하나요?](#do-i-need-to-be-a-developer-to-use-upcarts-api)**
* **[Upcart API를 다른 서드파티 앱과 연동할 수 있나요?](#can-upcarts-api-integrate-with-other-third-party-apps)**
* **[API 변경 사항이 잘 작동하는지 어떻게 테스트하나요?](#how-do-i-test-if-my-api-changes-are-working)**
* **[API 스크립트가 작동하지 않으면 어떻게 해야 하나요?](#what-should-i-do-if-an-api-script-isnt-working)**
* **[문제를 일으키는 스크립트를 추가했다면 어떻게 되돌리나요?](#how-do-i-undo-changes-if-i-add-a-script-that-breaks-something)**

***

<div id="where-to-add-upcart-api-scripts">
  ## **Upcart API 스크립트는 어디에 추가하나요?**
</div>

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

<div id="how-do-i-use-upcarts-custom-html">
  ## Upcart의 Custom HTML은 어떻게 사용하나요?
</div>

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

<div id="example-hide-the-sticky-cart-button-when-the-cart-is-empty">
  #### 💡 *예시: 장바구니가 비어 있을 때 고정 장바구니 버튼 숨기기*
</div>

```
<script>  
  window.upcartSubscribeCartLoaded((event) => {  
    const itemCount = event.cart.items.reduce((total, item) => total + item.quantity, 0);  
    document.querySelector("#upCartStickyButton").style.display = itemCount === 0 ? "none" : "block";  
    console.log("Sticky Cart is hiding!");  
  });  
</script>
```

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

***

<div id="do-i-need-to-be-a-developer-to-use-upcarts-api">
  # **Upcart API를 사용하려면 개발자여야 하나요?**
</div>

아니에요! Upcart API는 코딩 지식이 없어도 쉽게 사용할 수 있어요. 많은 기능이 기본으로 제공되고, 저희 [사용자 지정 문서](/ko/upcart/add_a_mandatory_terms_and_conditions_checkbox_to_your_cart)에는 Upcart의 Custom HTML 설정에 복사해 넣기만 하면 되는 미리 작성된 스크립트가 포함되어 있어요 — 코딩이 필요 없어요!

직접 스크립트를 작성하고 싶다면 기본적인 JavaScript 지식이 도움이 돼요. JavaScript가 처음이어도 걱정하지 마세요! **W3Schools**와 **[MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/JavaScript)** 같은 초보자 친화적인 자료로 시작할 수 있어요.

***

<div id="can-upcarts-api-integrate-with-other-third-party-apps">
  # Upcart API를 다른 서드파티 앱과 연동할 수 있나요?
</div>

네! Upcart API는 번역, 분석, 업셀 등 다양한 앱과 함께 작동해요. 일부는 자동으로 연동되고, 일부는 간단한 스크립트가 필요할 수 있어요.

예를 들어 추적용으로 \*\*[TripleWhale](https://kb.triplewhale.com/en/articles/6610178-adding-the-triple-pixel-to-third-party-checkouts#h_eccf979512)\*\*을 사용한다면, 장바구니 활동을 올바르게 기록하도록 다음 스크립트를 추가해야 해요:

```
<script>  
window.upcartSubscribeAddedToCart((event) => {  
	window.TriplePixel('AddToCart', {item: event.item.variantId, q: event.item.quantityAdded});  
});  
</script>
```

<Note>
  **레거시 안내:** `window.upcartOnAddToCart` 콜백은 여전히 작동하지만 더 이상 사용되지 않으며 콘솔 경고를 출력해요. 새 스크립트에는 모두 `upcartSubscribeAddedToCart`를 사용하세요. 이벤트 속성은 별도의 매개변수가 아니라 `event.item`(`variantId`와 `quantityAdded` 포함)에 있다는 점에 유의하세요.
</Note>

앱마다 다르므로, 추가 코드가 필요한지 해당 앱의 지원팀에 문의하세요. Upcart는 서드파티 앱용 스크립트 지원을 제공하지 않지만, 앱 제공업체에 연동 가이드가 있을 수 있어요.

***

<div id="how-do-i-test-if-my-api-changes-are-working">
  # API 변경 사항이 잘 작동하는지 어떻게 테스트하나요?
</div>

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. **다양한 동작을 테스트**해(예: 상품 제거) 기대한 대로 작동하는지 확인하세요.

오타나 콘솔 오류를 확인하고 필요에 따라 코드를 조정하며 **문제를 해결**하세요.

***

<div id="what-should-i-do-if-an-api-script-isnt-working">
  # API 스크립트가 작동하지 않으면 어떻게 해야 하나요?
</div>

API 스크립트가 작동하지 않는다면 다음 문제 해결 단계를 시도해 보세요:

* **오타 확인** – 작은 오류 하나도 스크립트를 망가뜨릴 수 있어요. 누락된 문자나 잘못된 문법을 찾아보세요.

* **스크립트 위치 확인** – 스크립트가 Upcart → Settings → Custom HTML의 올바른 섹션에 있는지 확인하세요. Upcart에는 10개의 스크립트 섹션(HTML 삽입 지점 9개와 Scripts-before-load 섹션 1개)이 있어요 — [여기에서 섹션을 확인하세요.](/ko/upcart/custom_html)

* **브라우저 콘솔 확인** – 위 단계에 따라 오류를 찾아보세요.

* **다른 스크립트 테스트** – 미리 작성된 다른 Upcart API 스크립트를 시도해 문제가 내 코드에 있는지 확인하세요.

* **여전히 막혔나요?** – Shopify 테마를 수정하거나 서드파티 앱을 연동하는 경우라면 [Shopify Partner Directory](https://www.shopify.com/partners/directory)의 Shopify 전문가가 도와드릴 수 있어요.

이 단계들을 따르면 대부분의 스크립트 문제를 찾고 해결할 수 있을 거예요!

***

<div id="how-do-i-undo-changes-if-i-add-a-script-that-breaks-something">
  # 문제를 일으키는 스크립트를 추가했다면 어떻게 되돌리나요?
</div>

기대한 대로 작동하지 않는 스크립트를 추가했다면 **쉽게 제거하거나 비활성화**할 수 있어요:

* 스크립트를 추가했던 **Upcart의 Custom HTML 설정으로 이동**하세요.

* **스크립트를 제거**하거나 각 줄 시작에 `//`를 추가해 일시적으로 비활성화하세요(주석으로 바뀌어 실행되지 않아요).

* **변경 사항을 저장하고 스토어를 새로 고침**해 문제가 해결됐는지 확인하세요.

문제가 계속되면 캐시를 삭제하거나 최근 테마 변경 사항을 되돌려 보세요 — 숨겨진 충돌이 해결되는 경우가 많아요.

***

🚧 **고급 사용자 지정이 필요하신가요?**

스토어 전체 사용자 지정이나 서드파티 앱 연동이 필요하신가요? Shopify 테마에 Upcart API를 추가하려면 개발자가 필요할 수 있어요.

\*\*[Shopify Partner Directory](https://www.shopify.com/partners/directory)\*\*를 통해 Shopify 전문가를 고용하고, 저희 [API 문서](/ko/upcart/introduction_to_upcarts_public_api)를 공유해 도움을 받는 것을 고려해 보세요