시스템 속성

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

1. 시스템 속성 설명

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

2. 시스템 속성 가져오기

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

-- 속성 객체 가져오기
local presetProperties = TDAnalytics.getPresetProperties()

-- 이벤트 시스템 속성 생성
local 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"
    }
]]--

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

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