Dokumentasi pembangun platform awam WeChat / 微信摇一摇数据统计

微信摇一摇数据统计

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

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、minorUUID、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、uuidmajor、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条记录为一页