SSP投放报表查询接口API¶

ssp投放报表查询接口¶

请求url: http://sspcp.adx.yumimobi.com/api/index
请求方式: GET
请求参数:

参数名	必选	类型	说明
token	是	string	zplay分配的ssp_token
start_date	否	string	开始日期 eg：2017-01-01
end_date	否	string	结束日期 eg：2017-01-02
ad_type	否	string	广告类型(0=banner,1=插屏,2=开屏,3=原生,4=激励视频,-2=全部)
device_os	否	string	设备类型(ios/android)
app_id	否	string	应用id，多个用英文逗号分隔。例如：1007253,1007256,1007259
currency	否	string	货币类型(RMB=人民币/USD=美元)
page_num	否	string	每页显示的记录数
page_cur	否	string	页数

请求完整示例:

Note

http://sspcp.adx.yumimobi.com/api/index?token=yourtoken&ad_type=1,2&device_os=android&app_id=1006908,1006909,1006911&currency=RMB&start_date=2017-04-05&end_date=2017-04-12&page_num=10&page_cur=2

返回示例:

{
  "errno": "0",
  "errmsg": "",
  "pageAll": 1,
  "total": {
    "query_count": "1,250,808,382",
    "query_success_count": "604,824,619",
    "display_count": "467,436,181",
    "fill_rate": "77.28%",
    "click_count": "6,511,146",
    "click_rate": "1.39%",
    "consume_amount": "2,961.47",
    "ecpm": "0.01",
    "cpc": "0.00"
  },
  "list": [
    {
      "day": "2017-04-12",
      "app_name": "-",
      "device_os": "-",
      "ad_type": "-",
      "country": "-",
      "query_count": "74,233,755",
      "query_success_count": "33,808,008",
      "display_count": "30,729,782",
      "fill_rate": "45.54%",
      "click_count": "405,734",
      "click_rate": "1.32%",
      "consume_amount": "0.00",
      "ecpm": "-",
      "cpc": "-"
    },
    {
      "day": "2017-04-11",
      "app_name": "-",
      "device_os": "-",
      "ad_type": "-",
      "country": "-",
      "query_count": "144,194,757",
      "query_success_count": "62,437,255",
      "display_count": "53,846,209",
      "fill_rate": "43.30%",
      "click_count": "806,177",
      "click_rate": "1.50%",
      "consume_amount": "0.00",
      "ecpm": "-",
      "cpc": "-"
    }
  ]
}

返回参数说明

参数名	类型	说明
errno	string	错误码，若返回0表示没有错误
errmsg	string	错误信息，若为空表示没有错误
pageAll	string	总页数
total	array	日期区间的汇总数据集合(数组)
list	array	日期区间的单条数据（数组）
day	string	日期
app_name	string	应用名称
device_os	string	设备类型
ad_type	string	广告形式
country	string	国家
query_count	string	请求数
query_success_count	string	请求成功数
display_count	string	展示数
fill_rate	string	填充率
click_count	string	点击数
click_rate	string	点击率
consume_amount	string	收益金额
ecpm	string	ecpm
cpc	string	cpc

错误码说明

错误码	类型	说明
101	string	token未传
102	string	token无效

获取国家信息接口¶

请求url: http://sspcp.adx.yumimobi.com/api/getCountry
请求方式: GET
请求参数:

参数名	必选	类型	说明
key	否	string	某一个国家的编号，例如”AFG” (如果不传，则返回全部国家数据)

返回示例:

{
  "AFG": [
    "Afghanistan",
    "AF",
    "AFG",
    "4",
    "阿富汗"
  ],
  "ALA": [
    "Aland Islands",
    "AX",
    "ALA",
    "248",
    "奥兰群岛"
  ],
  "ALB": [
    "Albania",
    "AL",
    "ALB",
    "8",
    "阿尔巴尼亚"
  ],
  ...
}