세션 관리

세션(Session)은 사용자의 연속된 앱 사용 구간을 의미하며, 특정 조건에 따라 시작되고 만료됩니다.

세션 시작 조건

세션은 기본적으로 아래 조건으로 시작됩니다.

  • 식별자가 변경된 경우
  • 세션 만료 시간이 지난 후 이벤트가 발생한 경우

세션 만료 조건

새로운 세션이 시작될 때 이전 세션은 만료됩니다.

  • 세션 만료 시각은 마지막 이벤트 발생 시간과 동일합니다.

세션 정책 (Session Policy)

세션 정책은 세션의 유지 조건과 만료 조건을 세밀하게 제어할 수 있는 기능입니다.
세션 정책은 두 가지 조건으로 구성됩니다.

세션 유지 조건 (Persist Condition)

식별자가 변경될 때 기존 세션을 유지할지, 새로운 세션을 시작할지 결정합니다.

구분

기본값

설명

alwaysNewSession

default

식별자가 변경되면 항상 새로운 세션을 시작합니다.

nullToUserId

userId가 null에서 특정 값으로 변경될 때 (로그인 시) 기존 세션을 유지합니다.
그 외의 식별자 변경 시 새로운 세션을 시작합니다.

세션 만료 조건 (Timeout Condition)

세션이 만료되는 조건을 설정합니다.

설정

기본값

설명

timeout

1800초
(30분)

세션 만료 시간입니다.

onForeground

false

foreground에서 이벤트 발생 시 타임아웃 체크 여부입니다.

onBackground

true

background에서 이벤트 발생 시 타임아웃 체크 여부입니다.

onApplicationStateChange

true

앱 상태 변경 (foreground <-> background) 시 타임아웃을 체크합니다.

📘

세션 정책의 구체적인 설정 코드는 각 SDK의 SDK 연동 문서를 참고하세요.