数据目标：用户级别（事件级别）数据模式

关注
Avatar
Vaibhav Gupta
Updated

有关 Singular 数据目的地的一般信息、工作原理以及可导出的不同数据类型，请参阅Singular 数据目的地（ETL）常见问题解答。

使用 Singular 数据目的地时，Singular 会将不同来源的数据标准化为相同的数据模式，以便于在数据库中查询。

Singular 提供不同的数据模式供你选择。每种模式都定义了一组不同的字段，Singular 数据目的地会将这些字段加载到你的数据库中。

所有数据目的地客户都可以使用转换和事件，而其他模式则是高级功能。请使用下表帮助您选择最适合您需求的数据模式。

用户级数据模式

有关每个字段的详细信息，请参阅导出日志：要了解不同的时间戳字段，请参阅下面的时间戳含义和格式。

注：用户级印象可作为 S3 的自定义模式使用。有关详细信息，请联系您的客户成功经理。

默认模式

我们的所有客户均可使用以下模式。

属性(v2) 数据模式

包括有关安装和重新参与事件的信息、归因于谁以及有关归因的其他详细信息（例如，是确定性的还是概率性的）。

注意：为转换事件提供的位置是基于与事件关联的 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
事件（v3）数据模式

包含应用程序内事件的数据，包括会话、注册、购买以及集成 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
  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

其他模式

要使用以下模式之一，请通过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 回传。请参阅 "如何将 SKAdNetwork 回传发送到 Singular（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结尾的字段包含以 UNIX 时间戳格式（整数）表示的 UTC 时间。
  • 请注意，BigQuery 目的地不支持时区。发送到 BigQuery 的所有时间戳都是 UTC 时间。
时间戳字段 描述
etl_record_processing_hour_utc Singular 完全处理数据的时间。每隔一小时，Singular 会对前一小时内完全处理完毕的数据更新该值。
属性
event_timestamp
event_timestamp_unix_utc		 设备上发生归因事件（如安装）的时间。
touchpoint_timestamp
touchpoint_timestamp_unix_utc		 导致归因事件发生的接触点（广告点击或广告印象）的时间。
事件
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		 导致归因事件发生的接触点（广告点击或广告印象）的时间。

更改数据模式

创建并保存数据目的地后，就不能再切换到其他数据模式。这是因为在有现有数据的实时数据库中更改表结构会带来许多危险和复杂问题。

如果需要更改数据模式，只需创建一个新的目标即可。在创建新目标之前，可以先删除旧表，或者配置新目标，将数据加载到名称不同的新表中。这一过程将确保数据安全，现有查询和工作负载也能继续工作。