SSPTaurusX SSP Reporting API v1
Domain:
sh
http://reportapi.taxssp.comhttp://reportapi.taxssp.comToken
You can get your token id in your account info.
API
Get data
- Get data request url: /reportapi/v1/publisher
- Return data
- Related request parameters:
| Name | Description | Value |
|---|---|---|
| token | Account token | string:required |
| start | Start time | string:required |
| end | End time | string:required |
| group | Supporting various dimensions data: date, hour, app_id, placement_id, country, ad_type, os_id, seperating by "," . | |
| showTotal | 1： to show the total data； 0：not to show the total data | int |
Note:
a. Access to day-by-day data with a maximum time span of 7 days
b. Access to hourly data with a maximum time span of 1 day
- Request sample:
sh
/reportapi/v1/publisher?start=2024-03-26&end=2024-03-28&token=xxxxxx&group=date&showTotal=1/reportapi/v1/publisher?start=2024-03-26&end=2024-03-28&token=xxxxxx&group=date&showTotal=1- Related return parameters:
| Name | Description | Value |
|---|---|---|
| status | Return status | int |
| message | Return message, details please see below. | string |
| data | Detailed report data | object |
| date | date | string |
| hour | hour | string |
| country | country | string |
| os_id | os | 1：ios; 2：android |
| ad_type | ad type | 1：native；2：rewarded_video；3：interstitial 5: image |
| app_id | app id | string |
| app_pkg | app package | string |
| placement_id | placement id | string |
| show | impression | int |
| revenue | revenue | float |
| request | request | int |
| fill | fill | int |
| fill_rate | fill rate | float |
| click | click | int |
| CTR | ctr | float |
| ECPM | ecpm | float |
| Total | total number | object |
- Return Sample:
json
{
"data": [
{
"CTR": 0.2404,
"ECPM": 3.0737,
"click": 1535,
"date": "2024-03-28",
"fill": 10914,
"fill_rate": 0.0863,
"request": 126478,
"revenue": 19.6222,
"show": 6384
},
{
"CTR": 0.2308,
"ECPM": 2.9588,
"click": 13745,
"date": "2024-03-27",
"fill": 96606,
"fill_rate": 0.0934,
"request": 1034717,
"revenue": 176.2392,
"show": 59564
},
{
"CTR": 0.2395,
"ECPM": 2.9359,
"click": 15399,
"date": "2024-03-26",
"fill": 101278,
"fill_rate": 0.0882,
"request": 1147831,
"revenue": 188.79869999999997,
"show": 64307
}
],
"message": "Success",
"status": 200,
"total": {
"CTR": 0.2355,
"ECPM": 2.9531,
"click": 30679.0,
"fill": 208798.0,
"fill_rate": 0.0904,
"request": 2309026.0,
"revenue": 384.6601,
"show": 130255.0
}
}{
"data": [
{
"CTR": 0.2404,
"ECPM": 3.0737,
"click": 1535,
"date": "2024-03-28",
"fill": 10914,
"fill_rate": 0.0863,
"request": 126478,
"revenue": 19.6222,
"show": 6384
},
{
"CTR": 0.2308,
"ECPM": 2.9588,
"click": 13745,
"date": "2024-03-27",
"fill": 96606,
"fill_rate": 0.0934,
"request": 1034717,
"revenue": 176.2392,
"show": 59564
},
{
"CTR": 0.2395,
"ECPM": 2.9359,
"click": 15399,
"date": "2024-03-26",
"fill": 101278,
"fill_rate": 0.0882,
"request": 1147831,
"revenue": 188.79869999999997,
"show": 64307
}
],
"message": "Success",
"status": 200,
"total": {
"CTR": 0.2355,
"ECPM": 2.9531,
"click": 30679.0,
"fill": 208798.0,
"fill_rate": 0.0904,
"request": 2309026.0,
"revenue": 384.6601,
"show": 130255.0
}
}