Preset Properties

1. Preset Properties of All Events

All Events in macOS SDK would have the following preset property.

2. Other Preset Properties

In addition to the Preset properties above, some preset properties would only be recorded after corresponding API is called:

Property name	Display name	Property type	Instruction
#duration	Event duration	Numeric value	Timing function timeEvent should be invoked to record the event duration (Unit: second)
#background_duration	Background duration	numeric value	Timing function timeEvent should be called to record the background duration within an event interval (Unit: second)

Getting Preset Properties

When some preset properties of the APP is required for Server data tracking, this method can be invoked to get the preset properties of the APP and then send them to the server

//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, nation and city information are parsed and generated by the server. The client shall not provide the interface to get such properties

4. Disable preset property tracking

Under certain scenarios, you may want to forbid tracking certain preset properties to ensure compliance and meet actual business requirements. Add TDDisPresetProperties field of array type in the info.plist, Add the prefab properties that need to be masked to this field. e.g., "#fps", @"#ram", @"#disk", @"#start_reason", @"#simulator", the configuration is as follows: