사용자 레벨 ETL : 사용자 수준(이벤트 수준) 데이터 스키마

팔로우
Avatar
Vaibhav Gupta
Updated
문서

Singular 데이터 대상에 대한 일반 정보, 작동 방식 및 내보낼 수 있는 다양한 데이터 유형에 대해서는 Singular 데이터 대상(ETL) FAQ를 참조하십시오.

Singular 데이터 전송 기능을 사용할 때, Singular는 다양한 소스의 데이터를 동일한 데이터 스키마로 표준화하여 데이터베이스에서 쉽게 쿼리할 수 있도록 합니다.

Singular는 선택 가능한 다양한 데이터 스키마를 제공합니다. 각 스키마는 Singular 데이터 전송지가 데이터베이스로 로드할 서로 다른 필드 집합을 정의합니다.

전환 및 이벤트는 모든 데이터 대상 고객이 이용할 수 있는 반면, 다른 스키마는 프리미엄 기능입니다. 아래 표를 참고하여 필요에 가장 적합한 데이터 스키마를 선택하세요.

사용자 수준 데이터 스키마

각 필드에 대한 자세한 내용은 '수출 로그: 지원되는 필드'를 참조하십시오. 다양한 타임스탬프 필드에 대한 설명은 아래 '타임스탬프 의미 및 형식'을 참조하십시오.

 

기본 스키마

아래 스키마는 모든 고객이 사용할 수 있습니다.

어트리뷰션(v7) 데이터 스키마

설치 및 리인게이지먼트 이벤트, 해당 이벤트의 귀속 대상, 귀속 방식(예: 결정론적 또는 확률론적) 등에 대한 정보를 포함합니다.

참고: 전환 이벤트에 제공된 위치는 해당 이벤트와 연관된 IP 주소를 기반으로 합니다. 앱 내부에서 감지된 위치나 사용자가 제공한 정보가 아닙니다. 이벤트에 대한 다른 위치 데이터 소스가 있다면, 앱에서 Singular로 전송된 패스스루 매개변수를 확인하여 이를 확인할 수 있습니다.

etl_record_processing_hour_utc
  affiliate_id
  affiliate_name
  android_id
  android_id_md5
  android_sha1
  app_longname
  app_version
  bid_type
  campaign_id
  campaign_name
  city
  click_id
  country
  creative_id
  creative_name
  custom_user_ids
  device_id
  device_id_type
  device_make
  device_model
  event_timestamp
  event_timestamp_unix_utc
  fraud_reason
  fraud_status
  gaid
  gaid_md5
  gaid_sha_1
  google_click_id
  idfa
  idfa_md5
  idfa_sha_1
  idfv
  is_reengagement
  is_view_through
  method
  os_version
  partner
  passthrough
  platform
  publisher_concatenated
  publisher_hashed_id
  publisher_id
  publisher_name
  singular_campaign_name
  singular_partner_name
  state
  store
  sub_campaign_id
  sub_campaign_name
  sub_publisher_id
  sub_publisher_name
  touchpoint_ip
  touchpoint_timestamp
  touchpoint_timestamp_unix_utc
  tracker_name
  utm_campaign
  utm_content
  utm_medium
  utm_source
  utm_term
  waid
  attribution__touchpoint__agency_id
  attribution__event__device_id_type
이벤트(v5) 데이터 스키마

앱 내 이벤트(세션, 등록, 구매 등) 및 Singular SDK/S2S 연동 시 앱에서 정의된 기타 이벤트에 대한 데이터를 포함합니다.

etl_record_processing_hour_utc
  adjusted_timestamp
  adjusted_timestamp_unix_utc
  affiliate_id
  affiliate_name
  app_longname
  app_version
  arguments
  attribution_event_timestamp
  attribution_event_timestamp_unix_utc
  banner name (from v4)      
  bid_type
  campaign_id
  campaign_name
  city
  click_id
  converted_currency
  converted_revenue
  country
  creative_id
  creative_name
  currency
  custom_user_id
  device_id
  device_id_type
  estimated_skan_user (from V5) 
  install_source
  ip
  is_reengagement
  is_revenue_receipt_included
  is_revenue_valid
  is_view_through 
  name 
  os_version 
  partner 
  passthrough 
  platform 
  product_category
  product_name 
  product_price 
  product_quantity 
  product_sku 
  publisher_concatenated
  publisher_hashed_id 
  publisher_id 
  publisher_name 
  received_revenue 
  received_revenue_event
  revenue 
  server_timestamp 
  server_timestamp_unix_utc 
  session_id 
  singular_campaign_name
  state 
  sub_campaign_id 
  sub_campaign_name 
  sub_publisher_id 
  sub_publisher_name
  tag_id 
  touchpoint_timestamp 
  touchpoint_timestamp_unix_utc 
  tracker_name
  utm_campaign
  utm_content
  utm_medium
  utm_source
  utm_term
