【POST】 /uba/api/userAttributes/analyze
接口请求参数,更多参数说明参照 查询API 中的 通用参数 说明。
{// 【必填】查询指标,含用户数和某用户属性的去重数等"measure":{//在获取某个属性的聚合结果时候才需要填"expression":"",//【必填】聚合操作符 这里表示用户数"aggregator":"USER_COUNT"},//【必填】用户分群"crowds":["$ALL"],//使用缓存 这里表示是"useCache":true,"limit":50,// 针对于指标的过滤条件,非必填,只能选择用户属性"filter":{"conditions":[{"expression":"user.xwho","function":"NOT_NULL","params":[]}],"relation":"AND"},//按XX维度查看,可以输入多个,可以为空,只能选择用户属性"byFields":[{"expression":"user.$city"}]}
特殊说明:
1、参数在示例中未标注必填的表示选填。
2、请求参数可以通过方舟产品生成,具体参照 接口请求参数获取。
3、接口不支持日期对比和分群对比。
4、属性分析中的所有表达式都为用户属性表达式,只支持用户属性的查看、过滤。
认证参数:接口必传token和appKey两个参数,详情见 项目接口认证。
aggregator:聚合表达式,支持查看总用户数或某个属性的聚合结果。
不需要表达式查看总体的聚合操作符如下:
USER_COUNT :用户数。
用户属性表达式支持的聚合操作符如下:
REMOVE_DUMPLICATE :表示去重数,支持所有数据类型。
SUM:总和,选定属性的属性值求和,例如加入购物车的商品金额之和,只支持数值类型。
AVG:均值,选定属性的属性值算数平均数,例如加入购物车的商品金额均值,只支持数值类型。
MAX: 最大值,选定属性的属性值最大值,例如加入购物车的商品最大金额,只支持数值类型。
MIN :最小值,选定属性的属性值最小值,例如加入购物车的商品最小金额,只支持数值类型。
AVG_PER: 人均值,选定属性的属性值人均值,例如人均加入购物车的商品金额,只支持数值类型。
//一、无细分维度(查看用户数){"rows": [{//指标查询结果"value": 88399,"byValue": []}],"measure": "USER_COUNT","byFields": [],"reportUpdateTime": "2019-10-09 11:19:40"}//二、有细分维度{//查询结果"rows": [{//维度对应的指标值"value": 27206,//维度分类"byValue": ["2018-05-07 00:00:00"]},{"value": 7683,"byValue": ["2018-05-08 00:00:00"]},{"value": 5859,"byValue": ["2018-05-10 00:00:00"]},{"value": 5277,"byValue": ["2018-05-09 00:00:00"]},{"value": 3548,"byValue": ["2018-05-11 00:00:00"]}],//查询的指标"measure": "USER_COUNT",//按照首次访问时间查看"byFields": ["user.$first_visit_time"],"reportUpdateTime": "2019-10-09 11:24:34"}
curl -H "Content-Type:application/json" -H "token:4113c9cad1c301113783f433e254888c" -H "appKey:31abd9593e9983ec" -X POST --data '{"measure":{"aggregator":"USER_COUNT"},"useCache":true,"limit":50,"crowds":["$ALL"],"byFields":[]}' http://127.0.0.1:4005/uba/api/userAttributes/analyze