【接口文档】酷盈openapi

• 请求地址：https://openapi.toponad.com/v3/report/ssp_adx
• 请求方式：POST
• 接口鉴权：https://help.takuad.com/docs/9NzgWP
• 请求参数说明：

  字段	类型	是否必传	备注	样例
  start_date	Int	Y	开始日期，格式：yyyymmdd	20260602
  end_date	Int	Y	结束日期，格式：yyyymmdd	20260602
  app_id_list	Array[String]	N	开发者后台的应用ID列表	["a600e6fbeac98c"]
  currency	String	Y	开发者账号币种，该字段与revenue字段组成的收益需与开发者后台报表的收益一致	CNY
  placement_id_list	Array[String]	N	开发者后台的广告位ID列表	["b601ce4ca8de81"]
  time_zone	String	Y	时区，枚举值：UTC-8、UTC+8、UTC+0，不传则默认使用开发者账号时区	"UTC+8"
  limit	Int	N	每次拉取数据的最大条数，默认是1000，可选[1,1000]	1000
  start	Int	N	偏移数，代表从第几条数据开始，默认为0	0
  group_by	Array[String]	N	筛选维度列表，支持的维度如下： date（日期，默认值）， app_id（应用ID）， placement_id（广告位ID）

• 请求参数示例：

{
  "start_date": 20260602,
  "end_date": 20260602,
  "currency": "CNY",
  "time_zone": "UTC+8",
  "limit": 100,
  "start": 0,
  "app_id_list": ["a69fbfdfad7d9c"],
  "group_by":["date","app_id","placement_id"]
}

• 响应参数说明：

  字段	类型	是否必传	备注
  records	Array[Object]	N	记录，对象数组每个record结构见下面records元素结构，无数据时为空
  count	Int	N	总条数，无数据时为空

  records数据字段：

  字段	类型	是否必传	备注
  date	String	Y	日期，格式：yyyymmdd。group_by有选才有返回
  app	Object	N	应用信息，group_by有选app_id维度时才返回
  app.id	String	N	开发者后台的应用ID
  app.name	String	N	应用名称
  app.pkg_name	String	N	应用的包名
  app.platform	String	N	应用的系统平台（1-Android，2-iOS）
  placement	Object	N	广告位信息，group_by有选placement_id维度时才返回
  placement.id	String	N	开发者后台的广告位ID
  placement.name	String	N	广告位名称

  指标：

  字段	类型	备注
  bid_request	String	广告请求
  adx_response	String	广告填充
  impression	String	展示
  click	String	点击
  ctr	String	点击率（需乘以100）
  revenue	String	收益，币种为开发者账号币种
  ecpm	String	计算公式：收益/展示）*1000

• 响应结果示例：

{
  "count": 1,
  "records": [
    {
      "adx_response": 7196,
      "app": {
        "id": "a69fbfdfad7d9c",
        "name": "美团",
        "pkg_name": "com.sankuai.meituan",
        "platform": "1"
      },
      "bid_request": 7309,
      "click": 164,
      "ctr": 0.0884,
      "date": 20260602,
      "ecpm": 19.93,
      "impression": 1855,
      "placement": {
        "id": "b69fbff862d327",
        "name": "【视频】开屏-开屏广告-KK"
      },
      "revenue": 36.97
    }
  ]
}