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

# 특정 국가에서 리워드 바 숨기기

> 커스텀 HTML과 CSS를 사용해 고객 위치에 따라 리워드 바를 표시하거나 숨기세요.

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

특정 지역에서만 리워드를 제공하는 경우, JavaScript와 CSS를 조합해 특정 국가의 고객에게 리워드 바를 숨길 수 있어요. 이렇게 하면 쇼핑객이 어디에서 접속하든 장바구니를 깔끔하고 관련성 있게 유지할 수 있어요.

**참고:**

숨겨진 상태에서도 리워드 로직은 백그라운드에서 계속 실행돼요. 예를 들어 바가 보이지 않더라도 조건이 충족되면 무료 증정품이 장바구니에 추가될 수 있어요.

***

<div id="step-1-find-your-target-country-codes">
  ## 1단계: 대상 국가 코드 찾기
</div>

어떤 국가에서 리워드 바를 표시할지 정의해야 해요. 코드를 찾으려면 Shopify의 **ISO 2자리 국가 코드** 목록을 참고하세요.

**예시:**

* `US` → 미국
* `CA` → 캐나다
* `MX` → 멕시코

***

<div id="step-2-add-custom-html">
  ## 2단계: 커스텀 HTML 추가
</div>

1. **Upcart > Cart Editor > Settings > Custom HTML**로 이동하세요
2. 다음 코드를 아래 두 위치 **모두**에 붙여넣으세요:

   * Above announcements/rewards
   * On empty cart

`"US"`를 원하는 국가 코드로 교체하세요.

```
<script>  
  function hideRewards() {  
    let rewardsBar = window.upcartDocumentOrShadowRoot.querySelector(".upcart-rewards");  
    let country = window.Shopify.country;  
  
    if (country.includes("US")) {  
      rewardsBar.classList.remove("hide");  
      return;  
    }  
  
    rewardsBar.classList.add("hide");  
  }  
  
  window.upcartSubscribeCartOpened(() => setTimeout(hideRewards, 300));  
  window.upcartSubscribeCartLoaded(hideRewards);  
</script>
```

<Note>
  **레거시 참고:** `window.upcartOnCartOpened`와 `window.upcartOnCartLoaded` 콜백은 여전히 작동하지만 더 이상 사용되지 않으며(deprecated) 콘솔 경고를 기록해요. 모든 새 스크립트에는 `upcartSubscribeCartOpened`와 `upcartSubscribeCartLoaded`를 사용하세요.
</Note>

<div id="alternative-code-for-rewards-v20-version">
  ## Rewards V2.0 버전용 대체 코드
</div>

리워드를 V2 버전으로 업그레이드하셨다면, 리워드 선택자가 새로운 `.upcart-public-rewards` 선택자로 교체되어 코드가 약간 달라요. 단계별 리워드 모듈을 업그레이드하셨다면 아래 코드를 사용하세요

```
<script>  
  function hideRewards() {  
    let rewardsBar = window.upcartDocumentOrShadowRoot.querySelector(".upcart-public-rewards");  
    let country = window.Shopify.country;  
  
    if (country.includes("US")) {  
      rewardsBar.classList.remove("hide");  
      return;  
    }  
  
    rewardsBar.classList.add("hide");  
  }  
  
  window.upcartSubscribeCartOpened(() => setTimeout(hideRewards, 300));  
  window.upcartSubscribeCartLoaded(hideRewards);  
</script>
```

여러 국가를 지원하려면 조건을 다음과 같이 조정하세요:

```
if (["US", "CA", "GB"].includes(country)) {
```

***

<div id="step-3-add-custom-css">
  ## 3단계: 커스텀 CSS 추가
</div>

1. **Upcart > Cart Editor > Settings > Custom CSS**로 이동하세요
2. 표시 여부를 제어하기 위해 이 코드를 붙여넣으세요:

```
.hide {  
  display: none;   
}
```

***

<div id="final-result">
  ## 최종 결과
</div>

제외된 국가의 고객은 장바구니에서 리워드 바를 볼 수 없지만, 리워드 로직은 백그라운드에서 계속 작동해요.

다음과 같은 경우에 이 방법을 사용하세요:

* 특정 시장에서만 리워드를 제공하는 경우
* 적용되지 않는 프로모션의 표시를 피하고 싶은 경우
* 제대로 된 지역 기반 로직을 설정하기 전에 단기적인 해결책이 필요한 경우

***

<div id="need-help">
  ## 도움이 필요하신가요?
</div>

고급 지역 로직이나 JavaScript 지원이 필요하면 **Shopify Expert**와 함께 작업하시는 것을 권장해요. Upcart 지원팀은 커스텀 코드 작성이나 문제 해결을 지원하지 않아요.

[Shopify Experts 보기](https://www.shopify.com/partners/directory)
