API Description
Queries the number of Shake Nearby users, the number of Shake Nearby operations, the number of users tapping on Shake Nearby messages, and the number of taps on Shake Nearby messages for a single device.
The longest time span of the query is 30 days. Only the data of last 90 days can be queried.
This API can only obtain the data of the previous day, but cannot obtain the data of the day.
Because the system processes the data of the previous day in the early hours of the morning, calling this API too early may not obtain the data. It is recommended to call this API after 8:00 am.
API Request Format
HTTP request method: POST (use the HTTPS protocol)https://api.weixin.qq.com/shakearound/statistics/device?access_token=ACCESS_TOKEN
POST data format: json
POST data example:
{
"device_identifier":{
"device_id":10011,
"uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
"major":1002,
"minor":1223
},
"begin_date": 1438704000,
"end_date": 1438704000
}
Parameters
| Parameter | Required | Description |
|---|---|---|
| access_token | Yes | The credential for calling the API |
| device_identifier | Yes | The device ID of the specified page |
| device_id | Yes | Device ID. This parameter is not required if UUID, major, and minor are entered. |
| UUID, major, minor | Yes | This parameter is not required if device ID is entered. |
| begin_date | Yes | Timestamp of the start date (in sec). The longest time span is 30 days. |
| end_date | Yes | Timestamp of the end date (in sec). The longest time span is 30 days. |
Response
Example of JSON packet returned for a successful request:
{
"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."
}
Parameters
| Parameter | Description |
|---|---|
| ftime | Timestamp corresponding to 0 o'clock on the day |
| click_pv | Number of taps on Shake Nearby messages |
| click_uv | Number of users tapping on Shake Nearby messages |
| shake_pv | Number of Shake Nearby operations |
| shake_uv | Number of users of Shake Nearby |