[GA4] BigQuery Export 用户数据架构

设置

设置 BigQuery Export 时,您可以选择包含每天导出的用户数据。

数据表格

当您导出用户数据后,Google Analytics(分析)会在您的 BigQuery 项目中新建两个表格:

  • 伪 ID 表格
    • 包含与每个假名化标识符对应的行。只要其中一个字段发生更改,用户数据就会更新。
    • 未同意的用户的数据不会导出到此表格中。
    • 用户 ID 不会导出到此表格中。
    • 上次活动的时间戳会导出到此表格中。
  • 用户 ID 表格
    • 包含与每个用户 ID 对应的行。只要其中一个字段发生更改,用户数据就会更新。
    • 如果未同意的用户的数据中包含用户 ID,系统会将此类数据导出到此表格中。
    • 伪 ID 不会导出到此表格中
    • 上次活动的时间戳会导出到此表格中。

导出的用户数据中活跃用户数与所有用户数的对比

导出的数据包含当天数据发生变化的所有用户。例如,如果用户发起了会话,user_ltv.sessions 的生命周期价值也随之递增,则导出的数据将包含该用户。如果用户由于当天不再符合受众群体的包含条件(例如,用户在过去 7 天内未进行任何购买)而从受众群体中除名,其数据就会发生变化,则导出的数据将包含该用户。

包含的用户数不仅仅是根据活动数据,也基于数据变化,因此导出的用户数可能会超过指定日期或日期范围内“活跃用户数”指标的值(“活跃用户数”指标在报告中显示为“用户数”)。

如果您想查询导出的数据,以仅获取活跃用户数,可以使用开发者文档中列出的一些查询示例。

架构

以下几个部分介绍了 Google Analytics(分析)导出到伪 ID 表格和用户 ID 表格中的用户数据(具体数据会因上一部分中列举的差异而有所不同)。

审核

字段名称 数据类型 说明
occurrence_date 字符串 触发记录更改的日期
last_updated_date 字符串 表格中记录的更新日期

用户

字段名称 数据类型 说明
user_id 字符串 在报告中使用的 ID 中 User-ID 命名空间的 ID(仅限用户 ID 表格)
pseudo_user_id 字符串 假名化命名空间的 ID(仅限伪 ID 表格)
stream_id 整数 数据流 ID(仅限伪 ID 表格)

 

用户信息

字段名称 数据类型 说明
user_info.last_active_timestamp_micros 整数 用户上次活动的日期(以微秒为单位的时间戳)
user_info.user_first_touch_timestamp_micros 整数 用户的 first_open 或 first_visit 事件的日期,以两者中较早发生的时间为准(以微秒为单位的时间戳)
user_info.first_purchase_date 字符串 用户进行首次购买的日期 (YYYYMMDD)

 

隐私权信息

字段名称 数据类型 说明
privacy_info 记录 隐私权信息
privacy_info.is_ads_personalization_allowed 字符串

如果用户符合广告个性化条件,isAdsPersonalizationAllowed 会返回“true”。如果用户不符合广告个性化条件,isAdsPersonalizationAllowed 会返回“false”。

如果 Google Analytics(分析)目前无法返回此用户是否符合广告个性化条件,则 isAdsPersonalizationAllowed 会返回“(not set)”;如果 isAdsPersonalizationAllowed 返回“(not set)”,用户可能符合个性化广告条件,也可能不符合。对于个性化广告,当 isAdsPersonalizationAllowed 为用户返回“(not set)”时,您应该视为返回“false”,因为在大多数情况下,某些“(not set)”行会包含不符合广告个性化条件的用户。

如果 isAdsPersonalizationAllowed 返回“false”,用户仍可用于非广告用例,例如 A/B 测试和数据探索。

privacy_info.is_limited_ad_tracking 字符串 设备的“限制广告跟踪”设置。可能的值包括:“true”“false”和“(not set)”。如果 Google Analytics(分析)目前无法返回此设备的“限制广告跟踪”设置的启用情况,则 isLimitedAdTracking 会返回“(not set)”。

 

受众群体

字段名称 数据类型 说明
audiences 记录 受众群体信息
audiences.id 整数 受众群体的 ID
audiences.name 字符串 受众群体的名称
audiences.membership_start_timestamp_micros 整数 用户首次纳入受众群体的时间(以微秒为单位的时间戳)
audiences.membership_expiry_timestamp_micros 整数

用户的受众群体成员资格失效的时间(以微秒为单位的时间戳)

当新活动使用户重新满足纳入受众群体的资格条件时,该用户的成员资格有效期便会重置

audience.npa 布尔值 值为 true 或 false,具体取决于受众群体定义中包含的针对事件和用户级范围自定义维度的非个性化广告设置

 

属性

字段名称 数据类型 说明
user_properties 记录 用户属性信息
user_properties.key 字符串 用户属性维度名称
user_properties.value.string_value 字符串 用户属性维度值
user_properties.value.set_timestamp_micros 整数 上次设置维度值的时间(以微秒为单位的时间戳)
     

 

设备

字段名称 数据类型 说明
device 记录 设备信息
device.operating_system 字符串 设备操作系统
device.category 字符串 设备类别(移动设备、平板电脑、桌面设备)
device.mobile_brand_name 字符串 设备品牌名称
device.mobile_model_name 字符串 设备型号名称
device.unified_screen_name 字符串 屏幕名称

 

地理位置

字段名称 数据类型 说明
geo 记录 地理位置信息
geo.city 字符串 报告事件时所处的城市
geo.country 字符串 报告事件时所处的国家/地区
geo.continent 字符串 报告事件时所处的大洲
geo.region 字符串 报告事件时所处的区域

 

生命周期

字段名称 数据类型 说明
user_ltv 记录 生命周期信息
user_ltv.revenue_in_usd 双精度 生命周期内总收入(以美元为单位)
user_ltv.sessions 整数 生命周期内的会话总数
user_ltv.engagement_time_millis 整数 生命周期内的互动总时长(以毫秒为单位)
user_ltv.purchases 整数 生命周期内的购买总次数
user_ltv.engaged_sessions 整数 生命周期内感兴趣的会话总数
user_ltv.session_duration_micros 整数 生命周期内的会话总时长(以毫秒为单位)

 

预测

字段名称 数据类型 说明
predictions 记录 预测信息
predictions.in_app_purchase_score_7d 双精度 过去 28 天处于活跃状态的用户在未来 7 天内记录 in_app_purchase 事件的概率
predictions.purchase_score_7d 双精度 过去 28 天处于活跃状态的用户在未来 7 天内记录 purchase 事件的概率
predictions.churn_score_7d 双精度 过去 7 天在您的应用或网站上处于活跃状态的用户在未来 7 天内处于非活跃状态的概率
predictions.revenue_28d_in_usd 浮点数 过去 28 天处于活跃状态的用户在未来 28 天内记录的所有 purchase 事件预计可带来的收入(以美元为单位)

该内容对您有帮助吗?

您有什么改进建议?
搜索
清除搜索内容
关闭搜索框
主菜单
3202709339570076315
true
搜索支持中心
true
true
true
true
true
69256
false
false