Amplitude SQL: 테이블 스키마 및 필드 바로 가기

특수 필드 바로 가기

Amplitude SQL은 Amplitude 차트 환경에 직접 내장되어 있으므로 날짜 선택기 및 차트 저장 환경을 포함하여 동일한 Amplitude 인터페이스를 사용할 수 있습니다. Amplitude SQL은 또한 바로 가기를 위한 특수 필드를 제공합니다:

• $date: 날짜 선택기의 시간 범위를 적용하고 시간별로 쿼리를 업데이트합니다. 이 값은 이벤트의 이벤트 시간을 나타내며 프로젝트의 시간대를 따릅니다. 그렇지 않으면 Amplitude SQL은 UTC로 데이터를 반환합니다. **$events**와 함께 사용하십시오.
• $events: 현재 프로젝트에 있는 테이블의 약어입니다. 이 테이블은 병합된 사용자를 자동으로 처리합니다. **$date**와 함께 사용하십시오.
• $amplitude_id: 사용자의 원래 Amplitude ID입니다. 이 필드를 사용하여 병합된 사용자를 자동으로 처리합니다.

테이블 스키마

Amplitude SQL은 하나의 테이블 스키마를 사용합니다. $events이 테이블은 병합된 사용자 매핑을 자동으로 처리합니다. 병합된 사용자 테이블도 볼 수 있으므로 Amplitude가 하나로 병합된 사용자 수를 빠르게 확인할 수 있습니다.

다음 표에서는 $events 및 병합된 사용자의 스키마를 보여 줍니다.

$events 테이블

• $amplitude_id
  • 데이터 형식: NUMBER(38,0)
  • 설명: 사용자의 원래 Amplitude ID입니다. 이 필드를 사용하여 병합된 사용자를 자동으로 처리합니다.
• adid
  • 데이터 형식: VARCHAR(16777216)
  • 설명: (Android) Google Play 서비스 광고 ID(AdID). Amplitude는 일반적으로 수집 후 이를 지우므로 보통 비어 있습니다.
• amplitude_attribution_ids
  • 설명: Amplitude가 내부 용도로 저장하는 광고 ID의 익명화된 해시값입니다. 이 메시지는 광고 ID가 전송된 경우 나타납니다. 이는 현재 삭제되었음에도 불구하고 adid/idfv가 존재했음을 증명합니다.
• amplitude_event_type
  • 데이터 형식: VARCHAR(16777216)
  • 설명: Amplitude가 생성하는 이벤트를 기반으로 한 Amplitude 관련 식별자입니다. 이 필드는 기존 필드이므로 모든 쿼리에 event_type이면 충분합니다.
• amplitude_id
  • 데이터 형식: NUMBER(38,0)
  • 설명: Amplitude가 고유 사용자를 계산하는 데 사용하는 내부 ID입니다.
• app
  • 데이터 형식: NUMBER(38,0)
  • 설명: 프로젝트 ID는 프로젝트의 설정 페이지에서 찾을 수 있습니다.
• city
  • 데이터 유형: VARCHAR
  • 설명: 도시.
• client_event_time
  • 데이터 유형: TIMESTAMP
  • 설명: 장치가 이벤트를 기록한 시점의 로컬 타임스탬프(UTC)입니다.
• client_upload_time
  • 데이터 유형: TIMESTAMP
  • 설명: 장치가 이벤트를 업로드한 시점의 로컬 타임스탬프(UTC)입니다.
• country
  • 데이터 형식: VARCHAR
  • 설명: 국가.
• data
  • 데이터 형식: VARIANT
  • 설명: first_event 및 merged_amplitude_id과 같은 필드를 저장하는 사전.
• device_brand
  • 데이터 형식: VARCHAR(16777216)
  • 설명: 장치 브랜드입니다.
• device_carrier
  • 데이터 형식: VARCHAR(16777216)
  • 설명: 장치 캐리어입니다.
• device_family
  • 데이터 형식: VARCHAR(16777216)
  • 설명: 장치 패밀리입니다.
