세션 관리

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

세션 시작 조건

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

• 식별자가 변경된 경우

• 세션 만료 시간이 지난 후 이벤트가 발생한 경우

세션 만료 조건

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

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

세션 정책 (Session Policy)

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

세션 유지 조건 (Persist Condition)

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

구분	설명	기본값
alwaysNewSession	식별자가 변경되면 항상 새로운 세션을 시작합니다.	default
nullToUserId	userId가 null에서 특정 값으로 변경될 때 (로그인 시) 기존 세션을 유지합니다. 그 외의 식별자 변경 시 새로운 세션을 시작합니다.	-

세션 만료 조건 (Timeout Condition)

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

설정	설명	기본값
timeout	세션 만료 시간입니다.	1800초 (30분)
onForeground	foreground에서 이벤트 발생 시 타임아웃 체크 여부입니다.	false
onBackground	background에서 이벤트 발생 시 타임아웃 체크 여부입니다.	true
onApplicationStateChange	앱 상태 변경 (foreground <-> background) 시 타임아웃을 체크합니다.	true

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