시스템 속성

최근 업데이트 2026. 10. 03.

1. 시스템 속성 설명

플랫폼마다 수집하는 시스템 속성에는 다소 차이가 있습니다. 자세한 내용은 다음 문서를 참고하십시오: Android 플랫폼, iOS 플랫폼

비 Native 플랫폼(PC)의 시스템 속성:

속성 이름	한국어 이름	속성 타입	설명
#ip	IP 주소	텍스트	유저의 IP 주소로, AE는 이를 기반으로 유저의 지리적 위치 정보를 가져옵니다
#country	국가	텍스트	유저가 있는 국가로, IP 주소를 기반으로 생성됩니다
#country_code	국가 코드	텍스트	유저가 있는 국가의 국가 코드(ISO 3166-1 alpha-2, 즉 영문 대문자 2자리)로, IP 주소를 기반으로 생성됩니다
#province	성(Province)	텍스트	유저가 있는 성/주로, IP 주소를 기반으로 생성됩니다
#city	도시	텍스트	유저가 있는 도시로, IP 주소를 기반으로 생성됩니다
#os_version	OS 버전	텍스트	예: windows10
#os	운영 체제	텍스트	예: MacOS, Windows 등
#device_id	디바이스 ID	텍스트	유저의 디바이스 ID
#screen_height	화면 높이	숫자	유저 디바이스의 화면 높이(예: 1920 등)
#screen_width	화면 너비	숫자	유저 디바이스의 화면 높이(예: 1080 등)
#app_version	APP 버전	텍스트	APP의 버전
#lib_version	SDK 버전	텍스트	연동한 SDK의 버전
#zone_offset	시간대 오프셋	숫자	데이터 시간과 UTC 시간의 차이(시간 단위)
#system_language	운영 체제 언어	텍스트	유저가 사용하는 시스템에 설정된 언어(예: zh)
#install_time	설치 시간	시간	유저가 앱을 설치한 시간
#fps	프레임 레이트	텍스트	현재 화면 프레임 레이트
#disk	디스크 상태	텍스트	현재 스토리지 사용량 "남은 공간/전체 공간"
#ram	메모리 상태	텍스트	현재 메모리 사용량 "남은 메모리/전체 메모리"

노트

3.0.0 이상 버전에서는 내부적으로 C++ SDK를 사용하므로 #install_time, #app_version, #os_version, #fps, #ram, #disk 시스템 속성을 당분간 수집할 수 없습니다. 이러한 시스템 속성이 필요하면 3.0.0 이전 버전을 사용할 수 있습니다

2. 시스템 속성 가져오기

v1.3.0 버전에서 시스템 속성 가져오기 인터페이스가 추가되었습니다. SDK는 이벤트 속성을 전송할 때 일부 내장 속성을 자동으로 추가하며, 이 인터페이스로 시스템 속성을 가져올 수 있습니다.

FString PresetProperties = UTDAnalytics::GetPresetProperties();