> ## 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.

# 체크아웃 업셀이 표시되지 않는 이유는 무엇인가요?

> 설정, 배치, 트리거, 제품/오퍼 문제를 포함해 체크아웃 업셀이 표시되지 않을 수 있는 모든 이유를 완벽하게 정리했어요.

체크아웃 업셀은 여러 가지 이유로 표시되지 않을 수 있어요. 아래 단계를 순서대로 진행하며 원인을 확인해 보세요.

<Note>
  체크아웃 업셀은 Shopify Plus 판매자만 사용할 수 있어요. Shopify의 Checkout Extensibility API가 Plus 전용이기 때문이에요. Shopify Plus를 사용하지 않는다면 설정과 관계없이 체크아웃 업셀이 표시되지 않아요. [체크아웃 탭이 보이지 않는 이유는 무엇인가요?](/ko/aftersell/why_cant_i_see_the_checkout_tab)를 참고하세요.
</Note>

<Tip>
  업셀이 표시되지 않더라도 고객의 체크아웃 경험에는 영향이 없어요 — 고객 측에서는 아무 문제도 발생하지 않아요.
</Tip>

***

<div id="where-to-start">
  ## 어디서부터 시작할까요
</div>

대부분의 표시 문제는 네 가지 중 하나로 귀결돼요: 위젯이 활성화되지 않았거나, 앱 블록이 Shopify에 추가/저장되지 않았거나, 배치가 일치하지 않거나, 트리거 조건이 충족되지 않은 경우예요. 먼저 기본 사항을 확인하세요:

* **Shopify Plus** 플랜을 사용 중인지 확인
* Aftersell Checkout 에디터에서 위젯이 **활성화**되어 있는지 확인(위젯 설정 오른쪽 상단의 **Enable** 토글이 켜져 있는지)
* Shopify Checkout Editor에서 앱 블록이 **추가되고 저장**되었는지 확인
* Shopify에서 선택한 배치가 Aftersell에서 설정한 배치와 **일치**하는지 확인

이 모든 것이 정상인데도 업셀이 여전히 표시되지 않는다면, 아래의 자세한 원인을 확인해 보세요.

