Skip to main content

JavaScript 브라우저 스토리지

NetFUNNEL JavaScript 에이전트에서는 진입 키를 브라우저 저장소에 저장합니다. 이 문서는 브라우저 저장소와 관련된 기능을 설정하는 방법을 안내합니다.

1. 브라우저 저장소 선택 기능

진입 키를 브라우저에 저장할 때 저장소 타입을 설정하는 기능입니다. 기본적으로 cookie와 session storage 모두 사용하지만, 특정 상황에서는 하나의 저장소만 사용하도록 제한할 수 있습니다.

1.1 저장소 타입별 특징

저장소 타입특징데이터 유지 기간사용 사례

cookie

서버와 공유

1일

브라우저를 종료하더라도 진입 키를 유지해야하는 경우

session storage

탭 별로 저장

탭 종료 시까지

탭 별로 독립적인 세션 관리가 필요한 경우

both

기본값

-

일반적인 경우 (권장)

1.2 설정 방법

<html>
  <head>
    <script src="{{AGENT_URL}}" data-nf-use-storage-type="both" data-nf-client-id="{CLIENT_ID}"></script>
  </head>
</html>
warning

data-nf-use-storage-type="session" 설정 시 대기 순번 유지와 진입 패스 기능이 원활하게 동작하지 않을 경우가 있습니다.

NetFUNNEL JavaScript 에이전트는 진입 키를 쿠키에 저장할 때, 현재 페이지의 도메인을 기준으로 저장합니다.

예를 들어, URL이 www.example.com로 시작하는 페이지에서 진입 키를 저장한다면 쿠키의 도메인 값은 www.example.com로 저장됩니다.

만약 진입 요청(nfStart, nfStartSection)하는 페이지의 도메인과 진입 키를 반납(nfStop, nfStopSection)하는 페이지의 서브도메인이 다르다면 쿠키를 공유하도록 설정해야 합니다.

쿠키 도메인 설정 기능을 통해 서브도메인은 다르고 메인도메인이 같은 경우 쿠키를 공유할 수 있습니다.

tip

예를 들어, .stclab.com으로 값을 설정했다면 www.stclab.com과 api.stclab.com과 같은 모든 하위 도메인 간에 쿠키를 공유할 수 있습니다.

<html>
  <head>
    <script src="{{AGENT_URL}}" data-nf-custom-cookie-domain="{{.MAIN_DOMAIN}}" data-nf-client-id="{CLIENT_ID}"></script>
  </head>
</html>