Skip to main content
체크아웃 업셀은 여러 가지 이유로 표시되지 않을 수 있어요. 아래 단계를 순서대로 진행하며 원인을 확인해 보세요.
체크아웃 업셀은 Shopify Plus 판매자만 사용할 수 있어요. Shopify의 Checkout Extensibility API가 Plus 전용이기 때문이에요. Shopify Plus를 사용하지 않는다면 설정과 관계없이 체크아웃 업셀이 표시되지 않아요. 체크아웃 탭이 보이지 않는 이유는 무엇인가요?를 참고하세요.
업셀이 표시되지 않더라도 고객의 체크아웃 경험에는 영향이 없어요 — 고객 측에서는 아무 문제도 발생하지 않아요.

​
어디서부터 시작할까요

대부분의 표시 문제는 네 가지 중 하나로 귀결돼요: 위젯이 활성화되지 않았거나, 앱 블록이 Shopify에 추가/저장되지 않았거나, 배치가 일치하지 않거나, 트리거 조건이 충족되지 않은 경우예요. 먼저 기본 사항을 확인하세요:
  • Shopify Plus 플랜을 사용 중인지 확인
  • Aftersell Checkout 에디터에서 위젯이 활성화되어 있는지 확인(위젯 설정 오른쪽 상단의 Enable 토글이 켜져 있는지)
  • Shopify Checkout Editor에서 앱 블록이 추가되고 저장되었는지 확인
  • Shopify에서 선택한 배치가 Aftersell에서 설정한 배치와 일치하는지 확인
이 모든 것이 정상인데도 업셀이 여전히 표시되지 않는다면, 아래의 자세한 원인을 확인해 보세요.

​
위젯이 활성화되지 않았거나 체크아웃에 추가되지 않았어요

체크아웃 업셀이 표시되려면 두 가지가 동시에 충족되어야 해요:
  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를 클릭하세요 — 저장하기 전에는 변경 사항이 적용되지 않아요

​
Aftersell과 Shopify 간 배치 불일치

배치 불일치는 체크아웃 업셀이 표시되지 않는 가장 흔한 원인 중 하나예요. 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. 변경 사항을 저장하세요
배치 일치에 대해 자세히 알아보기 →

​
트리거 조건이 충족되지 않고 있어요

업셀 위젯에 트리거가 구성되어 있으면, 카트가 해당 조건을 충족할 때만 표시돼요. 카트가 트리거 조건을 충족하지 않으면 위젯이 표시되지 않아요 — 이는 정상적인 동작이에요. 사용 가능한 트리거 유형은 다음과 같아요:
  • 특정 제품 / 컬렉션: 선택한 제품, 옵션(variant) 또는 컬렉션이 카트에 있는(또는 없는) 경우
  • 특정 제품의 수량: 예: 특정 제품이 2개 이상
  • 제품 태그 / 제품 유형 / 옵션 이름: 카트 항목 중 하나가 Shopify 태그, 제품 유형 또는 옵션 이름과 일치(대소문자 구분 없음)
  • 제품 메타필드 / 옵션 메타필드: 카트의 제품 또는 옵션에 일치하는 메타필드 값이 있는 경우
  • 카트 소계: 소계가 기준 금액을 충족(소계 계산 방식은 아래 참고 사항 참조)
  • 카트 수량: 카트에 담긴 총 상품 수
  • 카트 내 구독: 카트 항목 중 구독 상품이 있는지 여부
  • 카트 속성: 카트 수준의 속성 키/값이 일치(다른 앱이 설정한 데이터에 유용)
  • 적용된 할인 / 할인 금액: 특정 할인 코드가 적용되었거나 총 할인이 기준을 충족
  • 배송 국가: 고객의 배송 국가(및 선택적으로 주/도)가 일치
  • 고객 언어: 체크아웃의 언어가 일치(예: 프랑스어 체크아웃에만 프랑스어 콘텐츠 표시)
  • 고객 태그: 로그인한 고객이 필요한 태그를 보유
  • 기기 유형: 고객이 설정된 기기(데스크톱 또는 모바일)를 사용
트리거 평가에 사용되는 카트 소계는 이미 수락된 업셀로 추가된 상품 라인(__as_offer_id 카트 속성이 태그된 항목)을 제외해요. 따라서 하나의 업셀을 수락하는 것만으로는 다른 위젯의 기준 금액을 초과하지 않아요.
조건 결합: 위젯에 여러 조건이 있는 경우 AND 또는 OR(선택 가능)로 결합되며, 더 복잡한 로직을 위해 조건을 그룹으로 중첩할 수 있어요. AND 결합에서는 모든 조건이 충족되어야 해요 — 하나의 조건이라도 충족되지 않으면 위젯이 조용히 차단돼요. OR 결합에서는 하나만 일치하면 충분해요. 테스트 카트를 기준으로 각 조건을 개별적으로 검토하세요. 트리거 문제를 해결하려면:
  1. Aftersell Checkout 에디터에서 위젯을 열고 트리거 조건을 검토하세요
  2. 트리거를 일시적으로 Show for all customers로 설정해 위젯 자체가 작동하는지 확인한 다음, 원래 트리거를 다시 활성화하세요
  3. 최소 하나의 위젯이 가장 낮은 우선순위에서 Show for all customers 트리거를 캐치올로 사용하도록 하여, 타겟 위젯이 일치하지 않을 때도 항상 오퍼가 표시되도록 하세요
체크아웃 트리거에 대해 자세히 알아보기 →

​
제품 또는 오퍼에 문제가 있어요

