데이터 데스티네이션: 유저 레벨 데이터 스키마

유저 레벨 데이터를 고객사의 데이터베이스나 플랫폼으로 가져오기 위해 데이터 데스티네이션을 설정하기 전, 지원되는 여러 다른 데이터 스키마를 먼저 확인하세요.

 

Singular 데이터 데스티네이션을 사용하면 Singular가 여러 다른 소스의 데이터를 동일한 데이터 스키마로 표준화해서 고객사의 데이터베이스에서 쉽게 쿼리할 수 있도록 합니다.

Singular에서 제공하는 4가지 데이터 스키마 중 하나를 선택하여 사용할 수 있습니다. 각 스키마는 Singular 데이터 데스티네이션이 고객사의 데이터베이스로 보낼 디멘션 및 메트릭을 정의합니다. 다음 테이블을 참조하여 고객사에서 사용하고자 하는 데이터 스키마를 선택하세요.

데이터 스키마 옵션

주의: 아래 스키마 내 필드는 Singular의 어트리뷰션 트래커를 사용할 때 다운로드할 수 있는 로그와 일치합니다. 각 필드에 대한 자세한 정보는 어트리뷰션 로그 추출(Export Log)에서 확인하세요. 각 타임스탬프 필드에 대해서는 하단의 타임스탬프 의미 및 형식 항목에서 안내합니다.

"Attributions" 스키마에 포함되는 필드 "Events" 스키마에 포함되는 필드
etl_record_processing_hour_utc
device_id
device_id_type
platform
event_timestamp
event_timestamp_unix_utc
is_fingerprinted
is_reengagement
is_view_through
method
app_longname
app_version
city
country
custom_user_ids
os_version
state
store
device_make
device_model
gaid
gaid_md5
gaid_sha_1
idfa
idfa_md5
idfa_sha_1
waid
idfv
android_id
android_id_md5
android_sha1
touchpoint_timestamp
touchpoint_timestamp_unix_utc
touchpoint_ip
passthrough
partner
singular_partner_name
affiliate_id
affiliate_name
bid_type
campaign_id
campaign_name
click_id
creative_id
creative_name
publisher_concatenated
publisher_hashed_id
publisher_id
publisher_name
sub_campaign_id
sub_campaign_name
sub_publisher_id
sub_publisher_name
singular_campaign_name
tracker_name
fraud_reason
fraud_status
google_click_id
etl_record_processing_hour_utc
device_id
device_id_type
platform
adjusted_timestamp
adjusted_timestamp_unix_utc
app_longname
app_version
arguments
converted_currency
converted_revenue
currency
custom_user_id
name
os_version
ip
product_category
product_name
product_price
product_quantity
product_sku
revenue
server_timestamp
server_timestamp_unix_utc
session_id
attribution_event_timestamp
attribution_event_timestamp_unix_utc
is_fingerprinted
is_reengagement
is_view_through
city
country
install_source
state
touchpoint_timestamp
touchpoint_timestamp_unix_utc
tag_id
passthrough
partner
affiliate_id
affiliate_name
bid_type
campaign_id
campaign_name
click_id
creative_id
creative_name
publisher_concatenated
publisher_hashed_id
publisher_id
publisher_name
sub_campaign_id
sub_campaign_name
sub_publisher_id
sub_publisher_name
singular_campaign_name
tracker_name
received_revenue
received_revenue_event
is_revenue_receipt_included
is_revenue_valid

타임스탬프 의미 및 형식

팁: Singular는 각 데이터 열에 대한 여러 타임스탬프 필드를 제공합니다. 대부분 "event_timestamp"와 "event_timestamp_unix_utc"와 같은 두 가지 버전이 존재합니다.

  • _timestamp로 끝나는 필드는 타임존과 관련된 타임스탬프 열(일반 데이터 데스티네이션) 혹은 타임존 정보를 포함한 타임스탬프(파일 기반 데스티네이션: S3/SFTP/GC)입니다.
  • _timestamp_unix_utc로 끝나는 필드는 UTC를 기준으로 한 UNIX 타임스탬프 형식(정수형)입니다.
타임스탬프 필드 정의
etl_record_processing_hour_utc Singular에서 데이터를 완전히 처리한 시간입니다. 이벤트 시간이나 서버 타임스탬프보다 늦을 수 있습니다. Singular는 이전 1시간 동안 완전히 처리된 데이터에 대해 매시간마다 이 값을 업데이트합니다.
Attributions
event_timestamp event_timestamp_unix_utc 인스톨 등 어트리뷰션 이벤트가 디바이스에서 발생한 시간
touchpoint_timestamp touchpoint_timestamp_unix_utc 어트리뷰션 이벤트를 일으킨 터치포인트(광고 클릭이나 노출)의 시간
Events
adjusted_timestamp adjusted_timestamp_unix_utc 이벤트가 디바이스에서 발생한 실제 시간
server_timestamp server_timestamp_unix_utc Singular 서버에서 이벤트를 받은 시간. 주의: 이벤트 데이터를 보내는 중 기술적인 지연이 있는 경우 adjusted_timestamp와 상당한 차이가 있을 수 있음
attribution_event_timestamp attribution_event_timestamp_unix_utc 인스톨 등 어트리뷰션 이벤트가 디바이스에서 발생한 시간
touchpoint_timestamp touchpoint_timestamp_unix_utc 어트리뷰션 이벤트를 일으킨 터치포인트(광고 클릭이나 노출)의 시간

데이터 스키마 변경

데이터 데스티네이션을 생성하고 저장한 이후에는 데이터 스키마를 변경할 수 없습니다.  기존 데이터가 존재하는 라이브 데이터베이스에서 테이블 구조를 변경하는 것은 위험 요소가 매우 크며 많은 복잡성이 발생하기 때문입니다.

데이터 스키마를 변경하려는 경우 기존 데이터 커넥터를 변경하는 대신 목적지를 새로 생성하거나 새로운 목적지를 구성해서 다른 이름의 신규 테이블에 데이터를 불러오세요. 이를 통해 데이터를 안전한 상태로 보장하고 기존 쿼리와 워크 로드가 계속 동작하도록 할 수 있습니다.

 

도움이 되었습니까?