시스템 속성

최근 업데이트 2026. 08. 27.

1. 시스템 속성 설명

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

iOS 플랫폼 시스템 속성, Android 플랫폼 시스템 속성

2. 시스템 속성 가져오기

v2.0.1 이상 버전에서는 getPresetProperties() 메서드를 호출하여 시스템 속성을 가져올 수 있습니다.

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

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

//이벤트 시스템 속성 생성
Map<String, dynamic>? eventPresetProperties = presetProperties.toEventPresetProperties();
/*
   {
  "#carrier": "中国电信",
  "#os": "iOS",
  "#device_id": "A8B1C00B-A6AC-4856-8538-0FBC642C1BAD",
  "#screen_height": 2264,
  "#bundle_id": "com.sw.thinkingdatademo",
  "#manufacturer": "Apple",
  "#device_model": "iPhone7",
  "#screen_width": 1080,
  "#system_language": "zh",
  "#os_version": "10",
  "#network_type": "WIFI",
  "#zone_offset": 8
    }
*/

//특정 시스템 속성 가져오기
String bundleId = presetProperties.bundleId;//패키지명
String os = presetProperties.os;//os 타입(예: Android, iOS)
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, Apple)
String networkType = presetProperties.networkType;//네트워크 타입
String osVersion = presetProperties.osVersion;//시스템 버전 번호
double zoneOffset = presetProperties.zoneOffset;//시간대 오프셋 값

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