WeChat public platform developer documentation /微信摇一摇数据统计

微信摇一摇数据统计

以设备为维度的数据统计接口

1475205218138256.jpg

接口说明

查询单个设备进行摇周边操作的人数、次数,点击摇周边消息的人数、次数;

查询的最长时间跨度为30天。只能查询最近90天的数据。

此接口无法获取当天的数据,最早只能获取前一天的数据。

由于系统在凌晨处理前一天的数据,太早调用此接口可能获取不到数据,建议在早上8:00之后调用此接口。

接口调用请求说明

http请求方式: POST(请使用https协议)https://api.weixin.qq.com/shakearound/statistics/device?access_token=ACCESS_TOKENPOST数据格式:json
POST数据例子:
{
"device_identifier":{
"device_id":10011,
"uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
"major":1002,
"minor":1223
},
"begin_date": 1438704000,
"end_date": 1438704000
}

参数说明

参数 是否必须 说明
access_token 调用接口凭证
device_identifier 指定页面的设备ID
device_id 设备编号,若填了UUID、major、minor,即可不填设备编号,二者选其一
UUID、major、minor UUID、major、minor,三个信息需填写完成,若填了设备编辑,即可不填此信息,二者选其一
begin_date 起始日期时间戳,最长时间跨度为30天,单位为秒
end_date 结束日期时间戳,最长时间跨度为30天,单位为秒


返回说明

正常时的返回JSON数据包示例:

{
"data": [
{
"click_pv": 0,
"click_uv": 0,
"ftime": 1425052800,
"shake_pv": 0,
"shake_uv": 0
},
{
"click_pv": 0,
"click_uv": 0,
"ftime": 1425139200,
"shake_pv": 0,
"shake_uv": 0
}
],
"errcode": 0,
"errmsg": "success."
}

参数说明

参数 说明
ftime 当天0点对应的时间戳
click_pv 点击摇周边消息的次数
click_uv 点击摇周边消息的人数
shake_pv 摇周边的次数
shake_uv 摇周边的人数


批量查询设备统计数据接口

接口说明

查询指定时间商家帐号下的每个设备进行摇周边操作的人数、次数,点击摇周边消息的人数、次数。

只能查询最近90天内的数据,且一次只能查询一天。

此接口无法获取当天的数据,最早只能获取前一天的数据。

由于系统在凌晨处理前一天的数据,太早调用此接口可能获取不到数据,建议在早上8:00之后调用此接口。

注意:对于摇周边人数、摇周边次数、点击摇周边消息的人数、点击摇周边消息的次数都为0的设备,不在结果列表中返回。

接口调用说明

http请求方式: POST(请使用https协议)https://api.weixin.qq.com/shakearound/statistics/devicelist?access_token=ACCESS_TOKENPOST数据格式:json
POST数据例子:
{
"date": 1438704000,
“page_index”:1
}

参数说明

参数 是否必须 说明
access_token 调用接口凭证
date 指定查询日期时间戳,单位为秒
page_index 指定查询的结果页序号;返回结果按摇周边人数降序排序,每50条记录为一页


返回说明

正常时的返回JSON数据包示例:

{
"data": {
"devices": [
{
"device_id": 10097,
"major": 10001,
"minor": 12102,
"uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825"
"shake_pv": 1
"shake_uv": 2
"click_pv": 3
"click_uv":4
},
{
"device_id": 10097,
"major": 10001,
"minor": 12102,
"uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825"
"shake_pv":1
"shake_uv":2
"click_pv":3
"click_uv":4
}
],
},
"date":1435075200
"total_count": 151
"page_index":1
"errcode": 0,
"errmsg": "success."
}

参数说明

参数 说明
device_id 设备编号
major、minor、uuid major、minor、uuid
click_pv 点击摇周边消息的次数
click_uv 点击摇周边消息的人数
shake_pv 摇周边的次数
shake_uv 摇周边的人数
date 所查询的日期时间戳
total_count 设备总数
page_index 所查询的结果页序号;返回结果按摇周边人数降序排序,每50条记录为一页

以页面为维度的数据统计接口


接口说明

查询单个页面通过摇周边摇出来的人数、次数,点击摇周边页面的人数、次数;查询的最长时间跨度为30天。只能查询最近90天的数据。

此接口无法获取当天的数据,最早只能获取前一天的数据。由于系统在凌晨处理前一天的数据,太早调用此接口可能获取不到数据,建议在早上8:00之后调用此接口。

接口调用说明

http请求方式: POST(请使用https协议)https://api.weixin.qq.com/shakearound/statistics/page?access_token=ACCESS_TOKENPOST数据格式:json
POST数据例子:
{
"page_id": 12345,
"begin_date": 1438704000,
"end_date": 1438704000
}

参数说明

参数 是否必须 说明
access_token 调用接口凭证
page_id 指定页面的设备ID
begin_date 起始日期时间戳,最长时间跨度为30天,单位为秒
end_date 结束日期时间戳,最长时间跨度为30天,单位为秒

返回说明

正常时的返回JSON数据包示例:

{
"data": [
{
"click_pv": 0,
"click_uv": 0,
"ftime": 1425052800,
"shake_pv": 0,
"shake_uv": 0
},
{
"click_pv": 0,
"click_uv": 0,
"ftime": 1425139200,
"shake_pv": 0,
"shake_uv": 0
}
],
"errcode": 0,
"errmsg": "success."
}

参数说明

参数 说明
ftime 当天0点对应的时间戳
click_pv 打开摇周边页面的次数
click_uv 打开摇周边页面的人数
shake_pv 摇出摇周边页面的次数
shake_uv 摇出摇周边页面的人数


批量查询页面统计数据接口

接口说明

查询指定时间商家帐号下的每个页面进行摇周边操作的人数、次数,点击摇周边消息的人数、次数。

只能查询最近90天内的数据,且一次只能查询一天。

此接口无法获取当天的数据,最早只能获取前一天的数据。

由于系统在凌晨处理前一天的数据,太早调用此接口可能获取不到数据,建议在早上8:00之后调用此接口。

注意:对于摇周边人数、摇周边次数、点击摇周边消息的人数、点击摇周边消息的次数都为0的页面,不在结果列表中返回。


接口调用说明

http请求方式: POST(请使用https协议)https://api.weixin.qq.com/shakearound/statistics/pagelist?access_token=ACCESS_TOKENPOST数据格式:json
POST数据例子:
{
"date": 1425139200,
“page_index”:1
}

参数说明

参数 是否必须 说明
access_token 调用接口凭证
date 指定查询日期时间戳
page_index 指定查询的结果页序号;返回结果按摇周边人数降序排序,每50条记录为一页


返回说明

正常时的返回JSON数据包示例:

{ "data": {
"pages": [
{
"page_id":1
"click_pv": 0,
"click_uv": 0,
"shake_pv": 0,
"shake_uv": 0
},
{
"page_id":1
"click_pv": 0,
"click_uv": 0,
"shake_pv": 0,
"shake_uv": 0
},
],
},
"date":1435075200
"total_count": 151
"page_index":1
"errcode": 0,
"errmsg": "success."
}

参数说明

参数 说明
page_id 页面ID
click_pv 点击摇周边消息的次数
click_uv 点击摇周边消息的人数
shake_pv 摇周边的次数
shake_uv 摇周边的人数
date 所查询的日期时间戳,单位为秒
total_count 页面总数
page_index 所查询的结果页序号;返回结果按摇周边人数降序排序,每50条记录为一页