プリセットプロパティ

全てのイベントが付帯するプリセットプロパティ

以下のプリセットプロパティはiOS 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	APPバージョン	文字列	APPバージョン
#bundle_id	アプリパッケージ名（ユニーク）	文字列	APPパッケージ名もしくはプロセス名
#lib	SDK タイプ	文字列	SDK のタイプ：Android， iOS など
#lib_version	SDK バージョン	文字列	SDK のバージョン
#network_type	ネットワークタイプ	文字列	データ送信時のネットワーク状態：WIFI、4G、5Gなど
#carrier	キャリア	文字列	ユーザーデバイスのキャリア：Docomo、Softbankなど
#zone_offset	タイムゾーン	数値	データ時間 UTC 時間との偏位時間数
#install_time	インストール時間	時間	APPのインストール時間
#simulator	シミュレーター	数値	デバイスはシミュレーター true/false
#ram	デバイスのram状態	文字列	ユーザーデバイスの現在残りramと総ram、単位はGB、1.4/2.4
#disk	デバイスのストレージ状態	文字列	ユーザーデバイスの現在残りストレージと総ストレージ、単位はGB　30/200
# fps	デバイスのフレームレート	数値	ユーザーデバイスの現在画面のフレームレート：60
#system_language	システム言語	文字列	ユーザーデバイスのシステム言語（ISO 639-1）jp, enなど

自動収集イベントのプリセットプロパティ

以下のプリセットプロパティは、自動収集イベントの中で特有のプリセットプロパティとなります。

• APP 起動イベント（ta_app_start）のプリセットプロパティ

プロパティ名	名称	タイプ	説明
#resume_from_background	バックグラウンドから再開かどうか	文字列	APPの起動は直接起動なのか、バックグラウンドから再開なのか。trueはバックグラウンドから再開で、falseは直接起動となります。

• APP クローズイベント（ta_app_end）的预置属性

プロパティ名	名称	タイプ	説明
#duration	イベント時間経過	数値	APP起動からの時間経過（起動からクローズ）、単位は秒

• APP 閲覧ページイベント（ta_app_view）のプリセットプロパティ

プロパティ名	名称	タイプ	説明
#title	ページタイトル	文字列	viewが属している Activity のタイトルで、 Activity の title プロパティで値を付与されます
#screen_name	ページ名称	文字列	viewが属している Activity のパッケージ名、カテゴリ名
#url	ページURL	文字列	現在ページのURL、 getScreenUrl を呼び出してURLの設定を行う必要があります。
#referrer	リファラー	文字列	本ページに移動する前のURLで、 getScreenUrl を呼び出して設定が必要です。

• APP viewクリックイベント（ta_app_click）のプリセットプロパティ

プロパティ名	名称	タイプ	説明
#title	ページタイトル	文字列	viewが属している Activity のタイトルで、 Activity の title プロパティで値を付与されます
#screen_name	ページ名称	文字列	viewが属している Activity のパッケージ名、カテゴリ名
#element_id	エレメント ID	文字列	viewのID、デフォルトで android:id を使用、 setViewID を呼び出しして設定可能です。
#element_type	エレメントタイプ	文字列	viewのタイプ
#element_selector	エレメントセレクター	文字列	viewの viewPath のスプライシング
#element_position	エレメント位置	文字列	viewの位置情報、viewが position プロパティが存在する時に送信されます
#element_content	エレメント内容	文字列	view上の内容

• APP のクラッシュイベント（ta_app_crash）のプリセットプロパティ

プロパティ名	名称	タイプ	説明
#app_crashed_reason	異常情報	文字列	クラッシュ発生時のスタックトレースを記録されます

その他プリセットプロパティ

上記以外のプリセットプロパティとして、一部呼び出ししてから記録されるプリセットプロパティ：

プロパティ名	名称	タイプ	説明
#duration	経過時間	数値	時間経過機能timeEventを呼び出して、イベントの経過時間を記録される。単位は秒
#background_duration	バックグラウンドの経過時間	数値	時間経過機能timeEventを呼び出して、イベントの経過時間を記録される。単位は秒

プリセットプロパティを取得

v2.7.0とそれ以降のバージョンはgetPresetProperties()を呼び出ししてプリセットプロパティを取得できます。

以下の方法でサーバのトラッキングはApp側の一部プリセットプロパティを取得し、サーバ側に転送できます。

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

//Preset properties of Event
NSDictionary *properties = [presetProperties toEventPresetProperties];
/*
   {
        "#carrier": "T-Mobile",
        "#os": "iOS",
        "#device_id": "A8B1C00B-A6AC-4856-8538-0FBC642C1BAD",
        "#screen_height": 2264,
        "#bundle_id": "com.sw.thinkingdatademo",
        "#manufacturer": "Apple",
        "#device_model": "iPhone7",
        "#screen_width": 1080,
        "#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., iOS
NSString *system_language = presetProperties.system_language;//type of mobile phone system language
NSNumber *screen_width = presetProperties.screen_width;//screen width
NSNumber *screen_height = presetProperties.screen_height;//screen height
NSString *device_model = presetProperties.device_model;//device model
NSString *device_id = presetProperties.device_id;//unique identifier of device
NSString *carrier = presetProperties.carrier;//information about operator of the SIM card. Operation information of the primary card should be geted under dual-card dual-standby mode 
NSString *manufacture = presetProperties.manufacturer;//mobile phone manufacturer, e.g., Apple
NSString *network_type = presetProperties.network_type;//network type
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

//get property objects
let presetProperties = instance.getPresetProperties();

//Preset properties of Event
let properties = presetProperties.toEventPresetProperties();
/*
   {
        "#carrier": "T-Mobile",
        "#os": "iOS",
        "#device_id": "A8B1C00B-A6AC-4856-8538-0FBC642C1BAD",
        "#screen_height": 2264,
        "#bundle_id": "com.sw.thinkingdatademo",
        "#manufacturer": "Apple",
        "#device_model": "iPhone7",
        "#screen_width": 1080,
        "#system_language": "zh",
        "#os_version": "10",
        "#network_type": "WIFI",
        "#zone_offset": 8,
        "#app_version":"1.0.0"
    }
*/

//get a certain preset properties
let bundle_id = presetProperties.bundle_id; //app bundle id
let os = presetProperties.os; //os type, e.g., iOS
let system_language = presetProperties.system_language; //type of mobile phone system language
let screen_width = presetProperties.screen_width;;//screen width
let screen_height = presetProperties.screen_height; //screen height
let device_model = presetProperties.device_model; //device model
let device_id = presetProperties.device_id; //unique identifier of device
let carrier = presetProperties.carrier; //information about operator of the SIM card. Operation information of the primary card should be geted under dual-card dual-standby mode 
let manufacture = presetProperties.manufacturer; //mobile phone manufacturer, e.g., Apple
let network_type = presetProperties.network_type; //network type
let os_version = presetProperties.os_version; //system version number
let zone_offset = presetProperties.zone_offset; //timezone offset value

IP、国都市の情報はサーバ側で解析して生成され、クライアントからの呼び出しが提供されていません。

プリセットプロパティ収集を禁止

特定の場合で、プリセットプロパティ収集を禁止することができます。プロジェクト内のinfo.plistファイルにTDDisPresetPropertiesのフィールド（データタイプArray）を追加することで、相応のプリセットプロパティは送信しなくなります。

例えば："#fps", @"#ram", @"#disk", @"#start_reason", @"#simulator"を収集禁止したい場合は、以下の図で設定してください。