프리셋 속성

1. 모든 이벤트에 포함되는 프리셋 속성

다음 프리셋 속성은 SDK에서 모든 이벤트(자동 수집 이벤트 포함)에 포함되는 속성입니다.

속성 이름	이름	유형	설명
#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	스크린 높이	숫자	유저의 디바이스 스크린 높이
#screen_width	스크린 너비	숫자	유저의 디바이스 스크린 너비
#device_model	디바이스 모델	문자열	아이폰 8 등의 유저 디바이스의 모델
#device_type	디바이스 유형	문자열	디바이스 유형: "Tablet", "Phone" 등
#app_version	앱 버전	문자열	앱 버전
#bundle_id	앱 패키지 명	문자열	앱 패키지명 또는 프로세스명
#lib	SDK 유형	문자열	SDK 유형: Android, iOS 등
#lib_version	SDK 버전	문자열	SDK 버전
#network_type	네트워크 유형	문자열	데이터 전송 시의 네트워크 상태 (WIFI, 4G, 5G 등)
#carrier	캐리어	문자열	유저의 디바이스 캐리어 (예: Docomo, Softbank 등)
#zone_offset	시간대 오프셋	숫자	데이터 시간과 UTC 시간의 차이
#install_time	설치 시간	시간	앱 설치 시간
#simulator	시뮬레이터	숫자	디바이스가 시뮬레이터인지 여부 (true/false)
#ram	디바이스 RAM 상태	문자열	디바이스의 현재 남은 RAM과 총 RAM (GB 단위)
#disk	디바이스의 스토리지 상태	문자열	디바이스의 현재 남은 저장소와 총 저장소 (GB 단위)
#fps	프레임 레이트	숫자	디바이스의 현재 화면 프레임 레이트 : 60
#system_language	시스템 언어	문자열	유저의 디바이스 시스템 언어 (ISO 639-1)

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

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

• ta_mp_show의 프리셋 속성

속성 이름	이름	유형	정의
#url_path	페이지 경로	문자열	해당 페이지의 경로

- ta_mp_hide의 프리셋 속성

속성 이름	이름	유형	정의
#duration	이벤트 경과 시간	숫자	ta_mp_show부터 ta_mp_hide까지의 시간 경과. 단위: 초

- ta_mp_view의 프리셋 속성

속성 이름	이름	유형	정의
#url_path	페이지 경로	문자열	해당 페이지의 경로
#referrer	리퍼러 URL	문자열	이전 페이지의 URL

- ta_mp_share의 프리셋 속성

속성 이름	이름	유형	정의
#url_path	경로 분석	문자열	해당 페이지의 경로

3. 프리셋 속성 가져오기

다음 방법으로 서버의 트래킹은 앱 측의 일부 프리셋 속성을 가져와 서버로 전송할 수 있습니다.

// 속성 객체 가져오기
var presetProperties = ta.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 타입
var osVersion = presetProperties.osVersion; // 시스템 버전 번호
var networkType = presetProperties.networkType; // 네트워크 타입
var manufacturer = presetProperties.manufacturer; // 휴대폰 제조사, 예: Huawei
var deviceModel = presetProperties.deviceModel; // 디바이스 모델
var screenWidth = presetProperties.screenWidth; // 스크린 너비
var screenHeight = presetProperties.screenHeight; // 스크린 높이
var deviceId = presetProperties.deviceId; // 디바이스의 고유 식별자
var zoneOffset = presetProperties.zoneOffset; // 타임존 오프셋 값

IP와 국가 도시는 서버 측에서 분석되어 생성되며, 클라이언트에서 호출할 수 없습니다.