广告位

获取指定媒体的广告位列表

GET /medias/:media_id/placements

参数

campaign_id
可选 integer - 项目 ID
name
可选 string - 广告位名称,支持模糊搜索
page
可选 integer - 显示页码

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

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

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

响应

Status: 200 OK
Link: <http://track.admasterapi.com/medias/100/placements?page=2>; rel="next",
      <http://track.admasterapi.com/medias/100/placements?page=10>; rel="last"
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
[
  {
    //广告位 ID,全局唯一
    "id": 1,
    //广告位所属项目 ID
    "campaign_id": 10000,
    //广告位位置名称
    "name": "测试广告位", 
    //note 轮播属性, `1/1` 固定,`1/2` 二分之一轮播,依次类推
    "rotation" : "1/1",
    //点击目标地址
    "target_url": "http://www.admaster.com.cn/",
    //支付类型 `purchase` 购买,`offering` 配送,`framework` 框架,`compensation` 补偿,`other` 其他
    "payment_type": "purchase",
    //单位收费类型 `day` 天,`week` 周,`month` 月,`cpc`,`cpm`,`cpa`,`article` 文章,`kmail` 千封邮件,`other` 其他
    "cost_type": "day"
    //购买量
    "units": 58,
    //创建时间
    "created_at": "2012-09-06T20:39:23Z",
    //广告位所属频道 ID
    "channel_id": "1000",
    //广告位所属频道名称
    "channel_name": "首页",
    //广告位类型-`webpage` 网页, `video` 视频广告, `client` 客户端, `se` 搜索引擎, `email` 邮件, `other` 其他
    "type": "webpage",
    //广告位在第几屏幕
    "screen": 3,
    //广告位地址
    "page_url": "http://www.admaster.com.cn/",
    //物料类型 `flash`,`image`,`video`, `textlink`, `other` 默认:`flash`
    "material_type": "flash",
    //物料的显示尺寸,单位像素。格式如 400x300 宽度为400px 高度为300px。
    "material_dimension": "400x300",
    //物料文件大小,单位由 material_size_unit 指定
    "material_size": 200,
    //物料文件大小单位,B KB MB。
    "material_size_unit": "KB"
  }
]

获取指定媒体指定广告位的信息

GET /medias/placements/:placement_id

响应

Status: 200 OK
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
{
    //广告位 ID,全局唯一
    "id": 1,
    //广告位所属项目 ID
    "campaign_id": 10000,
    //广告位位置名称
    "name": "测试广告位", 
    //note 轮播属性, `1/1` 固定,`1/2` 二分之一轮播,依次类推
    "rotation" : "1/1",
    //点击目标地址
    "target_url": "http://www.admaster.com.cn/",
    //支付类型 `purchase` 购买,`offering` 配送,`framework` 框架,`compensation` 补偿,`other` 其他
    "payment_type": "purchase",
    //单位收费类型 `day` 天,`week` 周,`month` 月,`cpc`,`cpm`,`cpa`,`article` 文章,`kmail` 千封邮件,`other` 其他
    "cost_type": "day"
    //购买量
    "units": 58,
    //创建时间
    "created_at": "2012-09-06T20:39:23Z",
    //广告位所属频道 ID
    "channel_id": "1000",
    //广告位所属频道名称
    "channel_name": "首页",
    //广告位类型-`webpage` 网页, `video` 视频广告, `client` 客户端, `se` 搜索引擎, `email` 邮件, `other` 其他
    "type": "webpage",
    //广告位在第几屏幕
    "screen": 3,
    //广告位地址
    "page_url": "http://www.admaster.com.cn/",
    //物料类型 `flash`,`image`,`video`, `textlink`, `other` 默认:`flash`
    "material_type": "flash",
    //物料的显示尺寸,单位像素。格式如 400x300 宽度为400px 高度为300px。
    "material_dimension": "400x300",
    //物料文件大小,单位由 material_size_unit 指定
    "material_size": 200,
    //物料文件大小单位,B KB MB。
    "material_size_unit": "KB"    }