# Preset Properties and System Fields(사전 설정 속성과 시스템 필드)
# 사전 설정 속성과 시스템 필드
이 문서에서는 TE의 사전 설정 속성과 시스템 필드에 대해 설명드립니다.
■ 사전 설정 속성
사전 설정 속성이란, TE 내에서 생성, 정의된 속성을 의미합니다. 사전 설정 속성은 모두 '#'로 시작하는 이벤트 속성이며, 사전에 이름과 의미가 정의되어 있습니다. 시스템 필드는 데이터 내의 구조 필드(#account_id, #event_time) 또는 데이터베이스 내의 특별한 목적을 가진 필드를 가리킵니다. 대부분의 경우, 분석 모델에서 사용되지 않거나, 간접적으로 사용됩니다.
주의:
다음의 사전 설정 속성을 제외하고, '#'로 시작하는 속성은 부정한 필드로 간주되며, 저장되지 않습니다. 따라서, 사용자 지정 속성을 '#'로 시작하도록 설정하는 것은 권장되지 않습니다. 또한, 모든 시스템 필드를 이벤트 분석이나 사용자 분석으로 사용할 수 없습니다.
사전 설정된 #ip 외의 속성은 직접 사용하는 것을 권장하지 않습니다. 클라이언트 SDK와 다른 전송 방식을 동시에 사용하는 경우에만, 데이터는 일관성을 보장하기 위해, TE 스태프의 지시 하에 권장됩니다.
- 사전 설정 속성
| 속성 이름 | 이름 | 설명 |
|---|---|---|
| #ip | IP 주소 | 사용자의 IP 주소로, TE 가 사용자의 지리적 위치 정보를 얻는 데 사용합니다 |
| #country | 국가 지역 | 사용자가 위치한 국가 또는 지역은 IP 주소에 따라 생성됩니다 |
| #country_code | 국가 지역 코드 | 사용자가 위치한 국가 또는 지역의 국가 코드 (ISO 3166-1 alpha-2, 즉, 두 개의 대문자 영어 문자), IP 주소에 따라 생성됩니다 |
| #province | 도 | 사용자의 지방은 IP 주소에 따라 생성됩니다 |
| #city | 도시 | 사용자의 도시는 IP 주소에 따라 생성됩니다 |
| #os_version | 운영 체제 버전 | iOS 11.2.2、Android 8.0.0 등 |
| #manufacturer | 장비 제조사 | 사용자 장비의 제조사, 예를 들어 Apple, vivo 등 |
| #os | 운영 체제 | 예를 들어 Android, iOS 등 |
| #device_id | 장치 ID | 사용자의 장치 ID , iOS 는 사용자의 IDFV 또는 UUID를 가져오고, Android는 androidID를 가져옵니다 |
| #screen_height | 화면 높이 | 사용자 장비의 화면 높이, 예를 들어 1920 등 |
| #screen_width | 화면 너비 | 사용자 장비의 화면 높이, 예를 들어 1080 등 |
| #device_model | 장비 모델 | 사용자 장비의 모델, 예를 들어 iPhone 8 등 |
| #app_version | 앱 버전 | 앱의 버전 |
| #bundle_id | 앱 패키지 이름 | 앱 패키지 이름 또는 프로세스 이름 |
| # lib | SDK 유형 | 접근하는 SDK 의 유형, 예를 들어 Android, iOS 등 |
| #lib_version | SDK 버전 | 접근하는 SDK 의 버전 |
| #network_type | 네트워크 상태 | 이벤트를 업로드할 때의 네트워크 상태, 예를 들어 WIFI, 3G, 4G 등 |
| #carrier | 네트워크 운영자 | 사용자 장비의 네트워크 운영자, 예를 들어 중국 이동통신, 중국 통신 등 |
| #browser | 브라우저 유형 | 사용자가 사용하는 브라우저 유형, 예를 들어 크롬, 파이어폭스 등 |
| #browser_version | 브라우저 버전 | 사용자가 사용하는 브라우저의 버전, 예를 들어 크롬 61.0, 파이어폭스 57.0 등 |
| #duration | 이벤트 지속 시간 | 타이밍 기능을 사용하여 기록된 시간의 길이, 초 단위 |
| #url | 페이지 주소 | 현재 페이지의 주소 |
| #url_path | 페이지 경로 | 현재 페이지로의 경로 |
| #referrer | 전달 주소 | 점프 전 페이지의 주소 |
| #referrer_host | 전달 경로 | 점프 전 페이지로의 경로 |
| #title | 페이지 제목 | 현재 페이지의 제목 |
| #screen_name | 페이지 이름 | 이벤트에서 사용된 페이지의 이름을 자동으로 수집 |
| #element_id | 요소 ID | 이벤트에서 사용된 컨트롤의 ID를 자동으로 수집 |
| #element_type | 요소 유형 | 이벤트에서 사용된 컨트롤의 유형을 자동으로 수집 |
| #resume_from_background | 백그라운드에서 깨어날지 여부 | 사용된 이벤트를 자동으로 캡처, 애플리케이션이 백그라운드에서 깨어나는지 여부, 불린 타입 |
| #element_selector | 요소 선택자 | 이벤트에서 컨트롤이 사용하는 viewPath를 자동으로 수집합니다 |
| #element_position | 요소 위치 | 이벤트에서 사용된 컨트롤의 위치 정보를 자동으로 수집합니다 |
| #element_content | 요소 내용 | 이벤트에서 사용된 컨트롤의 내용을 자동으로 캡처합니다 |
| #scene | 장면 값 | 위챗 미니 프로그램이 시작될 때 들어오는 장면 값 |
| #mp_platform | 미니 프로그램 플랫폼 | 응용 프로그램이 위치한 플랫폼을 식별합니다 |
| #app_crashed_reason | 비정상 정보 | 이벤트에서 사용된 스택 정보를 자동으로 수집하여 APP 충돌을 기록합니다 |
| #zone_offset | 시간대 오프셋 | 데이터 시간이 UTC 시간 에서 얼마나 시간대가 오프셋되는지의 시간 수 |
| #system_language | 시스템 언어 | 사용자 장비의 시스템 언어 (ISO 639-1, 즉, 두 소문자 영어 문자), 예를 들어 zh, en 등 |
| 필드 이름 | 이름 | 설명 |
|---|---|---|
| $part_event | 이벤트 파티션 필드 | 이벤트 파티션 필드, 이벤트 명인 #event_name에서 가져옴 |
| $part_date | 날짜 파티션 필드 | 날짜 파티션 필드, 이벤트가 발생한 날짜인 #event_time에서 가져옴 |
| #app_id | app_id | 프로젝트의 APP ID |
| #user_id | 유저 고유 ID | 시스템 내 유저의 고유 유저 신원 |
| #account_id | 계정 ID | 계정 ID, 데이터의 #account_id와 동일 |
| #distinct_id | 방문자 ID | 방문자 ID, #distinct_id와 동일 |
| #event_name | 이벤트 유형 | 이벤트 유형, 데이터의 #event_name 필드와 동일 |
| #event_time | 이벤트 시간 | 이벤트 시간, 데이터의 #time 필드와 동일 |
| #server_time | 서버 레벨 시간 | 데이터가 서버 레벨에서 수신된 시간 |
- 유저 테이블의 시스템 필드
| 필드 이름 | 이름 | 설명 |
|---|---|---|
| #user_id | 유저 고유 ID | 시스템 내의 사용자의 고유 사용자 신원 |
| #account_id | 계정 ID | 계정 ID, 데이터의 #account_id와 동일 |
| #distinct_id | 방문자 ID | 방문자 ID, #distinct_id와 동일 |
| #active_time | 활성화 시간 | 사용자의 첫 데이터(이벤트 및 사용자 특성 데이터 포함)가 저장되는 시점, 데이터 #time 필드의 시간 |
| #reg_time | 등록 시간 | 사용자의 첫 데이터가 계정 ID(이벤트 및 사용자 특성 데이터 포함)와 함께 저장될 때, 데이터의 시간 #time 필드 |
| #update_time | 업데이트 시간 | #time 필드에서 받은 마지막 사용자 데이터의 시간 |
| #user_operation | 사용자 작업 유형 | 받은 마지막 사용자 데이터의 작업 유형(즉, #type 필드) |
| #server_time | 서버 레벨 시간 | 받은 마지막 사용자 데이터의 서버 시간 |