导出报表数据——事件分析
1.总数
POST _SJK_API_PATH_/api-v2/event/calculate_total
请求参数:
字段 | 格式 | 说明 | 是否必需 | 示例 |
---|---|---|---|---|
access_token | string | 通过oauth认证获取的token | 是 | |
platform_id | int | 平台id | 否 | web:1 H5:2 IOS:3 Android:4 微信小程序:5 |
predicates | array | 筛选条件 | 否 | predicates[0][values][]=搜索引擎&predicates[0][op]=eq&predicates[0][name]=channel_type 即为筛选访问渠道类型等于搜索引擎的数据。其中op操作符可能出现的值:eq / ne / gt / ge / lt / le / like / nlike / between / null / not null |
dimensions | array | 维度(即属性),用于分组查询 | 否 | 数据通过 base/attrs接口获取 dimensions[]=channel 即为按访问渠道名称分组 |
relation | string | 多个筛选条件(predicates)之间的关系 | 是 | 可能出现的值:and / or 若筛选条件不足2个,默认and |
granularity | string | 查询的时间粒度 | 是 | 可能出现的值:month / week / day |
time_range | array | 查询的时间范围 | 是 | time_range[]=2019-08-06&time_range[]=2019-08-12 需要有起始时间和结束时间2个值且结束时间不能小于起始时间 |
events | array | 指标信息 | 是 | 例:events[0][name]=DGA注册&events[0][fe_name]=signup&events[0][metrics][0][name]=event&events[0][metrics][0][op]= 所查询的指标为 “DGA注册”事件的次数 |
events数组详细参数
字段 | 格式 | 说明 |
---|---|---|
events[].name | string | 指标事件中文名称 |
events[].fe_name | string | 指标事件英文名称,可通过 base/events 获取 |
events[].metrics | array | 指标计算信息 |
events[].metrics[].name | string | 指标英文名称,可通过 base/event_params 获取 |
events[].metrics[].op | string | 指标计算方式,默认指标为null,可通过 base/event_params 获取 |
调用示例:
curl -d 'access_token=_TOKEN_&events[0][name]=浏览&events[0][fe_name]=view&events[0][metrics][0][name]=event&events[0][metrics][0][op]=&events[0][metrics][1][name]=unique_event&events[0][metrics][1][op]=&events[0][metrics][2][name]=unique_userid&events[0][metrics][2][op]=&events[0][relation]=and&dimensions[]=channel_type&relation=and&granularity=day&time_range[]=2019-08-12&time_range[]=2019-08-12' https://a.geekdata.com/api-v2/event/calculate_total
Response:
{
"status": 0,
"msg": {
"msg": "success",
"desc": ""
},
"data": [
[
"1075", //浏览总次数
"629", //浏览总人数
"13" //浏览用户总数
]
]
}
字段含义:[[指标1总数,指标2总数,...]]
2.柱状图
POST _SJK_API_PATH_/api-v2/event/calculate_chart
请求参数:同 总数 calculate_total 接口
调用示例:
curl -d 'access_token=_TOKEN_&events[0][name]=浏览&events[0][fe_name]=view&events[0][metrics][0][name]=event&events[0][metrics][0][op]=&events[0][metrics][1][name]=unique_event&events[0][metrics][1][op]=&events[0][metrics][2][name]=unique_userid&events[0][metrics][2][op]=&events[0][relation]=and&dimensions[]=channel_type&relation=and&granularity=day&time_range[]=2019-08-12&time_range[]=2019-08-12' https://a.geekdata.com/api-v2/event/calculate_chart
Response:
{
"status": 0,
"msg": {
"msg": "success",
"desc": ""
},
"data": [
[
"2019-08-12", //日期时间
"\u76f4\u63a5\u8bbf\u95ee", //维度1的值
"729", //浏览次数
"379", //浏览人数
"10" //浏览用户数
],
[
"2019-08-12",
"\u641c\u7d22\u5f15\u64ce",
"332",
"248",
"4"
],
[
"2019-08-12",
"\u5916\u94fe",
"18",
"8",
"0"
]
]
}
字段含义:[[时间,维度1,指标1,指标2,...],[...],..]
3.表格
POST _SJK_API_PATH_/api-v2/event/calculate_grid
请求参数:同 总数 calculate_total 接口
调用示例:
curl -d 'access_token=_TOKEN_&events[0][name]=浏览&events[0][fe_name]=view&events[0][metrics][0][name]=event&events[0][metrics][0][op]=&events[0][metrics][1][name]=unique_event&events[0][metrics][1][op]=&events[0][metrics][2][name]=unique_userid&events[0][metrics][2][op]=&events[0][relation]=and&dimensions[]=channel_type&relation=and&granularity=day&time_range[]=2019-08-12&time_range[]=2019-08-12' https://a.geekdata.com/api-v2/event/calculate_grid
Response:
{
"status": 0,
"msg": {
"msg": "success",
"desc": ""
},
"data": [
[
"2019-08-12",
"\u76f4\u63a5\u8bbf\u95ee",
"729",
"379",
"10"
],
[
"2019-08-12",
"\u641c\u7d22\u5f15\u64ce",
"332",
"248",
"4"
],
[
"2019-08-12",
"\u5916\u94fe",
"18",
"8",
"0"
]
]
字段含义:[[时间,维度1,维度2,...指标1,指标2,...],[...],..]
4.明细
POST _SJK_API_PATH_/api-v2/event/detail
请求参数:
字段 | 格式 | 说明 | 是否必需 | 示例 |
---|---|---|---|---|
access_token | string | 通过oauth认证获取的token | 是 | |
platform_id | int | 平台id | 否 | web:1 H5:2 IOS:3 Android:4 微信小程序:5 |
predicates | array | 筛选条件 | 否 | predicates[0][values][]=搜索引擎&predicates[0][op]=eq&predicates[0][name]=channel_type 即为筛选访问渠道类型等于搜索引擎的数据。其中op操作符可能出现的值:eq / ne / gt / ge / lt / le / like / nlike / between / null / not null |
dimensions | array | 维度(即属性),用于分组查询 | 否 | 数据通过 base/attrs接口获取 dimensions[]=channel 即为按访问渠道名称分组 |
relation | string | 多个筛选条件(predicates)之间的关系 | 是 | 可能出现的值:and / or 若筛选条件不足2个,默认and |
granularity | string | 查询的时间粒度 | 是 | 可能出现的值:month / week / day |
time_range | array | 查询的时间范围 | 是 | time_range[]=2019-08-06&time_range[]=2019-08-12 需要有起始时间和结束时间2个值且结束时间不能小于起始时间 |
events | array | 指标信息 | 是 | 例:events[0][name]=DGA注册&events[0][fe_name]=signup&events[0][metrics][0][name]=event&events[0][metrics][0][op]= 所查询的指标为 “DGA注册”事件的次数 |
predicates2 | array | 具体查询明细的时间和维度条件 | 是 | predicates2[0][name]=channel_type&predicates2[0][op]=eq&predicates2[0][values][]=外链&predicates2[1][op]=eq&predicates2[1][name]=dd&predicates2[1][values][]=2019-08-14 必须由时间维度和所选的dimensions的具体值组成限定条件 |
调用示例:
curl -d 'access_token=_TOKEN_&events[0][name]=浏览&events[0][fe_name]=view&events[0][metrics][0][name]=event&events[0][metrics][0][op]=&events[0][metrics][1][name]=unique_event&events[0][metrics][1][op]=&events[0][metrics][2][name]=unique_userid&events[0][metrics][2][op]=&events[0][relation]=and&dimensions[]=channel_type&predicates2[0][name]=channel_type&predicates2[0][op]=eq&predicates2[0][values][]=外链&predicates2[1][op]=eq&predicates2[1][name]=dd&predicates2[1][values][]=2019-08-14&relation=and&event_id=1&granularity=day&time_range[]=2019-08-14&time_range[]=2019-08-14' https://a.geekdata.com/api-v2/event/detail
Response:
{
"status": 0,
"msg": {
"msg": "success",
"desc": ""
},
"data": [
[
"3f145c974a9f38e8",
"-",
"2019-08-14 12:42:00",
"\u65b0\u8bbf\u5ba2",
"\u672a\u6ce8\u518c\u7528\u6237",
"\u5916\u94fe",
"baidu.com",
"\u56db\u5ddd",
"\u8fbe\u5dde"
],
[
"41a112e7eaed9e49",
"-",
"2019-08-14 15:03:00",
"\u56de\u8bbf\u8bbf\u5ba2",
"\u672a\u6ce8\u518c\u7528\u6237",
"\u5916\u94fe",
"galaxy.zcygov.cn",
"\u6d59\u6c5f",
"\u676d\u5dde"
],
[
"431208c9c2c8209b",
"-",
"2019-08-14 11:38:00",
"\u56de\u8bbf\u8bbf\u5ba2",
"\u672a\u6ce8\u518c\u7528\u6237",
"\u5916\u94fe",
"huaban.com",
"\u6d59\u6c5f",
"\u676d\u5dde"
],
[
"5d83095de86e96da",
"-",
"2019-08-14 10:34:00",
"\u65b0\u8bbf\u5ba2",
"\u672a\u6ce8\u518c\u7528\u6237",
"\u5916\u94fe",
"\u7b80\u4e66",
"\u5317\u4eac",
"\u5317\u4eac"
],
[
"72dd325e4f65ed47",
"-",
"2019-08-14 14:14:00",
"\u65b0\u8bbf\u5ba2",
"\u672a\u6ce8\u518c\u7528\u6237",
"\u5916\u94fe",
"www.datageek.cn",
"\u6c5f\u82cf",
"\u5357\u4eac"
],
[
"72dd325e4f65ed47",
"-",
"2019-08-14 14:13:00",
"\u65b0\u8bbf\u5ba2",
"\u672a\u6ce8\u518c\u7528\u6237",
"\u5916\u94fe",
"www.datageek.cn",
"\u6c5f\u82cf",
"\u5357\u4eac"
],
[
"8a4bb6ab5894d217",
"-",
"2019-08-14 07:43:00",
"\u65b0\u8bbf\u5ba2",
"\u672a\u6ce8\u518c\u7528\u6237",
"\u5916\u94fe",
"\u7b80\u4e66",
"\u9655\u897f",
"\u897f\u5b89"
],
[
"8af7a4fcb3f812c0",
"-",
"2019-08-14 05:53:00",
"\u65b0\u8bbf\u5ba2",
"\u672a\u6ce8\u518c\u7528\u6237",
"\u5916\u94fe",
"www.datageek.cn",
"\u5317\u4eac",
"\u5317\u4eac"
],
[
"91474bcab8620edb",
"-",
"2019-08-14 14:59:00",
"\u65b0\u8bbf\u5ba2",
"\u672a\u6ce8\u518c\u7528\u6237",
"\u5916\u94fe",
"www.uengager.com",
"\u5929\u6d25",
"\u5929\u6d25"
],
[
"91474bcab8620edb",
"-",
"2019-08-14 14:58:00",
"\u65b0\u8bbf\u5ba2",
"\u672a\u6ce8\u518c\u7528\u6237",
"\u5916\u94fe",
"www.uengager.com",
"\u5929\u6d25",
"\u5929\u6d25"
],
[
"977c5e9e25b3dbf2",
"-",
"2019-08-14 15:30:00",
"\u65b0\u8bbf\u5ba2",
"\u672a\u6ce8\u518c\u7528\u6237",
"\u5916\u94fe",
"bytedance.feishu.cn",
"\u798f\u5efa",
"\u798f\u5dde"
],
[
"b77aee79fdf33d01",
"-",
"2019-08-14 16:13:00",
"\u65b0\u8bbf\u5ba2",
"\u672a\u6ce8\u518c\u7528\u6237",
"\u5916\u94fe",
"baidu.com",
"\u6e56\u5317",
"\u6b66\u6c49"
],
[
"edd3282f22ec30fa",
"-",
"2019-08-14 11:14:00",
"\u65b0\u8bbf\u5ba2",
"\u672a\u6ce8\u518c\u7528\u6237",
"\u5916\u94fe",
"\u7b80\u4e66",
"\u5317\u4eac",
"\u5317\u4eac"
]
]
}
字段含义 [[GeekDataID,用户ID,最近访问时间,访客类型,注册类型,渠道类型,渠道名称,所在省份,所在城市]..]