개요
필요한 것
- Strategy API 키. Aftersell에서 Settings → Product Strategy로 이동한 뒤 Security Token 카드에서 토큰을 복사하세요 (이것이 Strategy API 키예요).
- Strategy ID. Aftersell Strategy 편집기에서 실행할 Strategy를 열고 ID를 복사하세요.
- Upcart에서 업셀 모듈 활성화. 이 스크립트는 기존 업셀 블록에 표시되는 상품 목록을 재정의하므로, 무언가 렌더링되려면 모듈이 켜져 있어야 해요.
스크립트 추가하기
STRATEGY_ID와 STRATEGY_API_KEY를 Aftersell의 값으로 교체한 다음 저장하세요.
Strategy가 보는 것
상품 컨텍스트
카트 컨텍스트
- 소계 - 스토어의 주요 통화 단위(예: 달러) 기준 카트 소계. Upcart의
total_price는 보조 단위(센트)이므로, 스크립트가 100으로 나눠서 Strategies API의 나머지 부분이 사용하는 단위 - 그리고cart_subtotal규칙을 작성한 단위 - 와 맞춰요. - 아이템 수 - 모든 라인의 총 수량.
- 라인 수 - 서로 다른 라인 아이템의 개수.
세션 컨텍스트
- 통화 코드 -
window.Shopify.currency.active에서 가져와요.
Strategy가 반환할 때 일어나는 일
상품이 반환되지 않을 때
카트 변경 시 재평가
cartUpdated 이벤트를 구독하고, 새 카트를 Strategies API로 전송한 다음, 새 업셀 목록으로 카트 드로어를 새로고침해요.
카트 시그니처 검사는 라인 아이템과 수량이 실제로 변경되지 않은 경우 중복 호출을 건너뛰므로, 카트를 실질적으로 변경하지 않는 연속된 카트 이벤트가 API를 다시 호출하지 않아요.
Upcart Strategy를 위한 팁
- 카트를 중심으로 설계하세요. 카트 형태와 상품 트리거가 여기서 가장 강력한 신호예요. 고객 히스토리와 UTM 기반 타기팅은 기본 스크립트에서 전송되지 않아요.
- Catch all을 안전망으로 사용하세요. Catch all이 없으면 어떤 규칙도 매칭되지 않을 때 업셀 모듈에 아무것도 표시되지 않아요.
- 기본적으로 캐시 친화적이에요. 카트 시그니처 가드는 카트가 실질적으로 변경되지 않았을 때 API 재호출을 방지해요 - 카트를 편집하지 않고 열고 닫기만 반복하는 쇼핑객에게 좋아요.