Request method: POST.
Calling frequency limit: 200 times/hour.
The API request address corresponds to the service access point one by one; therefore, please select the request address corresponding to your application service access point.
Service access point in Guangzhou:
https://api.tpns.tencent.com/v3/statistics/get_push_channel_stat_overviewService access point in Hong Kong (China):
https://api.tpns.hk.tencent.com/v3/statistics/get_push_channel_stat_overviewService access point in Singapore:
https://api.tpns.sgp.tencent.com/v3/statistics/get_push_channel_stat_overviewService access point in Shanghai:
https://api.tpns.sh.tencent.com/v3/statistics/get_push_channel_stat_overviewFeature: this API is used to query the daily push conversion summary within a certain time period by push channel.
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| startDate | Yes | String | Query start date |
| endDate | Yes | String | Query end date. Format: YYYYMMDD |
| Parameter Name | Type | Description |
|---|---|---|
| retCode | Integer | Returned status code |
| errMsg | String | Error message |
| pushDateChannelStat | Array | Returned result: result array by day. Individual elements in the array represent daily statistics by channel, formed by date and channelDatas. The element structure of channelDatas is as follows |
| Parameter Name | Type | Description |
|---|---|---|
| channel | String | Push channel name. xg: TPNS channel hw: Huawei channel xm: Mi channel mz: Meizu channel oppo: OPPO channel vivo: Vivo channel apns: APNs channel fcm: FCM channel rog: ROG channel |
| pushState | Object | Push funnel statistics. For the data structures, please see pushState below |
| Parameter Name | Type | Description |
|---|---|---|
| pushActiveUv | Integer | Scheduled Number of available devices connected to the Internet within 90 days that meet the target push conditions and on which the notification bar is enabled. |
| pushOnlineUv | Integer | Sent Actual number of available devices in the scheduled devices that have been delivered to vendor channels or to process online terminal using TPNS channel. |
| arrivalUv | Integer | Number of reached devices (including arrival receipts for the TPNS and vendor channels. For the Huawei and Meizu channels, you need to add a configuration item for arrival receipt manually. For more information, please see Acquisition of Vendor Channel Arrival Receipt) |
| verifySvcUv | Integer | Number of reached devices (only valid for TPNS, ROG, and FCM channels. For other vendor channels, the pushOnlineUv metric of actual deliveries by TPNS will be used). Note: this field will be disused subsequently. You are recommended to check the arrivalUv field for arrival data |
| callbackVerifySvcUv | Integer | Arrival receipt for vendor channel (for the Huawei and Meizu channels, you need to add a configuration item for arrival receipt manually. For more information, please see Acquisition of Vendor Channel Arrival Receipt). Note: this field will be disused subsequently. You are recommended to check the arrivalUv field for arrival data |
| clickUv | Integer | Clicked |
| cleanupUv | Integer | Cleared |
Note：
The "all" channel in the array corresponds to the aggregated statistics.
- In the aggregated statistics, the
verifySvcUv(reached devices),verifyUv(displayed),clickUv(clicked), andcleanupUv(cleared) metrics only aggregates the data of the TPNS, ROG, and FCM channels.- In the aggregated statistics,
pushActiveUv(attempted) andpushOnlineUv(sent) aggregates the data of the TPNS channel and vendor channels.- In the aggregated statistics,
callbackVerifySvcUv(arrival receipt of vendor channel) aggregates the data of vendor channel'scallbackVerifySvcUv(arrival receipt of vendor channel) + TPNS channel'sverifySvcUv(reached devices) + ROG channel'sverifySvcUv(reached devices) + FCM channel'sverifySvcUv(device reached).
| Parameter Name | Type | Description |
|---|---|---|
| pushActiveUv | Integer | Attempted |
| pushOnlineUv | Integer | Successfully received by APNs |
| verifySvcUv | Integer | Reached |
| clickUv | Integer | Clicked |
{
"startDate": "20200216",
"endDate": "20200216"
}{
"retCode": 0,
"errMsg": "NO_ERROR",
"pushDateChannelStat": [
{
"date": "20200216",
"channelDatas": [
{
"channel": "xm",
"pushState": {
"pushActiveUv": 1000,
"pushOnlineUv": 1000,
"verifySvcUv": 1000,
"callbackVerifySvcUv": 800,
"arrivalUv": 1000,
"verifyUv": 1000,
"clickUv": 0,
"cleanupUv": 0
}
},
{
"channel": "hw",
"pushState": {
"pushActiveUv": 1000,
"pushOnlineUv": 1000,
"verifySvcUv": 1000,
"callbackVerifySvcUv": 800,
"arrivalUv": 1000,
"verifyUv": 1000,
"clickUv": 0,
"cleanupUv": 0
}
},
{
"channel": "oppo",
"pushState": {
"pushActiveUv": 1000,
"pushOnlineUv": 1000,
"verifySvcUv": 1000,
"callbackVerifySvcUv": 800,
"arrivalUv": 1000,
"verifyUv": 1000,
"clickUv": 0,
"cleanupUv": 0
}
},
{
"channel": "xg",
"pushState": {
"pushActiveUv": 1000,
"pushOnlineUv": 800,
"verifySvcUv": 800,
"callbackVerifySvcUv": 0,
"arrivalUv": 1000,
"verifyUv": 800,
"clickUv": 300,
"cleanupUv": 500
}
},
{
"channel": "all",
"pushState": {
"pushActiveUv": 4000,
"pushOnlineUv": 3800,
"verifySvcUv": 3800,
"callbackVerifySvcUv": 2400,
"arrivalUv": 3800,
"verifyUv": 3800,
"clickUv": 300,
"cleanupUv": 500
}
}
]
}
]
}
Was this page helpful?