媒体报告

注意:2015 年新接入的媒体 API 地址请使用以下地址

http://m.trackmaster.com.cn/api_v2/

获取指定媒体下的项目

GET /medias/:media_id/campaigns

响应

Status: 200 OK
  {
    "id": 10185,
    "name": "测试项目",
    "start_date": "2012-01-03",
    "end_date": "2012-06-23",
    "created_at": "2012-09-06T20:39:23Z"
  }

获取指定项目下的日报告

GET /medias/:media_id/campaigns/:campaign_id/daily_reports

参数

start_time
可选 date - 报告开始日期,例如 2012-08-01
end_time
可选 date - 报告结束日期,例如 2012-08-02
sort
可选 string - 列表排序以什么排序
  • time - 按照时间排序
  • imp - 按照曝光排序
  • clk - 按照点击排序
  • uimp - 按照独立曝光排序
  • uclk - 按照独立点击排序
direction
可选 string - 排序方式
  • asc 升序 (默认)
  • desc 降序

响应

Status: 200 OK
  {
    "time": "2012-08-01", // 时间
    "imp": 23, //曝光
    "uimp": 20, //独立曝光
    "clk": 20, //点击
    "uclk": 10, //独立点击
  }

获取指定监测代码下的项目日报告

GET /medias/campaigns/daily_reports/codes

参数

code
必选 string - 项目监测代码

响应

Status: 204 No Content
Location: http://track.admasterapi.com/medias/1308/campaigns/10256/daily_reports
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999

获取指定监测代码下的项目报告

GET /medias/campaigns/reports/codes

参数

code
必选 string - 项目监测代码

响应

Status: 204 No Content
Location: http://track.admasterapi.com/medias/1308/campaigns/10256/reports
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999

获取IES报告(新接口)

GET /medias/:id/ies_reports

响应

Status: 200 OK
Link: <http://track.admasterapi.com/medias/1/ies_reports?page=2>; rel="next",
  	  <http://track.admasterapi.com/medias/1/ies_reports?page=10>; rel="last"

参数

pub_id
可选 string - pub_id 指定后只获取该 pub_id 的数据
date
可选 date - 日期,要查看的数据日期,YYYY-mm-dd 例如: 2012-06-08, 不指定则获取前一天的数据
page
可选 integer - 显示页码

默认显示页码为 ‘1’,起始页为 ‘1’ 而不是 ‘0’。pageper_page一起使用,例如当返回的数据超过 30 条时,可以通过设定 page 显示 30 条之后的数据。

per_page
可选 integer - 分页数量,默认每页 30 条

返回数据的数目。当不指定per_page 时,默认最大返回 30 条数据。per_pagepage 一起使用显示一系列数据或者单独使用限制

[{
  	"id": 30,
  	"media_id":100,
  	"geo_id": 1100000000,  		
  	"pub_id": "PUB_IMloxn12345",
  	"imp": 12039423,
  	"clk": 43432
}]

获取指定监测代码下的相关参数

GET /medias/:id/code_params

参数

code
必选 string - 监测代码
{
  	"campaign_id": "100",
  	"placement_id":"100",
  	"creative_id":"0"
}

获取指定媒体项目报告列表

GET /medias/:media_id/campaigns/:campaign_id/reports

参数

time
可选 string - 数据时间类型,与参数 start_timeend_time 共同使用。
  • hourly 获取小时数据
  • daily 获取日数据——默认
dims
可选 string - 数据聚合维度,多个选项之间用,分开
  • time 按时间维度聚合、结果会显示具体的时间列
  • placement 按广告位维度聚合
  • keyword 按关键字维度聚合
  • creative 按创意维度聚合
  • province 按省级地域维度聚合
placement_id
可选 integer - 广告位 ID
keyword_id
可选 integer - 关键字 ID
creative_id
可选 integer - 创意 ID
geo_id
可选 integer - 地域 ID
start_time
可选 hour - 报告开始时间,与参数time一起使用。
采用国际标准 ISO 8601 的日期和时间显示格式。
  • 当参数 time 选择 小时,时间格式 YYYY-MM-DDThh:mm:ss+08:00。例 2012-11-06T01:00:00+08:00。仅支持北京时间的时区表示,输出格式同样为 YYYY-MM-DDThh:mm:ss+08:00。

  • 当参数 time 选择 ,时间格式 YYYY-MM-DD。例 2012-11-06。

