# 프리셋 속성

# 1. 프리셋 속성

iOS, Android에서 수집할 수 있는 프리셋 속성은 아래 문서를 참조해 주세요.

미니 프로그램의 모든 이벤트에 포함되는 프리셋 속성:

속성 이름	이름	타입	설명
#ip	IP 주소	문자열	유저의 IP 주소, TA는 사용자의 지리적 위치 정보
#country	국가	문자열	유저의 국가 또는 지역, IP 주소를 기반으로 생성
#country_code	국가 코드	문자열	유저의 소재 국가 또는 지역의 국가별 지역 코드(ISO 3166-1 alpha-2, 즉 2대문자 영문)는, IP 주소를 기반으로 생성
#province	주	문자열	유저의 주, IP 주소를 기반으로 생성
#city	도시	문자열	유저의 도시는, IP 주소를 기반으로 생성
#os_version	OS 버전	문자열	iOS 11.2.2, Android 8.0.0 등
#manufacturer	디바이스 제조업체	문자열	Apple 등 유저 디바이스의 제조사
#os	OS	문자열	Android, iOS 등
#device_id	디바이스 ID	문자열	유저의 디바이스 ID, iOS는 유저의 IDFV나 UUID, Android는 AndroidID를 획득
#screen_height	스크린 높이	숫자	유저 디바이스의 스크린 높이, 예: 1920
#screen_width	스크린 길이	숫자	유저 디바이스의 스크린 길이, 예: 1080
#device_type	디바이스 타입	문자열	디바이스 타입: "Tablet", "Phone" 등
#app_version	앱 버전	문자열	앱 버전
#bundle_id	앱 패키지 이름（유니크）	문자열	앱 패키지명 또는 프로세스명
#lib	SDK 타입	문자열	SDK의 타입: Android, iOS 등
#lib_version	SDK 버전	문자열	SDK의 버전
#network_type	네트워크 타입	문자열	데이터 전송 시의 네트워크 상태: WIFI, 4G, 5G 등
#zone_offset	시간대	숫자	데이터 시간 UTC 시간과의 편차 시간 수
#install_time	설치 시간	시간	앱의 설치 시간
#simulator	시뮬레이터	숫자	디바이스가 시뮬레이터인지 true/false
#ram	디바이스의 ram 상태	문자열	유저 디바이스의 현재 남은 ram과 총 ram, 단위는 GB, 예: 1.4/2.4
#disk	디바이스의 스토리지 상태	문자열	유저 디바이스의 현재 남은 스토리지와 총 스토리지, 단위는 GB 예: 30/200
#scene	씬	숫자	Wechat 게임이 시작 시 첨부되는 씬 값
#mp_platform	플랫폼	문자열	해당 데이터 플랫폼

# 2. 자동 수집 이벤트의 프리셋 속성

다음 프리셋 속성은 각 자동 수집 이벤트에 특유입니다.

미니게임 숨김(ta_mg_hide)의 프리셋 속성

속성 이름	이름	타입	설명
#duration	경과 시간	숫자	시작(`ta_mg_show`)에서 숨김(`ta_mg_hide`)까지의 경과 시간, 단위는 초

# 3. 프리셋 속성 획득

다음 방법으로 서버의 트래킹은 앱 측의 일부 프리셋 속성을 획득하고, 서버 측으로 전송할 수 있습니다.

//프리셋 속성 객체 획득
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; //OS 버전
var networkType = presetProperties.networkType; //네트워크 타입
var manufacture = presetProperties.manufacture; //디바이스 제조사 이름
var deviceModel = presetProperties.deviceModel; //디바이스 모델
var screenWidth = presetProperties.screenWidth; //스크린 너비
var screenHeight = presetProperties.screenHeight; //스크린 높이
var deviceId = presetProperties.deviceId; //디바이스 ID
var zoneOffset = presetProperties.zoneOffset; //타임존 오프셋

IP, 국가, 도시 정보는 서버 측에서 분석하여 생성되며, 클라이언트 측에서의 호출로 제공되지 않습니다.

← 디버깅 Native 지원 →