위젯이 활성화되어 있고, 올바르게 배치되었으며, 트리거가 일치하더라도, 오퍼 자체가 표시 전에 걸러질 수 있어요.
제품의 재고가 추적되고 있고 판매 가능한 옵션이 없으면 오퍼가 표시되지 않아요. 업셀 제품의 옵션 중 하나 이상에 재고가 있는지 확인하거나, 재고를 추적하지 않는 제품을 사용하세요.
업셀 제품은 판매 가능한 라이브 제품이어야 해요. Shopify에서 Draft 또는 Archived 상태인 제품은 걸러져 오퍼로 표시되지 않아요. Shopify Admin에서 제품을 열고 상태가 Active인지 확인하세요.
Hide offer if product already in cart 설정은 해당 제품이 고객 카트에 이미 있을 때 오퍼를 숨겨요. 표준 제품 오퍼에서는 기본적으로 켜져 있어요. 상관없이 업셀을 표시하고 싶다면 오퍼 구성에서 이 설정을 비활성화하세요.
Subscription purchase option이 Subscription으로 설정되어 있는데 제품에 Shopify에서 구성된 판매 플랜(selling plan)이 없으면, 오퍼가 걸러져요. 제품에 활성 판매 플랜이 하나 이상 있는지 확인하거나, Subscription purchase option을 One-time product로 변경하세요(다른 선택지는 Subscription과 Subscription and a one-time product예요).
오퍼가 교체 업셀로 구성된 경우, 교체 대상 제품이 카트에 있을 때만 표시돼요. 교체 업셀 구성에서 올바른 대상 제품이 선택되었는지 확인하세요.대상 상품 라인에 이미 할인이 적용된 경우에도 교체 오퍼가 건너뛰어져요 — Allow replacement if product has discount applied를 체크하지 않는 한 — 또한 대상 라인의 수량이 1보다 큰 경우에도 Allow replacement if product quantity greater than 1을 체크하지 않는 한 건너뛰어져요.
위젯에 Max number of accepted offers가 설정되어 있으면, 고객이 현재 체크아웃에서 해당 위젯의 오퍼를 그 수만큼 수락하면 업셀 표시가 중단돼요. 이는 의도된 동작이에요 — 한도에 도달하면 위젯이 스스로 숨겨져요. 이 필드는 Single product 및 Multi product 업셀에만 적용되고, Checkmark 업셀에는 이런 제한이 없어요.
단일(single) 및 다중 제품(multi-product) 업셀의 경우, 고객이 오퍼 제품을 카트에 추가하면 오퍼가 숨겨져요(제품이 이미 카트에 있으니까요). Checkmark 업셀은 다르게 동작해요 — 수락 후에도 체크박스가 체크된 상태로 계속 표시돼요.

​
Shop Pay 위젯이 표시되지 않아요

체크아웃 위젯은 기본적으로 Shop Pay에 표시되지 않아요. Shop Pay에 업셀을 표시하려면 명시적으로 활성화해야 해요:
  1. Shopify Checkout Editor에서 Aftersell 업셀 앱 블록을 여세요
  2. 블록 설정에서 Checkout behaviour 섹션을 찾으세요
  3. Include app block in Shop Pay 옵션을 체크하세요
  4. 변경 사항을 저장하세요
Shop Pay 위젯에 대해 자세히 알아보기 →

​
Shopify 미리보기에서 테스트하기

Shopify Checkout Editor 미리보기는 위젯을 안정적으로 렌더링하지 않아요. 위젯이 올바르게 구성되어 있어도 에디터 미리보기에는 표시되지 않을 수 있어요. 미리보기는 페이지 태깅과 트리거 조건을 시뮬레이션할 수 없기 때문이에요. 위젯 작동 여부를 확인할 때 에디터 미리보기에 의존하지 마세요. 업셀을 정확하게 테스트하려면:
  1. 위젯 트리거를 일시적으로 Show for all customers로 설정하세요
  2. Shopify의 테스트 결제 게이트웨이(또는 주문을 무료로 만드는 할인 코드)를 사용해 실제 테스트 주문을 하세요
  3. 실제 체크아웃 흐름에서 위젯이 표시되는지 확인하세요
  4. 테스트 후 트리거를 원래대로 되돌리세요

​
위 사항이 모두 해당되지 않아요

위의 모든 사항을 확인했는데도 업셀이 여전히 표시되지 않으면 다음을 확인하세요:
  • 위젯이 Aftersell에서 활성화되어 있고, Shopify Checkout Editor에서 앱 블록이 추가되고 저장되어 있는지
  • Aftersell의 배치가 Shopify에서 선택한 배치와 일치하는지
  • 트리거 조건이 테스트 카트와 일치하는지 — AND 결합에서는 모든 조건이 충족되어야 한다는 점을 기억하세요
  • 가장 낮은 우선순위에 캐치올로 Show for all customers 트리거가 설정된 위젯이 하나 이상 있는지
  • 업셀 제품이 Active 상태이고, 재고가 있으며, (구독 오퍼의 경우) 활성 판매 플랜이 있는지
  • Shopify 에디터 미리보기가 아닌 실제 체크아웃 흐름으로 테스트하고 있는지
  • 브라우저 캐시를 지우거나 시크릿 창에서 테스트해 보세요 — 변경 사항이 반영되기까지 몇 분이 걸릴 수 있어요
아직 해결되지 않았나요? 채팅으로 문의하시거나 support@aftersell.app으로 위젯 설정 설명과 테스트 주문 상세 정보를 포함해 이메일을 보내 주세요.