Assist 사용자 레벨 데이터 스키마

도움말 설치에 대한 사용자 수준 데이터를 포함하며, 전환에 기여했지만 최종 기여는 아닌 접점에 대한 세부 정보를 제공합니다.

affiliate_id
affiliate_name
android_id
android_id_md5
android_sha1
app_longname
app_version
assist_touchpoints_count
assisted_level
bid_type
campaign_id
campaign_name
city
click_id
country
creative_id
creative_name
custom_user_ids
device_id
device_id_type
device_make
device_model
event_timestamp
event_timestamp_unix_utc
gaid
gaid_md5
gaid_sha_1
google_click_id
idfa
idfa_md5
idfa_sha_1
idfv
is_fingerprinted
is_view_through
os_version
partner
passthrough
platform
publisher_concatenated
publisher_hashed_id
publisher_id
publisher_name
singular_campaign_name
singular_partner_name
state
store
sub_campaign_id
sub_campaign_name
sub_publisher_id
sub_publisher_name
touchpoint_id
touchpoint_ip
touchpoint_timestamp
touchpoint_timestamp_unix_utc
tracker_name
waid

기타 스키마

아래 스키마 중 하나를 사용하려면 Singular 플랫폼을 통해 티켓을 열어주세요
(도움말 > 문의하기).

클릭(v2) 데이터 스키마

설치 또는 리인게이지먼트의 기여도를 판단하기 위해 검토된 모든 클릭을 포함합니다.

etl_record_processing_hour_utc
  adjusted_timestamp
  adjusted_timestamp_unix_utc
  affiliate_id
  affiliate_name
  app_longname
  app_version
  arguments
  attribution_event_timestamp
  attribution_event_timestamp_unix_utc
  bid_type
  campaign_id
  campaign_name
  city
  click_id
  converted_currency
  converted_revenue
  country
  creative_id
  creative_name
  currency
  custom_user_id
  device_id
  device_id_type
  install_source
  ip
  is_reengagement
  is_revenue_receipt_included
  is_revenue_valid
  is_view_through
  name
  os_version
  partner
  passthrough
  platform
  product_category
  product_name
  product_price
  product_quantity
  product_sku
  publisher_concatenated
  publisher_hashed_id
  publisher_id
  publisher_name
  received_revenue
  received_revenue_event
  revenue
  server_timestamp
  server_timestamp_unix_utc
  session_id
  singular_campaign_name
  state
  sub_campaign_id
  sub_campaign_name
  sub_publisher_id
  sub_publisher_name
  tag_id
  touchpoint_timestamp
  touchpoint_timestamp_unix_utc
  tracker_name
  utm_campaign
  utm_content
  utm_medium
  utm_source
  utm_term
SKAdNetwork 포스트백 데이터 스키마

Singular가 광고 네트워크 파트너로부터 수신한 모든 SKAdNetwork 포스트백을 포함합니다. 이러한 포스트백은 SKAdNetwork 추적을 사용하는 iOS 앱과 포스트백 전달을 포함하는 Singular와의 SKAdNetwork 연동을 보유한 파트너에게만 제공됩니다.

Singular는 또한 집계된 SKAdNetwork 데이터를 제공합니다: SKAdNetwork 원시 데이터 스키마 및 SKAdNetwork 데이터 스키마를 참조하십시오.

