프리셋 속성

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	스크린 높이	숫자	유저 디바이스의 스크린 높이, 예: 1920 등
#screen_width	스크린 길이	숫자	유저 디바이스의 스크린 길이, 예: 1080 등
#device_model	디바이스 모델	문자열	iPhone 8 등의 사용자 디바이스 모델
#device_type	디바이스 타입	문자열	디바이스 타입: "Tablet", "Phone" 등
#app_version	앱 버전	문자열	앱 버전
#bundle_id	앱 패키지 이름（유니크）	문자열	앱 패키지 이름 또는 프로세스 이름
#lib	SDK 유형	문자열	SDK의 타입: Android, iOS 등
#lib_version	SDK 버전	문자열	SDK의 버전
#network_type	네트워크 타입	문자열	데이터 전송 시 네트워크 상태: WIFI, 4G, 5G 등
#carrier	통신사	문자열	유저 디바이스의 통신사: SK, KT, LG 등
#zone_offset	시간대	숫자	데이터 시간 UTC 시간과의 차이 시간 수
#install_time	설치 시간	시간	앱의 설치 시간
#simulator	시뮬레이터	숫자	디바이스가 시뮬레이터인지 true/false
#ram	디바이스의 ram 상태	문자열	유저 디바이스의 현재 남은 ram과 총 ram, 단위는 GB, 예: 1.4/2.4
#disk	디바이스의 스토리지 상태	문자열	유저 디바이스의 현재 남은 스토리지와 총 스토리지, 단위는 GB 예: 30/200
#fps	디바이스의 프레임레이트	숫자	유저 디바이스의 현재 화면의 프레임레이트: 60
#system_language	시스템 언어	문자열	유저 디바이스의 시스템 언어(ISO 639-1) 예: kr, en 등

2. 기타 프리셋 속성

위에서 언급된 프리셋 속성 외에, 호출 후 기록되는 프리셋 속성:

속성 이름	이름	유형	설명
#duration	타임 아웃	숫자	timeEvent 함수를 호출하여, 이벤트의 경과 시간을 기록합니다. 단위는 초
#background_duration	백그라운드의 경과 시간	숫자	timeEvent 함수를 호출하여, 이벤트의 경과 시간을 기록합니다. 단위는 초

3. 프리셋 속성 획득

getPresetProperties()를 호출하여 프리셋 속성을 가져올 수 있습니다.

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

//get property objects
TDPresetProperties *presetProperties = [instance getPresetProperties];

//Preset properties of Event
NSDictionary *properties = [presetProperties toEventPresetProperties];
/*
   {
        "#os": "iOS",
        "#device_id": "A8B1C00B-A6AC-4856-8538-0FBC642C1BAD",
        "#bundle_id": "com.sw.thinkingdatademo",
        "#manufacturer": "Apple",
        "#device_model": "iPhone7",
        "#system_language": "zh",
        "#os_version": "10",
        "#network_type": "WIFI",
        "#zone_offset": 8,
        "#app_version":"1.0.0"
    }
*/

//get a certain preset properties
NSString *bundle_id = presetProperties.bundle_id; //app bundle id
NSString *os = presetProperties.os;//os type, e.g., MacOS
NSString *system_language = presetProperties.system_language; //type of mobile phone system language
NSString *os_version = presetProperties.os_version; //system version number
NSNumber *zone_offset = presetProperties.zone_offset; //timezone offset value
NSString *app_version = presetProperties.app_version; //app version number

let presetProperties = instance.getPresetProperties();

//Preset properties of Event
let properties = presetProperties.toEventPresetProperties();

//get a certain preset properties
let bundle_id = presetProperties.bundle_id; //app bundle id
let os = presetProperties.os; //os type, e.g., MacOS
let system_language = presetProperties.system_language; //type of mobile phone system language
let os_version = presetProperties.os_version; //system version number
let zone_offset = presetProperties.zone_offset; //timezone offset value
let app_version = presetProperties.app_version; //app version number

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

4. 프리셋 속성 수집 금지

SDK는 지정된 프리셋 속성의 보고를 차단할 수 있습니다.

프로젝트의 info.plist 파일에 TDDisPresetProperties 필드를 추가하고, 데이터 타입은 Array로 설정합니다. 추가된 필드에 해당하는 프리셋 속성은 업로드되지 않습니다.

예를 들어, "#fps", @"#ram", @"#disk", @"#start_reason", @"#simulator" 등의 프리셋 속성을 수집하지 않으려면, 아래 그림과 같이 설정하세요.

특정 경우에 프리셋 속성 수집을 금지할 수 있습니다. 프로젝트 내의 info.plist 파일에 TDDisPresetProperties 필드(데이터 타입 Array)를 추가함으로써, 해당 프리셋 속성은 전송되지 않게 됩니다.

예를 들어 "#fps", @"#ram", @"#disk", @"#start_reason", @"#simulator"를 수집 금지하려면, 아래 그림처럼 설정하세요.