유저 레벨 데이터를 고객사의 데이터베이스나 플랫폼으로 가져오기 위해 데이터 데스티네이션을 설정하기 전, 지원되는 여러 다른 데이터 스키마를 먼저 확인하세요.
- 집계 마케팅 데이터에 지원되는 스키마에 대해서는 데이터 데스티네이션: 집계 마케팅 데이터 스키마 를 확인하세요.
- Singular 데이터 데스티네이션 소개와 동작 방법에 대해서는 Singular 데이터 데스티네이션(ETL) FAQ를 확인하세요.
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 | 어트리뷰션 이벤트를 일으킨 터치포인트(광고 클릭이나 노출)의 시간 |
데이터 스키마 변경
데이터 데스티네이션을 생성하고 저장한 이후에는 데이터 스키마를 변경할 수 없습니다. 기존 데이터가 존재하는 라이브 데이터베이스에서 테이블 구조를 변경하는 것은 위험 요소가 매우 크며 많은 복잡성이 발생하기 때문입니다.
데이터 스키마를 변경하려는 경우 기존 데이터 커넥터를 변경하는 대신 목적지를 새로 생성하거나 새로운 목적지를 구성해서 다른 이름의 신규 테이블에 데이터를 불러오세요. 이를 통해 데이터를 안전한 상태로 보장하고 기존 쿼리와 워크 로드가 계속 동작하도록 할 수 있습니다.