etl_record_processing_hour_utc
  app_longname
  city
  conversion_model_measurement_period
  conversion_model_name
  conversion_model_types
  conversion_model_version
  conversion_value
  country
  decoded_conversion_value
  estimated_cohort_period
  estimated_conversion_date
  estimated_install_date
  fraud_reason
  fraud_status
  ip
  is_view_through
  max_install_date
  min_install_date
  partner
  partner_campaign_id
  partner_campaign_name
  partner_creative_id
  partner_creative_name
  partner_sub_campaign_id
  partner_sub_campaign_name
  partner_sub_publisher_name
  referrer
  region
  signature
  singular_partner_name
  skadnetwork_app_id
  skadnetwork_campaign_id
  skadnetwork_network_id
  skadnetwork_publisher_app_id
  skadnetwork_redownload
  skadnetwork_version
  timestamp
  timestamp_unix_utc
  transaction_id
  user_agent
skan_postback__source_identifier
skan_postback__source_domain
skan_postback__postback_sequence_index
skan_postback__coarse_conversion_value
앱 SKAN 포스트백

광고 네트워크가 Apple로부터 직접 수신한 모든 SKAdNetwork 포스트백을 포함합니다. 이 포스트백은 이후 Singular로 전달될 수 있습니다. Singular로 SKAdNetwork 포스트백 전송 방법(iOS 15+)을 참조하십시오.

etl_record_processing_hour_utc
  app_longname
  skadnetwork_version
  transaction_id
  skadnetwork_network_id
  skadnetwork_campaign_id
  skadnetwork_app_id
  skadnetwork_publisher_app_id
  conversion_value
  signature
  skadnetwork_redownload
  is_view_through
  timestamp_unix_utc
  timestamp
  ip
  user_agent
  partner
  fraud_status
  fraud_reason
  decoded_conversion_value
  conversion_model_name
  conversion_model_version
  conversion_model_types
  conversion_model_measurement_period
  estimated_conversion_date
  estimated_install_date
  estimated_cohort_period
  min_install_date
  max_install_date
  singular_partner_name
skan_postback__source_identifier
skan_postback__source_domain
skan_postback__postback_sequence_index
skan_postback__coarse_conversion_value
사기 데이터 스키마

Singular 사기 방지 시스템의 원시 출력 데이터입니다(자세한 내용은 'Singular 사기 방지 이해하기' 및 '사기 보고 및 사기 로그 FAQ' 참조).

이 데이터에는 설치 이벤트와 연관된 모든 클릭 및 노출에 대한 행이 포함됩니다. 여기에는 모든 설치에 대한 어트리뷰션 옵션으로 검토되는 "자연 설치(organic install)" 옵션에 대한 행도 포함됩니다. 따라서 Singular 설치에 대해 사기로 거부된 여러 터치포인트를 볼 수 있습니다. 동일한 설치에 속하는 모든 클릭 및 노출을 정렬하거나 그룹화하려면 unique_install_identifier 필드를 사용하십시오.

etl_record_processing_hour_utc
  app_longname
  app_version
  creative
  device_id
  device_make
  device_model
  fraud_external_reason
  fraud_reason
  fraud_status
  idfv
  install_city
  install_country
  install_ip
  install_timestamp
  install_timestamp_unix_utc
  is_view_through
  os_version
  partner
  platform
  publisher_concatenated
  publisher_hashed_id
  publisher_id
  publisher_name
  time_to_install
  touchpoint_campaign
  touchpoint_city
  touchpoint_country
  touchpoint_ip
  touchpoint_timestamp
  touchpoint_timestamp_unix_utc
  unique_install_identifier
크로스 디바이스 사용자 어트리뷰션 데이터 스키마
etl_record_processing_hour_utc
  affiliate_id
  affiliate_name
  android_id
  android_id_md5
  android_sha1
  app_longname
  app_version
  bid_type
  campaign_id
  campaign_name
  click_id
  country
  creative_id
  creative_name
  custom_user_ids
  device_id
  device_id_type
  event_timestamp
  event_timestamp_unix_utc
  gaid
  gaid_md5
  gaid_sha_1
  google_click_id
  idfa
  idfa_md5
  idfa_sha_1
  idfv
  is_view_through
  os_version
  partner
  passthrough
  platform
  publisher_concatenated
  publisher_hashed_id
  publisher_id
  publisher_name
  singular_campaign_name
  singular_partner_name
  state
  store
  sub_campaign_id
  sub_campaign_name
  sub_publisher_id
  sub_publisher_name
  touchpoint_ip
  touchpoint_timestamp
  touchpoint_timestamp_unix_utc
  tracker_name
  waid