end_time
可选 hour - 报告结束时间,与参数time一起使用。
采用国际标准 ISO 8601 的日期和时间显示格式。
  • 当参数 time 选择 小时,时间格式 YYYY-MM-DDThh:mm:ss+08:00。例 2012-11-06T01:00:00+08:00。仅支持北京时间的时区表示,输出格式同样为 YYYY-MM-DDThh:mm:ss+08:00。

  • 当参数 time 选择 ,时间格式 YYYY-MM-DD。例 2012-11-06。

sort
可选 string - 列表排序以什么排序
  • time - 按照时间排序
  • imp - 按照曝光排序
  • clk - 按照点击排序
  • uimp - 按照独立曝光排序
  • uclk - 按照独立点击排序
  • placement_id - 按照广告位 ID 排序
direction
可选 string - 排序方式
  • asc 升序 (默认)
  • desc 降序
page
可选 integer - 显示页码

默认显示页码为 ‘1’,起始页为 ‘1’ 而不是 ‘0’。pageper_page一起使用,例如当返回的数据超过 30 条时,可以通过设定 page显示 30 条之后的数据。

per_page
可选 integer - 分页数量,默认每页 30 条

per_pagepage 一起使用显示一系列数据或者单独使用限制返回数据的数目。当不指定per_page 时,默认最大返回 30 条数据。

响应

Status: 200 OK
Link: <http://track.admasterapi.com/medias/1/campaigns/12/reports?page=2>; rel="next",
      <http://track.admasterapi.com/medias/1/campaigns/12/reports?page=10>; rel="last"
[
  {
    "campaign_id": 10185,
    "time": "2012-08-03",
    "imp": 9,
    "uimp": 6,
    "clk": 3,
    "uclk": 3,
  }
]

字段说明

返回值字段 字段类型 字段说明
imp integer 曝光
uimp integer 独立曝光
clk integer 点击
uclk integer 独立点击

获取数据组合说明

不是所有的属性都可以搭配获取数据,只有特定的组合才可以获取到相应数据。当选择了 dims=time 时,显示内容按时间分组聚合。

组合 说明
time=daily 粒度为天,指定媒体指定项目数据
time=daily&dims=province 粒度为天,指定媒体指定项目分省级地域数据
time=daily&dims=creative 粒度为天,指定媒体指定项目分创意数据
time=daily&dims=placement 粒度为天,指定媒体指定项目分广告位数据
time=daily&dims=placement,province 粒度为天,指定媒体指定项目分广告位分省级地域数据
time=daily&dims=placement,keyword 粒度为天,指定媒体指定项目分广告位分关键字数据
time=daily&dims=placement,creative 粒度为天,指定媒体指定项目分广告位分创意数据
time=hourly 粒度为小时,指定媒体指定项目数据
time=hourly&dims=creative 粒度为小时,指定媒体指定项目分创意数据
time=hourly&dims=province 粒度为小时,指定媒体指定项目分省级地域数据
time=hourly&dims=placement 粒度为小时,指定媒体指定项目分广告位数据
time=hourly&dims=placement,creative 粒度为小时,指定媒体指定项目分广告位分创意数据
time=hourly&dims=placement,province 粒度为小时,指定媒体指定项目分广告位分省级地域数据

示例

维度参数包括 time,显示内容按时间分组聚合。

[
    {
        "campaign_id": 10116,
        "time": "2012-11-01",
        "imp": 3,
        "uimp": 3,
        "clk": 7,
        "uclk": 7,
    },
    {
        "campaign_id": 10116,
        "time": "2012-11-02",
    …
]

维度参数不选择 time

[
    {
        "campaign_id": 10116,
        "imp": 28,
        "uimp": 27,
        "clk": 72,
        "uclk": 39,
    }
]