用户级ETL:用户级(事件级)数据模式

文档

有关Singular数据目标的一般信息、其工作原理以及可导出的不同数据类型,请参阅《Singular数据目标(ETL)常见问题解答》

使用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
辅助用户级数据架构

包含辅助安装的用户级数据,提供促成转化但非最终归因的触点详情。

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 回传

包含广告网络直接从苹果接收的所有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欺诈预防机制》及《欺诈报告与欺诈日志常见问题解答》)。

该数据包含与安装事件关联的每次点击和展示的记录——包括"自然安装"选项的记录,该选项同样作为每次安装的归因选项进行分析。因此您可能看到单次安装存在多个因欺诈被拒绝的触点。若需对同一安装的所有点击和展示进行排序或分组,请使用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
touchpoint_timestamp_unix_utc
导致归因事件发生的触点(广告点击或广告展示)发生的时间。
事件
调整后时间戳
调整后时间戳_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
导致归因事件的触点(广告点击或广告展示)发生的时间。

更改数据架构

创建并保存数据目标后,无法切换至其他数据架构。这是因为在存有数据的运行数据库中更改表结构存在诸多风险与复杂性。

若需变更数据架构,直接创建新目标。您可选择在创建新目标前删除旧表,或配置新目标将数据加载至名称不同的全新表中。此流程可确保数据安全无虞,现有查询与工作负载持续正常运行。