크로스 디바이스 이벤트 데이터 스키마
etl_record_processing_hour_utc
  adjusted_timestamp
  adjusted_timestamp_unix_utc
  affiliate_id
  affiliate_name
  app_longname
  app_version
  arguments
  attribution_event_timestamp
  attribution_event_timestamp_unix_utc
  bid_type
  campaign_id
  campaign_name
  city
  click_id
  converted_currency
  converted_revenue
  country
  creative_id
  creative_name
  currency
  custom_user_id
  device_id
  device_id_type
  install_source
  ip
  is_reengagement
  is_revenue_receipt_included
  is_revenue_valid
  is_view_through
  name
  os_version
  partner
  passthrough
  platform
  product_category
  product_name
  product_price
  product_quantity
  product_sku
  publisher_concatenated
  publisher_hashed_id
  publisher_id
  publisher_name
  received_revenue
  received_revenue_event
  revenue
  server_timestamp
  server_timestamp_unix_utc
  session_id
  singular_campaign_name
  state
  sub_campaign_id
  sub_campaign_name
  sub_publisher_id
  sub_publisher_name
  tag_id
  touchpoint_timestamp
  touchpoint_timestamp_unix_utc
  tracker_name

부록: 타임스탬프 의미 및 형식

팁: Singular는 데이터 행마다 여러 타임스탬프 필드를 제공합니다. 대부분의 타임스탬프 필드는 두 가지 버전(예: "event_timestamp" 및 "event_timestamp_unix_utc")으로 존재합니다.

  • _timestamp로 끝나는 필드는 데이터베이스 대상에서는 시간대 인식 타임스탬프 열로, 파일 기반 대상(S3/SFTP/GCS)에서는 시간대 정보가 포함된 타임스탬프로 포맷됩니다. 시간대는 광고주의 시간대입니다.
  • _timestamp_unix_utc로 끝나는 필드는 UTC 기준 UNIX 타임스탬프 형식(정수)의 시간을 포함합니다.
  • BigQuery 대상은 시간대를 지원하지 않습니다. BigQuery로 전송되는 모든 타임스탬프는 UTC입니다.
타임스탬프 필드 설명
etl_record_processing_hour_utc Singular에서 데이터가 완전히 처리된 시간입니다. 이 시간은 이벤트 발생 시간이나 서버 타임스탬프보다 늦을 수 있습니다. 매시간마다 Singular는 이전 시간 동안 완전히 처리된 데이터에 대해 이 값을 업데이트합니다.
어트리뷰션
event_timestamp
event_timestamp_unix_utc 		기기가 어트리뷰션 이벤트(예: 설치)를 수행한 시간입니다.
터치포인트_타임스탬프
touchpoint_timestamp_unix_utc 		어트리뷰션 이벤트로 이어진 터치포인트(광고 클릭 또는 광고 노출)의 시간.
이벤트
조정된_타임스탬프
조정된_타임스탬프_유닉스_UTC 		이벤트가 기기에서 실제로 발생한 시간.
server_timestamp
server_timestamp_unix_utc 		Singular 서버가 이벤트를 수신한 시간입니다. 참고: 이벤트 데이터 전송에 기술적 지연이 발생한 경우 adjusted_timestamp와 상당히 다를 수 있습니다.
attribution_event_timestamp
attribution_event_timestamp_unix_utc 		기기에 어트리뷰션 이벤트(예: 앱 설치)가 발생한 시간입니다.
터치포인트_타임스탬프
touchpoint_timestamp_unix_utc 		어트리뷰션 이벤트로 이어진 터치포인트(광고 클릭 또는 광고 노출)의 시간.

데이터 스키마 변경

데이터 대상 생성 및 저장 후에는 다른 데이터 스키마로 전환할 수 없습니다. 이는 기존 데이터가 있는 운영 중인 데이터베이스에서 테이블 구조를 변경할 경우 여러 위험과 복잡성이 따르기 때문입니다.

데이터 스키마 변경이 필요한 경우 새 대상만 생성하면 됩니다. 새 대상 생성 전에 기존 테이블을 삭제하거나, 새 대상이 다른 이름의 새 테이블로 데이터를 로드하도록 구성할 수 있습니다. 이 과정을 통해 데이터 안전성을 유지하고 기존 쿼리 및 작업 부하가 계속 작동하도록 보장할 수 있습니다.