文档

数据注册与字段配置

更新时间:

数据注册

数据注册需要您已经开通MaxCompute、绑定项目,再注册MaxCompute表,该注册表是效果统计的中间表(实验报表来源表),即以user_id、exp_id、维度指标作为联合主键统计的数据表。表示某个用户在某个实验下的曝光、点击等指标,也可以增加国家维度作为“user_id+国家+exp_id”下的中间统计表。后面配置单维指标和衍生指标都依赖这个中间表。在具体讲实验报表来源表之前,我们回顾一下实验的整体架构,如下图:

image.png

PAI-REC 引擎是我们的推荐服务,里面集成了配置中心的 SDK,实验信息从配置中心获取到。在推荐服务返回接口中,会记录实验id(exp_id), 以及请求的标识(reqid)等。

当用户在App上操作产生行为时,行为日志会通过App上的前端埋点回流到 ODPS(即MaxCompute) 中。在“SQL统计”环节,产出“实验报表来源表”。在配置中心配置了若干个指标后,我们会动态组装 SQL, 然后对“实验报表来源表”进行计算、统计,并把结果存到 Hologres 中。在实验报表页面,可以查询到指标数据。

离线“实验报表来源表”的格式

字段名称

字段含义

是否必填

说明

user_id

用户id

用户标识,可以是用户的 uid, 也可以是设备 devcie_id, imei 等

exp_id

实验id

ab 服务返回的实验id, 通过埋点回流。如果是用户的自己的推荐服务,设置自定义的标识即可。exp_id:ER1_L1#EG1#E1_L2#EG2#E2

维度字段

比如操作系统 os

可以根据此维度字段过滤对应的指标

计算字段

计算字段可以是多个,

如曝光:show_count;点击:click_count

计算字段是用户填写的数值类型,比如曝光数,点击数,观看时长等

dt

日期分区

格式:yyyyMMdd

hh

小时分区

24小时制, 00 ~ 23

mm

分钟分区

00 ~ 59

来源表可以离线产出,也可以实时产出,主要看客户的业务系统。如果是离线产出, user_id, exp_id, dt 是必须的。 如果是实时的,user_id, exp_id, dt, hh 是必须的,mm 分区不是必须的。

指标也分为离线和实时。如果是实时产出的数据源,离线、实时指标可以共用一个数据源。如果是离线产出的数据源,只能创建离线指标,无法创建实时指标。

上面的维度字段也不是必需的,加上维度字段可以对指标进行维度分析。比如常见的维度字段有性别、操作系统(IOS, 安卓)等。这样报表的数据可以分 男女,ios 和 安卓进行查看。

实时“实验报表来源表”的格式

字段名称

字段含义

是否必填

说明

exp_id

实验id

ab 服务返回的实验id, 通过埋点回流。如果是用户的自己的推荐服务,设置自定义的标识即可。如果是ab 服务的实验id, exp_id 是拆分开的,具体到某一个实验上。 比如 L1#EG1#E1, L2#EG2#E2

维度字段

比如操作系统 os

可以根据此维度字段过滤对应的指标

metric_name

指标的名称,比如 pv, uv, ctr 等

metric_value

指标的值

float64 值

dt

日期字段

格式:yyyyMMdd

hh

小时字段

24小时制, 00 ~ 23

mm

分钟字段

00 ~ 59

结果表字段基本都是固定的,只有维度字段是可变的。维度字段的定义与来源表中的定义保持一致即可。

离线指标和实时指标不能混用一个结果表。离线指标结果表只需要有 dt 日期字段即可。实时指标至少要有 hh 小时字段 。

有了“实验报表来源表”之后打开控制台“指标管理-数据注册”页面,即可选择新增MaxCompute数据表。

建议用户直接使用系统默认的Hologres表(不占用用户资源)用于指标计算结果的回写,系统会自动为您建表、存储相关指标数据。当然客户也可以使用自己的Hologres实例表,而不用默认的Hologres表。

新增注册MaxCompute表

单击新增数据表,需要选择绑定好的MaxCompute项目空间,并选择要新增的MaxCompute当中的数据表,并自定义一个名称,点击开始导入即可导入表中数据。

说明

若您注册的数据表字段结构发生变化,请及时执行重新导入的操作,否则系统可能无法识别到字段变更。

image.png

字段配置

注册好的数据表会自动出现在列表中,您可以点击查看字段按钮查看数据表中的字段,对字段和相关信息进行核对或编辑。

维度字段

image.png

  • 本页导读 (0)