有关Singular数据目标的一般信息、其工作原理以及可导出的不同数据类型,请参阅《Singular数据目标(ETL)常见问题解答》。
使用Singular数据目标时,系统会将不同来源的数据标准化为统一数据架构,以便您在数据库中轻松进行查询。
Singular提供多种数据架构供您选择。每种架构定义了不同的字段集,这些字段将由Singular数据目标加载至您的数据库。
转换和事件数据架构面向所有数据目的地用户开放,其余架构为高级功能。请参考下表选择最符合需求的数据架构。
用户级数据架构
有关各字段的详细说明,请参阅《导出日志:支持字段》。如需了解不同时间戳字段的含义,请参阅下文《时间戳含义与格式》。
默认模式
以下架构对所有客户开放。
包含安装和重新参与事件的相关信息、归因对象以及其他归因细节(例如:确定性归因还是概率性归因)。
注意:转化事件的位置信息基于事件关联的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
包含应用内事件数据,涵盖会话、注册、购买等在集成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平台提交工单
(帮助 > 联系我们)。
包含所有用于确定安装或重新参与归因的点击数据。
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从广告网络合作伙伴接收的所有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
包含广告网络直接从苹果接收的所有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 |
导致归因事件的触点(广告点击或广告展示)发生的时间。 |
更改数据架构
创建并保存数据目标后,无法切换至其他数据架构。这是因为在存有数据的运行数据库中更改表结构存在诸多风险与复杂性。
若需变更数据架构,请直接创建新目标。您可选择在创建新目标前删除旧表,或配置新目标将数据加载至名称不同的全新表中。此流程可确保数据安全无虞,现有查询与工作负载持续正常运行。