Skip to content

用户属性表

User Property Table(用户属性表) 是一张描述"用户是谁"的表 —— 国家、版本、生命周期分群、付费状态、留存分桶 —— 而非"用户做了什么"。ABetterChoice 用它来支撑维度特征

在控制台的位置

Data Management → Tables 列出所有已注册的表,TypeUser Property Data Source 的行就是本页面描述的对象。

用户属性表详情页 —— 含 Apply to Causal Inference 与 Data Output Type 两个特有字段

标签不一致提示

列表页把这类行显示为 User Property Data Source,但 New Table 弹窗的 Table Type 下拉以及详情页把同一类型显示为 User Property Table。两者指的是同一对象 —— 本套文档统一使用 User Property Table 作为正式名称。

表单字段

打开 New Table(或已有用户属性表的详情页)。当 Table TypeUser Property Table 时,表单需要填写:

字段说明
Data Warehouse当前固定为 BigQuery
DataSet ID源表所在的 BigQuery 数据集。
Table ID要注册的 BigQuery 表,下拉受 DataSet ID 过滤。
Name展示名,默认与 Table ID 一致。
Owner默认为当前用户且不可清空。
Description (Optional)自由文本。
Apply to Causal Inference复选框。勾选后,该表的列可被注册为特征,平台据此进行 HTE 分析 与 CUPED 方差减少。
Data Output Type单选:Incremental(默认)或 Full。告诉 ABetterChoice 每个新分区是增量还是全量快照。
User ID Field用来与分流表、事实表 join 的列。
Partition FieldABetterChoice 用来挑选合适快照的列。
Partition Field TypeDateTimestampDatetime

用户属性表 没有 Event Time Field —— 它描述的是用户的状态,不是事件级活动。

下方的 Schema 面板会列出 BigQuery 列与检测到的类型。

IncrementalFull 的差异

Data Output Type 是用户属性表特有、且会真正改变 ABetterChoice 读数行为的字段:

  • Incremental —— 每个分区只包含当天发生变化的行。ABetterChoice 在读取时会合并历史分区以重建每个用户的最新状态。
  • Full —— 每个分区都是当日全量用户的快照。ABetterChoice 仅读取最新一个分区。

请按上游流水线实际写表的方式选择。错配(增量被声明为 Full,或反之)会导致重复计数或漏算。

真实用户属性表的样子

Demo 项目 6666 注册的用户属性表是 abc_user_property_date_partition —— 一张按日生成的用户属性快照表,覆盖字符串、整数、浮点等多种用户属性。它的注册配置:

  • Apply to Causal Inference —— 已勾选。
  • Data Output Type —— Incremental
  • User ID Field = user_idPartition Field = dsPartition Field Type = Date

它的 schema 覆盖四类属性:

分组用途
身份与分区user_idstring)、dsdatejoin 与快照选取。
设备与地域countrylanguagedevice_platformdevice_modelos_versionapp_versioninstall_channelstring维度切分与特征列。
人群属性与分群genderuser_segmentstring);ageintegerHTE 用的特征列。
行为聚合register_daystotal_login_daystotal_session_countmax_level_passedtotal_pay_countinteger);total_pay_amount_usdtotal_ad_revenue_usdltv_predicted_usdavg_session_duration_minuteretention_d7float实验前基线、CUPED 协变量与特征列。

维度与特征如何消费它

一张用户属性表可以供给:

  • 维度 —— 用于切分实验结果的分群定义。
  • 特征 —— 仅当 Apply to Causal Inference 勾选后,列可被注册为特征,进而供 HTE 分析 使用。

维度不会出现在 HTE 分析里 —— HTE 只消费特征与特征组合。受众也不消费用户属性表;受众规则落在 Audience 下单独注册的属性上。

编辑与归档

详情页以只读为主。Apply to Causal InferenceData Output Type 之后还能切换,但更改不会回填历史结果。唯一的破坏性操作是列表页的 Archive;详见 表生命周期