媒体报告

获取指定媒体下的项目

GET http://m.trackmaster.com.cn/api_v2/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 http://m.trackmaster.com.cn/api_v2/medias/:media_id/campaigns/:campaign_id/reports/basics

参数

报告结果的返回头部信息 X-Content-Record-Total 值为结果条目总数,如果需要控制翻页,请修改startIndexmaxResults 的值。

响应

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

获取IES报告

GET /medias/:mediaId/reports/ies

参数

pubId
可选 string - pubId 指定后只获取该 pubId 的数据
date
可选 date - 日期,要查看的数据日期,YYYY-mm-dd 例如: 2012-06-08, 不指定则获取前一天的数据
startIndex
可选 integer - 数据从第几条开始,默认为 0
maxResults
可选 integer - 最多返回多少条结果,默认为 30,最大为 5000
[{
  	"id": 30,
  	"mediaId":100,
  	"geoId": 1100000000,  		
  	"pubId": "PUB_IMloxn12345",
  	"imp": 12039423,
  	"clk": 43432
}]

字段说明

返回值字段 字段类型 字段说明
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,
    }
]