시스템 속성

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

1. 모든 이벤트에 포함되는 시스템 속성

다음 시스템 속성은 SDK의 모든 이벤트에 포함되는 시스템 속성입니다

속성 이름	표시 이름	속성 타입	설명
#ip	IP 주소	텍스트	유저의 IP 주소로, AE는 이를 기반으로 유저의 지리적 위치 정보를 가져옵니다
#country	국가	텍스트	유저가 있는 국가로, IP 주소를 기반으로 생성됩니다
#country_code	국가 코드	텍스트	유저가 있는 국가의 국가 코드(ISO 3166-1 alpha-2, 즉 영문 대문자 2자리)로, IP 주소를 기반으로 생성됩니다
#province	성(Province)	텍스트	유저가 있는 성/주로, IP 주소를 기반으로 생성됩니다
#city	도시	텍스트	유저가 있는 도시로, IP 주소를 기반으로 생성됩니다
#os_version	OS 버전	텍스트	iOS 11.2.2, Android 8.0.0 등
#manufacturer	디바이스 제조사	텍스트	유저 디바이스의 제조사(예: Apple, vivo 등)
#os	운영 체제	텍스트	예: Android, iOS 등
#device_id	디바이스 ID	텍스트	유저의 디바이스 ID. iOS는 유저의 IDFV 또는 UUID, Android는 androidID를 사용
#app_version	APP 버전	텍스트	APP의 버전
#bundle_id	앱 고유 식별자	텍스트	앱 패키지명 또는 프로세스명
#lib	SDK 타입	텍스트	연동한 SDK의 타입(예: Android, iOS 등)
#lib_version	SDK 버전	텍스트	연동한 SDK의 버전
#zone_offset	시간대 오프셋	숫자	데이터 시간과 UTC 시간의 차이(시간 단위)
#install_time	앱 설치 시간	시간	유저가 앱을 설치한 시간으로, 값은 시스템에서 가져옵니다
#system_language	시스템 언어	텍스트	유저 디바이스의 시스템 언어(ISO 639-1, 즉 영문 소문자 2자리), 예: zh, en 등

2. 기타 시스템 속성

위에서 언급한 시스템 속성 외에도 일부 시스템 속성은 해당 인터페이스를 호출해야 기록됩니다.

속성 이름	표시 이름	속성 타입	설명
#duration	이벤트 지속 시간	숫자	타이머 기능 인터페이스 timeEvent:를 호출해야 하며, 이벤트 소요 시간을 기록합니다. 단위는 초입니다
#background_duration	백그라운드 체류 시간	숫자	타이머 기능 인터페이스 timeEvent를 호출해야 하며, 이벤트 발생 구간 동안 앱이 백그라운드에 머문 시간을 기록합니다. 단위는 초입니다

3. 시스템 속성 가져오기

getPresetProperties 메서드를 호출하여 시스템 속성을 가져올 수 있습니다.

서버 측 트래킹에 App 측의 일부 시스템 속성이 필요한 경우 이 메서드로 App 측의 시스템 속성을 가져와 서버 측에 전달할 수 있습니다.

Objective-C

//속성 객체 가져오기
TDPresetProperties *presetProperties = [TDAnalytics getPresetProperties];

//이벤트 시스템 속성 생성
NSDictionary *properties = [presetProperties toEventPresetProperties];
/*
   {
        "#os": "OSX",
        "#device_id": "A8B1C00B-A6AC-4856-8538-0FBC642C1BAD",
        "#bundle_id": "com.sw.thinkingdatademo",
        "#manufacturer": "Apple",
        "#system_language": "zh",
        "#os_version": "10",
        "#zone_offset": 8,
        "#app_version":"1.0.0"
    }
*/

//특정 시스템 속성 가져오기
NSString *bundle_id = presetProperties.bundle_id;//패키지명
NSString *os = presetProperties.os;//OS 타입(예: OSX)
NSString *system_language = presetProperties.system_language;//시스템 언어 타입
NSString *os_version = presetProperties.os_version;//시스템 버전 번호
NSNumber *zone_offset = presetProperties.zone_offset;//시간대 오프셋

Swift

let presetProperties = TDAnalytics.getPresetProperties();

//이벤트 시스템 속성 생성
let properties = presetProperties.toEventPresetProperties();

//특정 시스템 속성 가져오기
let bundle_id = presetProperties.bundle_id;//패키지명
let os = presetProperties.os;//OS 타입(예: OSX)
let system_language = presetProperties.system_language;//시스템 언어 타입
let os_version = presetProperties.os_version;//시스템 버전 번호
let zone_offset = presetProperties.zone_offset;//시간대 오프셋 값

IP, 국가, 도시 정보는 서버 측에서 해석하여 생성하며, 클라이언트에서는 이러한 속성을 가져오는 인터페이스를 제공하지 않습니다