# プリセットプロパティ
# 全てのイベントが付帯するプリセットプロパティ
以下のプリセットプロパティは 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 側の一部プリセットプロパティを取得し、サーバ側に転送できます。
IP、国都市の情報はサーバ側で解析して生成され、クライアントからの呼び出しが提供されていません。
# プリセットプロパティ収集を禁止
特定の場合で、プリセットプロパティ収集を禁止することができます。プロジェクト内の info.plist ファイルにTDDisPresetPropertiesのフィールド(データタイプ Array)を追加することで、相応のプリセットプロパティは送信しなくなります。
例えば:"#fps", @"#ram", @"#disk", @"#start_reason", @"#simulator"を収集禁止したい場合は、以下の図で設定してください。