시스템 속성

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

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

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

미니 게임 플랫폼의 모든 이벤트에 포함되는 시스템 속성:

속성 이름	한국어 이름	속성 타입	설명
#ip	IP 주소	텍스트	유저의 IP 주소로, AE는 이를 기반으로 유저의 지리적 위치 정보를 가져옵니다
#country	국가	텍스트	유저가 있는 국가로, IP 주소를 기반으로 생성됩니다
#country_code	국가 코드	텍스트	유저가 있는 국가의 국가 코드(ISO 3166-1 alpha-2, 즉 영문 대문자 2자리)로, IP 주소를 기반으로 생성됩니다
#province	성(Province)	텍스트	유저가 있는 성/주로, IP 주소를 기반으로 생성됩니다
#city	도시	텍스트	유저가 있는 도시로, IP 주소를 기반으로 생성됩니다
#device_model	디바이스 모델	텍스트	유저 디바이스의 모델(예: iPhone 8 등)
#device_id	디바이스 ID	텍스트	유저의 디바이스 ID로, 초기화 시 생성한 UUID를 사용합니다
#screen_height	화면 높이	숫자	유저 디바이스의 화면 높이(예: 1920 등)
#screen_width	화면 너비	숫자	유저 디바이스의 화면 높이(예: 1080 등)
#manufacturer	디바이스 제조사	텍스트	유저 디바이스의 제조사(예: Apple, vivo 등)
#os_version	OS 버전	텍스트	iOS 11.2.2, Android 8.0.0 등
#os	운영 체제	텍스트	예: Android, iOS 등
#network_type	네트워크 상태	텍스트	이벤트를 업로드할 때의 네트워크 상태(예: WIFI, 3G, 4G 등)
#lib	SDK 타입	텍스트	연동한 SDK의 타입(예: MG(미니 게임))
#lib_version	SDK 버전	텍스트	연동한 SDK의 버전
#scene	시나리오 값	숫자	위챗 미니 게임 시작 시 전달되는 장면 값
#mp_platform	미니 게임 플랫폼	텍스트	앱이 실행되는 플랫폼을 식별합니다
#zone_offset	시간대 오프셋	숫자	데이터 시간과 UTC 시간의 차이(시간 단위)

2. 자동 수집 이벤트의 시스템 속성

다음 시스템 속성은 각 자동 수집 이벤트에만 있는 시스템 속성입니다

• 미니 게임 시작(ta_mg_show)의 시스템 속성

속성 이름	한국어 이름	속성 타입	설명
#url_path	페이지 경로	텍스트	미니 게임 시작 시 표시되는 페이지의 경로
#start_reason	앱 시작 출처	텍스트	JSON 문자열로, getLaunchOptionsSync 인터페이스에서 가져온 파라미터입니다

• 미니 게임 숨김(ta_mg_hide)의 시스템 속성

속성 이름	한국어 이름	속성 타입	설명
#duration	이벤트 지속 시간	숫자	이번 시작 ta_mg_show부터 숨김 ta_mg_hide까지의 지속 시간으로, 단위는 초입니다

3. 시스템 속성 가져오기

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

//속성 객체 가져오기
var presetProperties = TDAnalytics.getPresetProperties();
//이벤트 시스템 속성 생성
var properties = presetProperties.toEventPresetProperties();
/*
      {
         "#device_model":"iPhone 5",
         "#device_id":"3204487163-1624513721217",
         "#screen_width":320,
         "#screen_height":568,
         "#os":"iOS",
         "#os_version":"10.0.1",
         "#network_type":"wifi",
         "#zone_offset":8,
         "#manufacturer":"Apple"
       }
 */
//특정 시스템 속성 가져오기
var os=presetProperties.os;//os 타입(예: Android)
var osVersion=presetProperties.osVersion;//시스템 버전 번호
var networkType=presetProperties.networkType;//네트워크 타입
var manufacture=presetProperties.manufacturer;//디바이스 제조사
var deviceModel=presetProperties.deviceModel;//디바이스 모델
var screenWidth=presetProperties.screenWidth;//화면 너비
var screenHeight=presetProperties.screenHeight;//화면 높이
var deviceId=presetProperties.deviceId;//디바이스 ID
var zoneOffset=presetProperties.zoneOffset;//시간대 오프셋 값

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