广告代理

TrackMaster™ 所有 API 的访问都是通过 HTTP 执行的,所有被发送和接收的数据都是 JSON。请在开发前先阅读 快速入门OAuth 认证协议及请求方式接口定义-通用说明

TrackMaster™ 使用 OAuth2.0 对用户进行验证,保障用户的隐私和安全性。在您阅读本文进行开发时,您应当已经取得了您的帐号。如果没有,请至 AdMaster 官网 申请帐号。

当您已经拥有 TrackMaster 账号并且刚开始准备进行 API 访问,请先至 申请应用 申请获取 ClientID 与 Client Secret Key。

TrackMaster API 结构与业务逻辑一致,请访问 帮助中心 获取相关业务知识,您也可以从 概述 简单了解。

开发示例

第一步 获取访问令牌

POST http://open.admaster.com.cn/oauth/access_token

参数

{
  "client_id": "***",
  "client_secret": "***",
  "grant_type": "password",
  "email": "yourmailaddress@email.com",
  "password": "***"
}

响应

{
  "access_token": "7a68b4d65ddd6a6191ef0cbf9cadb06528d92d67",
  "expires_in": "18000",
  "refresh_token": "23a89c9944afc0525a25d15d180c6bce03efa331"
}

access_tokenexpires_in秒内有效,超期后请重新访问该接口获取新的访问令牌,携带参数:

{
  "client_id": "***",
  "client_secret": "***",
  "grant_type": "refresh_token",
  "refresh_token": "***"
}

第二步 获取当前授权用户有权操作的所有工作网络

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

响应

其中 networks key 下为当前用户有权操作的所有工作网络

{
    "id": 1, 
    "name": "xxx", 
    "role": "user", 
    "email": "xxx@admaster.com.cn", 
    ... 
    "networks": {
        "11": {
            "id": 72, 
            "networkId": 11, 
            "userId": 1, 
            "roleId": 11, 
            "expiredAt": "2020-11-18T00:00:00.000Z", 
            "status": "enabled", 
            "isOwnAllCampaign": "no", 
            "isDelete": "no", 
            "createdAt": "2014-11-18T08:31:29.000Z", 
            "updatedAt": "2014-12-18T08:52:16.000Z", 
            "network": {
                ...
                "id": 11, 
                "name": "AdMaster", 
                "creator": "xxx@admaster.com.cn", 
                "status": "enabled", 
                "campaigns": 168, 
                "campaignLimit": 10000, 
                "users": 88, 
                "userLimit": 100, 
                "expiredAt": "2020-11-29T00:00:00.000Z", 
                "isDelete": "no", 
                "createdAt": "2014-10-29T02:23:25.000Z", 
                "updatedAt": "2015-03-05T09:02:45.000Z"
            }, 
            ...
        }, 
        "70": {
            "id": 0, 
            "networkId": 70, 
            "network": {
                ...
                "id": 70, 
                "name": "Name xxx", 
                "creator": "xxx@admaster.com.cn", 
                "status": "enabled", 
                "campaigns": 0, 
                "campaignLimit": 5000, 
                "users": 6, 
                "userLimit": 200, 
                "expiredAt": "2025-01-01T00:00:00.000Z", 
                "isDelete": "no", 
                "createdAt": "2014-08-01T10:15:31.000Z", 
                "updatedAt": "2015-02-26T04:06:02.000Z"
            }
        }
    }
}

第三步 获取指定工作网络下有操作权限的项目列表

GET http://m.trackmaster.com.cn/api_v2/networks/:networkId/campaigns

注意,每次请求需将 access_token 携带在 queryString 中以验证权限。

响应

[{
"id": 999,
"name": "这个是项目名称",
"advertiserId": 999, // 关联广告主id
"brandId": 999, // 关联品牌id
"networkId": 999, // 关联工作网络id
"trackType": 'mobile','nonmobile', //track类型,移动,非移动,二选一
"startDate": 2014-06-25, // 项目开始日期
"endDate": 2014-06-25, //项目结束日期
"mediaIds":440,1118,40 // 项目下媒体的列表,多个用逗号隔开, 有顺序
"status": enabled或者disabled, //默认值为enabled
"costType": 'cny','usd','none', //媒介计划预算结算货币,none为不录入
"siteMasterId": 999, //项目关联siteMaster 站点id,多个用逗号隔开
"defaultTarget": "www.ui168.com", //项目默认点击跳转地址
"isDelete":  yes或者no, //是否被删除,
"party_name":zhaoxiongfei, //项目甲方联系人名称
"party_email"://项目甲方联系人邮箱
"placements":999, //项目下目前广告位总数, 每个项目下广告位总数有限制
}]

其它信息

概述
协议及请求说明