DOCS

국가 재정의 동작

Hello가 쇼퍼가 선택한 국가를 기억하는 방식을 제어하세요.

쇼퍼가 Hello 위젯에서 다른 국가를 선택하면 Zonos는 사이트를 탐색하는 동안 그 선택을 기억해야 합니다. helloSettings의 countryOverrideBehavior 설정이 국가 선택을 유지하는 방식을 제어합니다.

사용 가능한 옵션 

옵션↕설명↕
URL_PARAM선택한 국가를 URL 쿼리 문자열에 ?zCountry=XX 형태로 유지합니다. 이를 통해 국가별 URL을 공유하고 북마크할 수 있습니다. URL은 페이지를 새로고침하지 않고 window.history.replaceState()로 업데이트됩니다.
SESSION선택한 국가를 브라우저의 세션 스토리지에 zonos--country 키로 유지합니다. 쇼퍼가 사이트를 탐색하는 동안에는 선택이 유지되지만, 브라우저 탭이나 세션이 종료되면 사라집니다.

기본값은 URL_PARAM입니다.

국가 재정의 동작 구성 

Zonos.init 호출의 helloSettings에서 countryOverrideBehavior 속성을 설정합니다.

1Zonos.init({
2 // ... other settings
3 helloSettings: {
4 countryOverrideBehavior: 'URL_PARAM',
5 },
6});

각 옵션을 사용하는 경우 

URL_PARAM

  • 쇼퍼가 국가별 링크를 다른 사람과 공유하기를 원하는 경우.
  • 검색 엔진이 국가별 페이지를 색인하기를 원하는 경우.
  • 선택한 국가가 페이지를 새로고침해도 유지되기를 원하는 경우.

SESSION

  • 쿼리 매개변수가 없는 깔끔한 URL을 선호하는 경우.
  • 현재 브라우저 세션을 넘어서까지 국가 선택을 유지할 필요가 없는 경우.
  • 추가 쿼리 매개변수와 충돌할 수 있는 URL 민감 로직이 사이트에 있는 경우.

국가 감지 방식 

Hello는 다음 순서로 선택한 국가를 확인합니다.

  1. URL 매개변수 - URL 쿼리 문자열에서 zCountry를 찾습니다. 이전 버전과의 호환을 위한 매개변수인 country와 customerCountry도 대체 값으로 지원합니다.
  2. 세션 스토리지 - URL 매개변수가 없으면 sessionStorage에서 zonos--country 키를 확인합니다.
  3. 위치 정보(Geolocation) - 둘 다 설정되어 있지 않으면 Hello는 감지된 쇼퍼의 위치를 사용합니다.

선택한 countryOverrideBehavior와 관계없이, 쇼퍼가 선택을 하면 국가는 항상 세션 스토리지에 저장됩니다. 이 설정은 URL도 함께 업데이트할지 여부만 제어합니다.

이 페이지가 도움이 되었나요?