广告投放报表

需要携带 Token，详情看 Token

• 本章节将介绍广告投放报表 API。

请求地址

https://ss-api.mintegral.com/api/v1/reports/data

请求方法

GET

请求示例

GET /api/v1/reports/data?start_date=2021-11-01&end_date=2021-11-01
&per_page=50&page=1&utc=+8&dimension=sub_id,location,creative
HTTP/1.1 Host: ss-api.mintegral.com

请求参数

字段	类型	说明	默认值	例子
utc 选填	string	时区	"+8"	"+8"
start_date 选填	string	开始日期不得早于30天。	昨天	YYYY-MM-DD
end_date 选填	string	结束日期和开始日期不得相差超过8天, 并且结束日期需要早于今天。	昨天	YYYY-MM-DD
per_page 选填	int	页面中的数据数量，最大值为5000	5000	30
page 选填	int	页码	—	1
dimension 选填	string	dimension=>"location"，按国家/地区细分广告单元数据。	—	"location"
uuid 选填	string	按照 uuid 查询数据	—	"abc_def_cn_ios_mtg"
campaign_id 选填	int	按照广告 ID 查询数据	—	1234
package_name 选填	string	按照 android bundle id 或者 ios application store id 查询数据。	—	android: "com.tencent.mm" ios: "id414478124"
not_empty_field 选填	string	哪些字段不能为空. 可选的字段名: "click", "install", "impression", "spend".多个字段用,分隔	—	"click,spend"

响应结果

字段	类型	说明
code	int	200 => 表示成功 207 => 表示结束日期和开始日期不得相差超过8天, 并且结束日期需要早于今天。
msg	string	成功，返回"success"，失败返回相应的错误信息
data	array<json>	成功，返回报表数据，失败返回具体的错误信息
page	int	当前页码
per_page	int	要返回的数据数
page_count	int	页数的总和
total_count	int	点击总和
date	date	数据时间
offer_id	int	广告单元 ID
offer_name	string	广告单元名称 ID
uuid	string	系统自动生成的广告单元名称
package_name	string	包名
preview_link	string	预览链接
platform	string	投放平台
click	int	点击总数
install	int	安装总和
geo	array	广告的目标国家
impression	int	展示总和
spend	float	支出总和
utc	string	时区，默认值为 UTC +8
currency	string	货币，默认值为 USD
location	string	广告投放的国家

应答示例

{
  "page": "1",
  "per_page": "50",
  "page_count": "1",
  "total_count": "2",
  "data": [
    {
      "date": "2016-08-25",
      "click": 0,
      "uuid": "uc_xx_gp",
      "install": 0,
      "geo": ["CN"],
      "impression": 0,
      "spend": 0,
      "offer_id": 489844,
      "offer_name": "cqf_testtttt",
      "preview_link": "https://play.google.com/store/apps/details?id=com.UCMobile.intl",
      "platform": "android",
      "package_name": "com.UCMobile.intl",
      "utc": "+8",
      "currency": "USD",
      "location": "hk"
    },
    {
      "click": 3,
      "uuid": "uc_xx_gp2",
      "install": 0,
      "geo": ["CN", "US"],
      "impression": 0,
      "spend": 0,
      "offer_id": 885,
      "offer_name": "uc_android_test",
      "preview_link": "https://play.google.com/store/apps/details?id=com.UCMobile.intl",
      "platform": "android",
      "package_name": "com.UCMobile.intl",
      "utc": "+8",
      "currency": "USD",
      "location": "hk"
    }
  ]
}