• device_id
  • 데이터 형식: VARCHAR(16777216)
  • 설명: 장치별 식별자입니다.
• device_manufacturer
  • 데이터 형식: VARCHAR(16777216)
  • 설명: 장치 제조업체입니다.
• device_model
  • 데이터 형식: VARCHAR(16777216)
  • 설명: 장치 모델입니다.
• device_type
  • 데이터 형식: VARCHAR(16777216)
  • 설명: 장치 유형입니다.
• dma
  • 데이터 형식: VARCHAR(16777216)
  • 설명: 지정된 마케팅 영역(DMA).
• event_id
  • 데이터 형식: NUMBER(38,0)
  • 설명: 이벤트를 구분하는 카운터입니다.
• event_time
  • 데이터 유형: TIMESTAMP
  • 설명:
    • Amplitude 타임스탬프(UTC)는 server_received_time와 client_upload_time의 차이만큼 client_event_time을(를) 조정한 값입니다. 구체적으로:
    • event_time = client_event_time + (server_received_time - client_upload_time)
    • Amplitude는 이 타임스탬프를 사용하여 차트에 이벤트를 구성합니다.
    • server_received_time와 client_upload_time의 차이가 60초 미만이면 Amplitude는 event_time을 조정하지 않으며, 이는 client_event_time와 같습니다.
• event_type
  • 데이터 형식: VARCHAR(16777216)
  • 설명: 할당된 이벤트 유형입니다.
• followed_an_identify
  • 데이터 형식: BOOLEAN
  • 설명: 이 현재 SDK 이벤트와 마지막으로 확인된 SDK 이벤트 사이에 식별 이벤트가 있었으면 참입니다.
• groups
  • 데이터 형식: VARIANT
  • 설명: 그룹 유형입니다. 자세한 내용은 계정 설명서를 참조하십시오.
• idfa
  • 데이터 형식: VARCHAR(16777216)
  • 설명: (iOS) 광고 식별자. Amplitude는 일반적으로 수집 후 이 데이터를 삭제하므로 보통 비어 있습니다.
• ip_address
  • 데이터 형식: VARCHAR(16777216)
  • 설명: IP 주소입니다.
• location_lat
  • 데이터 형식: FLOAT
  • 설명: 위도.
• location_lng
  • 데이터 형식: FLOAT
  • 설명: 경도입니다.
• os_name
  • 데이터 형식: VARCHAR(16777216)
  • 설명: OS 이름입니다.
• os_version
  • 데이터 형식: VARCHAR(16777216)
  • 설명: OS 버전입니다.
• paying
  • 데이터 형식: VARCHAR
  • 설명: 사용자가 수익을 기록한 적이 있는 경우 True이며, 그렇지 않으면 '(none)'입니다. Identify API를 통해 속성 값을 수정할 수 있습니다.
• region
  • 데이터 형식: VARCHAR
  • 설명: 지역입니다.
• server_upload_time
  • 데이터 유형: TIMESTAMP
  • 설명: Amplitude 서버가 이벤트를 수신한 시점의 Amplitude 타임스탬프(UTC)입니다.
• session_id
  • 데이터 형식: NUMBER(38,0)
  • 설명: 에포크 이후 세션이 시작된 시간(밀리초)입니다.
• start_version
  • 데이터 형식: VARCHAR
  • 설명: Amplitude가 사용자를 처음으로 추적한 앱 버전입니다.
• user_id
  • 데이터 형식: VARCHAR(16777216)
  • 설명: 사용자가 지정한 읽을 수 있는 ID입니다.
• uuid
  • 데이터 형식: VARCHAR(16777216)
  • 설명: 행별 고유 식별자입니다(전송된 이벤트).
• version_name
  • 데이터 형식: VARCHAR(16777216)
  • 설명: 앱 버전입니다.

병합된 사용자 테이블

Amplitude가 고유 사용자를 추적하는 방법을 알아보려면 고유 사용자 추적을 참조하십시오.