시스템 속성

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

1. 시스템 속성 설명

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

PC 플랫폼 시스템 속성:

속성 이름	한국어 이름	속성 타입	설명
#ip	IP 주소	텍스트	유저의 IP 주소로, AE는 이를 기반으로 유저의 지리적 위치 정보를 가져옵니다
#country	국가	텍스트	유저가 있는 국가로, IP 주소를 기반으로 생성됩니다
#country_code	국가 코드	텍스트	유저가 있는 국가의 국가 코드(ISO 3166-1 alpha-2, 즉 영문 대문자 2자리)로, IP 주소를 기반으로 생성됩니다
#province	성(Province)	텍스트	유저가 있는 성/주로, IP 주소를 기반으로 생성됩니다
#city	도시	텍스트	유저가 있는 도시로, IP 주소를 기반으로 생성됩니다
#os	운영 체제	텍스트	예: MacOS, Windows 등
#device_id	디바이스 ID	텍스트	유저의 디바이스 ID
#screen_height	화면 높이	숫자	유저 디바이스의 화면 높이(예: 1920 등)
#screen_width	화면 너비	숫자	유저 디바이스의 화면 높이(예: 1080 등)
#lib	SDK 타입	텍스트	연동한 SDK의 타입(예: Android, iOS 등)
#lib_version	SDK 버전	텍스트	연동한 SDK의 버전
#zone_offset	시간대 오프셋	숫자	데이터 시간과 UTC 시간의 차이(시간 단위)
#system_language	시스템 언어	텍스트	유저 디바이스의 시스템 언어(ISO 639-1, 즉 영문 소문자 2자리), 예: zh, en 등

2. 시스템 속성 가져오기

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

   //속성 객체 가져오기
   TDPresetProperties* presetProperties =  TDAnalytics::getPresetProperties();

   //이벤트 시스템 속성 생성
   TDJSONObject* properties = presetProperties->toEventPresetProperties();
   /*
   {
        "#carrier": "中国电信",
        "#os": "Android",
        "#device_id": "abb8e87bfb5ce66c",
        "#screen_height": 2264,
        "#bundle_id": "com.sw.thinkingdatademo",
        "#manufacturer": "realme",
        "#device_model": "RMX1991",
        "#screen_width": 1080,
        "#system_language": "zh",
        "#os_version": "10",
        "#network_type": "WIFI",
        "#zone_offset": 8,
        "#app_version":"1.0"
    }
   */

    //특정 시스템 속성 가져오기
    string bundleId = presetProperties->bundleId;//패키지명
    string os =  presetProperties->os;//os 타입(예: Android)
    string systemLanguage = presetProperties->systemLanguage;//휴대폰 시스템 언어 타입
    int screenWidth = presetProperties->screenWidth;//화면 너비
    int screenHeight = presetProperties->screenHeight;//화면 높이
    string deviceModel = presetProperties->deviceModel;//디바이스 모델
    string deviceId = presetProperties->deviceId;//디바이스 고유 식별자
    string carrier = presetProperties->carrier;//휴대폰 SIM 카드 통신사 정보(듀얼 SIM인 경우 기본 SIM의 통신사 정보를 가져옴)
    string manufacture = presetProperties->manufacturer;//휴대폰 제조사(예: HuaWei)
    string networkType = presetProperties->networkType;//네트워크 타입
    string osVersion = presetProperties->osVersion;//시스템 버전 번호
    string appVersion = presetProperties->appVersion;//app 버전 번호
    double zoneOffset = presetProperties->zoneOffset;//시간대 오프셋 값

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