导出报表数据——页面分析
1.总数
POST _SJK_API_PATH_/api-v2/page/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个值且结束时间不能小于起始时间 |
page_group_id | int | 页面组id | 否 | 数据通过base/page_groups接口获取,-1为全部页面,若选择某一指定页面url,本参数可不传 |
page_url | string | 页面url | 否 | 某一指定页面包含http://或https://的完整url地址,若选择全部页面或页面组,本参数可不传 |
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_&page_group_id=-1&page_url=&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]=&dimensions[]=url&relation=and&granularity=hour&time_range[]=2019-08-12&time_range[]=2019-08-12' https://a.geekdata.com/api-v2/page/calculate_total
Response:
{
"status": 0,
"msg": {
"msg": "success",
"desc": ""
},
"data": [
[
"2383",
"1421",
"25"
]
]
}
字段含义:[[指标1总数,指标2总数,...]]
2.柱状图
POST _SJK_API_PATH_/api-v2/page/calculate_chart
请求参数:同 总数 calculate_total 接口
调用示例:
curl -d 'access_token=_TOKEN_&page_group_id=-1&page_url=&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]=&dimensions[]=url&relation=and&granularity=hour&time_range[]=2019-08-12&time_range[]=2019-08-12' https://a.geekdata.com/api-v2/page/calculate_chart
Response:
{
"status": 0,
"msg": {
"msg": "success",
"desc": ""
},
"data": [
[
"2019-08-12 00:00:00",
"78",
"61",
"0"
],
[
"2019-08-12 01:00:00",
"83",
"56",
"0"
],
[
"2019-08-12 02:00:00",
"57",
"42",
"0"
],
[
"2019-08-12 03:00:00",
"45",
"31",
"0"
],
[
"2019-08-12 04:00:00",
"45",
"33",
"0"
],
[
"2019-08-12 05:00:00",
"46",
"27",
"0"
],
[
"2019-08-12 06:00:00",
"49",
"35",
"0"
],
[
"2019-08-12 07:00:00",
"60",
"41",
"0"
],
[
"2019-08-12 08:00:00",
"99",
"77",
"2"
],
[
"2019-08-12 09:00:00",
"281",
"151",
"9"
],
[
"2019-08-12 10:00:00",
"254",
"130",
"7"
],
[
"2019-08-12 11:00:00",
"268",
"145",
"9"
],
[
"2019-08-12 12:00:00",
"139",
"104",
"2"
],
[
"2019-08-12 13:00:00",
"185",
"150",
"0"
],
[
"2019-08-12 14:00:00",
"282",
"189",
"6"
],
[
"2019-08-12 15:00:00",
"264",
"164",
"7"
],
[
"2019-08-12 16:00:00",
"148",
"85",
"10"
]
]
}
字段含义:[[时间,指标1,指标2,...],[...],..]
3.表格
POST _SJK_API_PATH_/api-v2/event/calculate_grid
请求参数:同 总数 calculate_total 接口
调用示例:
curl -d 'access_token=_TOKEN_&page_group_id=-1&page_url=&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]=&dimensions[]=url&relation=and&granularity=day&time_range[]=2019-08-12&time_range[]=2019-08-12' https://a.geekdata.com/api-v2/page/calculate_grid
Response:
{
"status": 0,
"msg": {
"msg": "success",
"desc": ""
},
"data": [
[
"2019-08-12",
"https:\/\/www.geekdata.com\/persona",
"1",
"1",
"0"
],
[
"2019-08-12",
"https:\/\/www.geekdata.com\/warning",
"1",
"1",
"0"
],
[
"2019-08-12",
"https:\/\/www.geekdata.com\/product\/index.html",
"1",
"1",
"0"
],
[
"2019-08-12",
"https:\/\/www.geekdata.com\/document\/data_tag.html",
"1",
"1",
"0"
],
[
"2019-08-12",
"https:\/\/www.geekdata.com\/product\/analytics-soft.html",
"6",
"3",
"1"
]
]
}
字段含义:[[时间,维度1,维度2,...指标1,指标2,...],[...],..]
4.明细
POST _SJK_API_PATH_/api-v2/page/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个值且结束时间不能小于起始时间 |
page_group_id | int | 页面组id | 否 | 数据通过base/page_groups接口获取,-1为全部页面,若选择某一指定页面url,本参数可不传 |
page_url | string | 页面url | 否 | 某一指定页面包含http://或https://的完整url地址,若选择全部页面或页面组,本参数可不传 |
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_&page_group_id=-1&page_url=&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]=&dimensions[]=url&predicates2[0][name]=url&predicates2[0][op]=eq&predicates2[0][values][]=https://www.geekdata.com/solution/role05.html&predicates2[1][op]=eq&predicates2[1][name]=hour&predicates2[1][values][]=2019-08-12T16:00:00.000Z&predicates2[1][values][]=2019-08-12T17:00:00.000Z&relation=and&event_id=1&granularity=hour&time_range[]=2019-08-12&time_range[]=2019-08-12' https://a.geekdata.com/api-v2/page/detail
Response:
{
"status": 0,
"msg": {
"msg": "success",
"desc": ""
},
"data": [
[
"d60503b54f06e1ce",
"-",
"2019-08-12 16:03:00",
"\u65b0\u8bbf\u5ba2",
"\u672a\u6ce8\u518c\u7528\u6237",
"\u76f4\u63a5\u8bbf\u95ee",
"\u76f4\u63a5\u8bbf\u95ee",
"\u5317\u4eac",
"\u5317\u4eac"
]
]
}
字段含义 [[GeekDataID,用户ID,最近访问时间,访客类型,注册类型,渠道类型,渠道名称,所在省份,所在城市]..]