プリセットプロパティ

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

以下のプリセットプロパティはiOS SDK 中で全てのイベント（自動収集イベント含め）が付帯するプリセットプロパティとなります。

プロパティ名	名称	タイプ	収集タイミング	説明
#ip	IP アドレス	文字列	サーバー側で収集	ユーザのIPアドレス、TAはユーザの地理的位置情報
#country	国	文字列	サーバー側で収集	ユーザーの国または地域は、IPアドレスに基づいて生成
#country_code	国コード	文字列	サーバー側で収集	ユーザーの所在する国または地域の国別地域コード(ISO 3166-1 alpha-2、つまり2大文字英字)は、IPアドレスに基づいて生成
#province	州	文字列	サーバー側で収集	ユーザーの州、IPアドレスに基づいて生成
#city	都市	文字列	サーバー側で収集	ユーザーの都市は、IPアドレスに基づいて生成
#os_version	OSバージョン	文字列	初期化時に1回収集	iOS 11.2.2、Android 8.0.0等
#manufacturer	デバイスメーカー	文字列	初期化時に1回収集	Appleなどのユーザーデバイスのメーカー
#os	OS	文字列	初期化時に1回収集	Android、iOSなど
#device_id	デバイス ID	文字列	初期化時に1回収集	ユーザーのデバイスID、iOSはユーザーのIDFVやUUID、AndroidはAndroidIDを取得
#screen_height	スクリーン高さ	数値	初期化時に1回収集	ユーザーデバイスのスクリーンの高さ、1920など
#screen_width	スクリーン長さ	数値	初期化時に1回収集	ユーザーデバイスのスクリーンの長さ、1080など
#device_model	デバイスモデル	文字列	初期化時に1回収集	iPhone 8などのユーザーデバイスのモデル
#device_type	デバイスタイプ	文字列	初期化時に1回収集	デバイスタイプ："Tablet"、"Phone"など
#app_version	APPバージョン	文字列	初期化時に1回収集	APPバージョン
#bundle_id	アプリパッケージ名（ユニーク）	文字列	初期化時に1回収集	APPパッケージ名もしくはプロセス名
#lib	SDK タイプ	文字列	初期化時に1回収集	SDKのタイプ：Android，iOSなど
#lib_version	SDK バージョン	文字列	初期化時に1回収集	SDKのバージョン
#network_type	ネットワークタイプ	文字列	初期化時に1回収集し、ネットワーク状態の変化時に収集	データ送信時のネットワーク状態：WIFI、4G、5Gなど
#carrier	キャリア	文字列	初期化時に1回収集	ユーザーデバイスのキャリア：Docomo、Softbankなど
#zone_offset	タイムゾーン	数値	イベント発生時に収集	データ時間UTC時間との偏位時間数
#install_time	インストール時間	時間	初期化時に1回収集	APPのインストール時間
#simulator	シミュレーター	数値	初期化時に1回収集	デバイスはシミュレーター true/false
#ram	デバイスのram状態	文字列	イベント発生時に収集	ユーザーデバイスの現在残りramと総ram、単位はGB、1.4/2.4
#disk	デバイスのストレージ状態	文字列	イベント発生時に収集	ユーザーデバイスの現在残りストレージと総ストレージ、単位はGB　30/200
#fps	デバイスのフレームレート	数値	イベント発生時に収集	ユーザーデバイスの現在画面のフレームレート：60
#system_language	システム言語	文字列	初期化時に1回収集	ユーザーデバイスのシステム言語（ISO 639-1）jp, enなど

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

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

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

プロパティ名	名称	タイプ	説明
#resume_from_background	バックグラウンドから再開かどうか	文字列	APPの起動は直接起動なのか、バックグラウンドから再開なのか。trueはバックグラウンドから再開で、falseは直接起動となります。
#start_reason	アプリケーションの起動元	文字列	JSON文字列です。アプリがURLまたはIntentを使用して開かれる場合、URLの内容とIntentのデータを自動的に記録します。例:{url:"thinkingdata://","data":{}}
#background_duration	バックグラウンド滞在時間	数値	startイベントが2回発生した間隔内で、アプリがバックグラウンドにある時間、 単位：秒

- 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"を収集禁止したい場合は、以下の図で設定してください。