* [위젯이 활성화되지 않았거나 체크아웃에 추가되지 않았어요](#widget-is-not-enabled-or-not-added-to-checkout)
* [Aftersell과 Shopify 간 배치 불일치](#placement-mismatch-between-aftersell-and-shopify)
* [트리거 조건이 충족되지 않고 있어요](#trigger-conditions-are-not-being-met)
* [제품 또는 오퍼에 문제가 있어요](#there-is-a-product-or-offer-issue)
* [Shop Pay 위젯이 표시되지 않아요](#shop-pay-widgets-not-showing)
* [Shopify 미리보기에서 테스트하기](#testing-in-the-shopify-preview)
* [위 사항이 모두 해당되지 않아요](#nothing-above-applies)

***

<div id="widget-is-not-enabled-or-not-added-to-checkout">
  ## 위젯이 활성화되지 않았거나 체크아웃에 추가되지 않았어요
</div>

체크아웃 업셀이 표시되려면 두 가지가 동시에 충족되어야 해요:

1. Aftersell Checkout 에디터에서 위젯이 **활성화**되어 있어야 해요
2. Shopify Checkout Editor에서 앱 블록이 **추가되고 저장**되어 있어야 해요

둘 중 하나라도 빠지면 위젯이 표시되지 않아요.

**Aftersell에서 위젯을 활성화하려면:**

1. **Apps → Aftersell → Checkout**으로 이동하세요
2. 표시하려는 업셀 위젯을 여세요
3. 위젯이 켜져 있는지 확인하세요 — 헤더에 **Active** / **Inactive** 배지 옆에 토글이 표시돼요. (이전 Checkout 에디터에서는 위젯 카드 헤더에 **Enable** / **Disable** 버튼 쌍으로 표시돼요.)

**Shopify에서 앱 블록을 추가하려면:**

1. Shopify Admin에서 **Settings → Checkout**으로 이동하세요
2. 체크아웃 프로필 옆의 **Customize**를 클릭하세요
3. **Add app block**을 클릭하고 Aftersell 업셀 위젯을 선택하세요
4. 표시하려는 위치에 배치하세요
5. **Save**를 클릭하세요 — 저장하기 전에는 변경 사항이 적용되지 않아요

***

<div id="placement-mismatch-between-aftersell-and-shopify">
  ## Aftersell과 Shopify 간 배치 불일치
</div>

배치 불일치는 체크아웃 업셀이 표시되지 않는 가장 흔한 원인 중 하나예요.

Aftersell은 동일한 체크아웃 페이지에서 같은 유형의 위젯을 여러 개 실행할 수 있도록 여러 배치를 지원해요. 각 배치는 Shopify Checkout Editor의 **별도 앱 블록**에 해당하며, Shopify에서 선택한 배치는 Aftersell에서 구성한 배치와 일치해야 해요.

Upsell Widget 앱 블록의 **Placement** 드롭다운에는 여덟 가지 값이 있어요: **Default placement (Upsell Widget 1)**, **Additional placement 1 (Upsell Widget 2)**, **Additional placement 2 (Upsell Widget 3)**, 그리고 다섯 개의 페이지 위젯 슬롯 **page-upsell-001**부터 **page-upsell-005**까지예요.

배치가 일치하지 않으면 위젯이 표시되지 않거나 잘못된 위치에 표시될 수 있어요.

**배치 불일치를 해결하려면:**

1. Aftersell Checkout 에디터에서 업셀 위젯을 열고 어떤 배치가 선택되어 있는지 확인하세요(예: **Additional placement 1**)
2. Shopify Checkout Editor에서 이 위젯의 기존 앱 블록을 제거하세요
3. **Add app block**을 클릭하고 Aftersell 업셀 위젯을 선택한 다음, Aftersell에 설정된 것과 **동일한 배치**를 선택하세요
4. 변경 사항을 저장하세요

[배치 일치에 대해 자세히 알아보기 →](/ko/aftersell/how_to_configure_checkout_widgets#matching-placements-in-the-shopify-checkout-editor)

***

<div id="trigger-conditions-are-not-being-met">
  ## 트리거 조건이 충족되지 않고 있어요
</div>

업셀 위젯에 트리거가 구성되어 있으면, 카트가 해당 조건을 충족할 때만 표시돼요. 카트가 트리거 조건을 충족하지 않으면 위젯이 표시되지 않아요 — 이는 정상적인 동작이에요.

사용 가능한 트리거 유형은 다음과 같아요:

* **특정 제품 / 컬렉션:** 선택한 제품, 옵션(variant) 또는 컬렉션이 카트에 있는(또는 없는) 경우
* **특정 제품의 수량:** 예: 특정 제품이 2개 이상
* **제품 태그 / 제품 유형 / 옵션 이름:** 카트 항목 중 하나가 Shopify 태그, 제품 유형 또는 옵션 이름과 일치(대소문자 구분 없음)
* **제품 메타필드 / 옵션 메타필드:** 카트의 제품 또는 옵션에 일치하는 메타필드 값이 있는 경우
* **카트 소계:** 소계가 기준 금액을 충족(소계 계산 방식은 아래 참고 사항 참조)
* **카트 수량:** 카트에 담긴 총 상품 수
* **카트 내 구독:** 카트 항목 중 구독 상품이 있는지 여부
* **카트 속성:** 카트 수준의 속성 키/값이 일치(다른 앱이 설정한 데이터에 유용)
* **적용된 할인 / 할인 금액:** 특정 할인 코드가 적용되었거나 총 할인이 기준을 충족
* **배송 국가:** 고객의 배송 국가(및 선택적으로 주/도)가 일치
* **고객 언어:** 체크아웃의 언어가 일치(예: 프랑스어 체크아웃에만 프랑스어 콘텐츠 표시)
* **고객 태그:** 로그인한 고객이 필요한 태그를 보유
* **기기 유형:** 고객이 설정된 기기(데스크톱 또는 모바일)를 사용

<Note>
  트리거 평가에 사용되는 **카트 소계**는 이미 수락된 업셀로 추가된 상품 라인(`__as_offer_id` 카트 속성이 태그된 항목)을 제외해요. 따라서 하나의 업셀을 수락하는 것만으로는 다른 위젯의 기준 금액을 초과하지 않아요.
</Note>

**조건 결합:** 위젯에 여러 조건이 있는 경우 **AND** 또는 **OR**(선택 가능)로 결합되며, 더 복잡한 로직을 위해 조건을 그룹으로 중첩할 수 있어요. **AND** 결합에서는 모든 조건이 충족되어야 해요 — 하나의 조건이라도 충족되지 않으면 위젯이 조용히 차단돼요. **OR** 결합에서는 하나만 일치하면 충분해요. 테스트 카트를 기준으로 각 조건을 개별적으로 검토하세요.

**트리거 문제를 해결하려면:**

1. Aftersell Checkout 에디터에서 위젯을 열고 트리거 조건을 검토하세요
2. 트리거를 일시적으로 **Show for all customers**로 설정해 위젯 자체가 작동하는지 확인한 다음, 원래 트리거를 다시 활성화하세요
3. 최소 하나의 위젯이 가장 낮은 우선순위에서 **Show for all customers** 트리거를 캐치올로 사용하도록 하여, 타겟 위젯이 일치하지 않을 때도 항상 오퍼가 표시되도록 하세요

[체크아웃 트리거에 대해 자세히 알아보기 →](/ko/aftersell/checkout_triggers)

***

<div id="there-is-a-product-or-offer-issue">
  ## 제품 또는 오퍼에 문제가 있어요
</div>

위젯이 활성화되어 있고, 올바르게 배치되었으며, 트리거가 일치하더라도, 오퍼 자체가 표시 전에 걸러질 수 있어요.

<AccordionGroup>
  <Accordion title="업셀 제품이 품절이에요">
    제품의 재고가 추적되고 있고 판매 가능한 옵션이 없으면 오퍼가 표시되지 않아요. 업셀 제품의 옵션 중 하나 이상에 재고가 있는지 확인하거나, 재고를 추적하지 않는 제품을 사용하세요.
  </Accordion>

  <Accordion title="업셀 제품이 Draft 또는 Archived 상태예요">
    업셀 제품은 판매 가능한 라이브 제품이어야 해요. Shopify에서 **Draft** 또는 **Archived** 상태인 제품은 걸러져 오퍼로 표시되지 않아요. Shopify Admin에서 제품을 열고 상태가 **Active**인지 확인하세요.
  </Accordion>

  <Accordion title="업셀 제품이 이미 카트에 있고 'hide if already in cart'가 활성화되어 있어요">
    **Hide offer if product already in cart** 설정은 해당 제품이 고객 카트에 이미 있을 때 오퍼를 숨겨요. 표준 제품 오퍼에서는 기본적으로 켜져 있어요. 상관없이 업셀을 표시하고 싶다면 오퍼 구성에서 이 설정을 비활성화하세요.
  </Accordion>

  <Accordion title="업셀 제품이 구독 상품인데 판매 플랜이 없어요">
    **Subscription purchase option**이 **Subscription**으로 설정되어 있는데 제품에 Shopify에서 구성된 판매 플랜(selling plan)이 없으면, 오퍼가 걸러져요. 제품에 활성 판매 플랜이 하나 이상 있는지 확인하거나, **Subscription purchase option**을 **One-time product**로 변경하세요(다른 선택지는 **Subscription**과 **Subscription and a one-time product**예요).
  </Accordion>

  <Accordion title="교체 업셀의 대상 제품이 카트에 없어요">
    오퍼가 교체 업셀로 구성된 경우, 교체 대상 제품이 카트에 있을 때만 표시돼요. 교체 업셀 구성에서 올바른 대상 제품이 선택되었는지 확인하세요.

    대상 상품 라인에 **이미 할인이 적용된** 경우에도 교체 오퍼가 건너뛰어져요 — **Allow replacement if product has discount applied**를 체크하지 않는 한 — 또한 대상 라인의 **수량이 1보다 큰** 경우에도 **Allow replacement if product quantity greater than 1**을 체크하지 않는 한 건너뛰어져요.
  </Accordion>

  <Accordion title="수락 가능한 최대 오퍼 수에 도달했어요">
    위젯에 **Max number of accepted offers**가 설정되어 있으면, 고객이 현재 체크아웃에서 해당 위젯의 오퍼를 그 수만큼 수락하면 업셀 표시가 중단돼요. 이는 의도된 동작이에요 — 한도에 도달하면 위젯이 스스로 숨겨져요. 이 필드는 Single product 및 Multi product 업셀에만 적용되고, Checkmark 업셀에는 이런 제한이 없어요.
  </Accordion>

  <Accordion title="이 위젯을 통해 오퍼가 이미 카트에 추가되었어요">
    **단일(single)** 및 **다중 제품(multi-product)** 업셀의 경우, 고객이 오퍼 제품을 카트에 추가하면 오퍼가 숨겨져요(제품이 이미 카트에 있으니까요). **Checkmark** 업셀은 다르게 동작해요 — 수락 후에도 체크박스가 체크된 상태로 계속 표시돼요.
  </Accordion>
</AccordionGroup>

***

<div id="shop-pay-widgets-not-showing">
  ## Shop Pay 위젯이 표시되지 않아요
</div>

체크아웃 위젯은 기본적으로 Shop Pay에 표시되지 않아요. Shop Pay에 업셀을 표시하려면 명시적으로 활성화해야 해요:

1. Shopify Checkout Editor에서 Aftersell 업셀 앱 블록을 여세요
2. 블록 설정에서 **Checkout behaviour** 섹션을 찾으세요
3. **Include app block in Shop Pay** 옵션을 체크하세요
4. 변경 사항을 저장하세요

[Shop Pay 위젯에 대해 자세히 알아보기 →](/ko/aftersell/show_checkout_widgets_in_shop_pay)

***

<div id="testing-in-the-shopify-preview">
  ## Shopify 미리보기에서 테스트하기
</div>

Shopify Checkout Editor 미리보기는 위젯을 안정적으로 렌더링하지 않아요. 위젯이 올바르게 구성되어 있어도 에디터 미리보기에는 표시되지 않을 수 있어요. 미리보기는 페이지 태깅과 트리거 조건을 시뮬레이션할 수 없기 때문이에요. 위젯 작동 여부를 확인할 때 에디터 미리보기에 의존하지 마세요.

**업셀을 정확하게 테스트하려면:**

1. 위젯 트리거를 일시적으로 **Show for all customers**로 설정하세요
2. Shopify의 테스트 결제 게이트웨이(또는 주문을 무료로 만드는 할인 코드)를 사용해 실제 테스트 주문을 하세요
3. 실제 체크아웃 흐름에서 위젯이 표시되는지 확인하세요
4. 테스트 후 트리거를 원래대로 되돌리세요

***

<div id="nothing-above-applies">
  ## 위 사항이 모두 해당되지 않아요
</div>

위의 모든 사항을 확인했는데도 업셀이 여전히 표시되지 않으면 다음을 확인하세요:

* 위젯이 Aftersell에서 **활성화**되어 있고, Shopify Checkout Editor에서 앱 블록이 **추가되고 저장**되어 있는지
* Aftersell의 **배치**가 Shopify에서 선택한 배치와 일치하는지
* 트리거 조건이 테스트 카트와 일치하는지 — **AND** 결합에서는 모든 조건이 충족되어야 한다는 점을 기억하세요
* 가장 낮은 우선순위에 캐치올로 **Show for all customers** 트리거가 설정된 위젯이 하나 이상 있는지
* 업셀 제품이 **Active** 상태이고, 재고가 있으며, (구독 오퍼의 경우) 활성 판매 플랜이 있는지
* Shopify 에디터 미리보기가 아닌 **실제 체크아웃 흐름**으로 테스트하고 있는지
* 브라우저 캐시를 지우거나 시크릿 창에서 테스트해 보세요 — 변경 사항이 반영되기까지 몇 분이 걸릴 수 있어요

아직 해결되지 않았나요? 채팅으로 문의하시거나 [support@aftersell.app](mailto:support@aftersell.app)으로 위젯 설정 설명과 테스트 주문 상세 정보를 포함해 이메일을 보내 주세요.