# プリセットプロパティとシステムフィールド
当ドキュメントでは、TEのプリセットプロパティとシステムフィールドについてご説明いたします。
■プリセットプロパティ
プリセットプロパティとは、TE内で生成、定義されたプロパティを意味します。プリセットプロパティはすべて「#」で始まるイベントプロパティであり、事前に名称と意味が定義づけられています。システムフィールドは、データ内の構造フィールド（#account_id、#event_time）、またはデータベース内の特別な目的を持つフィールドを指します。多くの場合、分析モデルで使用されないか、間接的に使用されます。
注意：
以下のプリセットプロパティを除き、「#」で始まるプロパティは不正なフィールドとみなされ、保存されません。そのため、カスタムプロパティを「#」で始まるように設定することは推奨されていません。また、すべてのシステムフィールドをイベント分析やユーザー分析として使用することはできません。
プリセットされた#ip以外のプロパティは直接使用することを推奨しておりません。クライアントSDKと他の伝送方式を同時に使用する場合に限り、データは一貫性を担保するため、TEスタッフの指示の下で推奨されます。
- プリセットプロパティ
| Properties name | Name | Description |
|---|---|---|
| #ip | IP address | The user's IP address, which the TE will use to obtain the user's geographic location information |
| #country | Country area | The country or region where the user is located is generated according to the IP address |
| #country_code | Country Area Code | The country code of the country or region where the user is located (ISO 3166-1 alpha-2, that is, two uppercase English letters), generated according to the IP address |
| #province | Province | The user's province is generated according to the IP address |
| #city | City | The user's city is generated according to the IP address |
| #os_version | Operating system version | iOS 11.2.2、Android 8.0.0 etc |
| #manufacturer | Equipment manufacturer | Manufacturers of user equipment, such as Apple, vivo, etc |
| #os | Operating system | Such as Android, iOS , etc |
| #device_id | Device ID | The user's device ID , iOS take the user's IDFV or UUID, Android takes androidID |
| #screen_height | Screen height | The screen height of the user equipment, such as 1920, etc |
| #screen_width | Screen width | The screen height of the user equipment, such as 1080, etc |
| #device_model | Equipment model | The model of the user equipment, such as iPhone 8, etc |
| #app_version | App version | Version of your app |
| #bundle_id | App package name | APP package name or process name |
| # lib | SDK type | The type of SDK you access, such as Android, iOS , etc |
| #lib_version | SDK version | The version you access to the SDK |
| #network_type | Network status | Network status when uploading events, such as WIFI, 3G, 4G, etc |
| #carrier | Network Operator | Network operators of user equipment, such as China Mobile, China Telecom, etc |
| #browser | Browser Type | The browser type used by the user, such as Chrome, Firefox, etc |
| #browser_version | Browser version | Version of the browser used by the user, such as Chrome 61.0, Firefox 57.0, etc |
| #duration | Event duration | The length of time recorded using the timing function, in seconds |
| #url | Page address | Address of the current page |
| #url_path | Page path | The path to the current page |
| #referrer | Forward address | The address of the page before the jump |
| #referrer_host | Forward path | The path to the page before the jump |
| #title | Page Title | Title of the current page |
| #screen_name | Page name | Automatically collect the name of the page used in the event |
| #element_id | Element ID | Automatically collect the ID of the control used in the event |
| #element_type | Element type | Automatically collects the type of control used in the event |
| #resume_from_background | Whether to wake up from the background | Automatically capture events used, whether the application wakes up from the background, Boolean type |
| #element_selector | Element selector | Automatically collects the viewPath used by the control in the event |
| #element_position | Element position | Automatically collects the location information of the control used in the event |
| #element_content | Element content | Automatically captures content on controls, used in events |
| #scene | Scene value | The incoming scene value when the WeChat Mini Program starts |
| #mp_platform | Mini Program Platform | Identify the platform where the application is located |
| #app_crashed_reason | Abnormal information | Automatically collect stack information used in events to record APP crashes |
| #zone_offset | Time zone offset | The number of hours the data time is offset from UTC time |
| #system_language | System language | The system language of the user equipment (ISO 639-1, that is, two lowercase English letters), such as zh, en, etc |
- トランザクションテーブルのシステムフィールド
| Field name | Name | Description |
|---|---|---|
| $part_event | Event partition field | Event partition field, taken from #event_name, which is the event name |
| $part_date | Date partition field | Date partition field, taken from #event_time, which is the date the event occurred |
| #app_id | app_id | Project's APP ID |
| #user_id | User unique ID | The unique user identity of the user in the system |
| #account_id | Account ID | Account ID, equivalent to #account_id in the data |
| #distinct_id | Visitor ID | Visitor ID, equivalent to #distinct_id |
| #event_name | Event type | Event type, equivalent to the #event_name field in the data |
| #event_time | Event time | Event time, equivalent to the #time field in the data |
| #server_time | Server level time | Time when data is received at the server level |
- ユーザーテーブルのシステムフィールド
| Field name | Name | Description |
|---|---|---|
| #user_id | User unique ID | The unique user identity of the user in the system |
| #account_id | Account ID | Account ID, equivalent to #account_id in the data |
| #distinct_id | Visitor ID | Visitor ID, equivalent to #distinct_id |
| #active_time | Time of activation | When the user's first data (including event and user feature data) is stored, the time of the data #time field |
| #reg_time | Registration time | When the user's first data containing the account ID (including event and user feature data) is stored, the time of the data #time field |
| #update_time | Update time | The time of the last user data received in the #time field |
| #user_operation | User operation type | The operation type of the last user data received (i.e., the #type field) |
| #server_time | Server level time | Server time of last user data received |