批量更新推广计划


根据计划id批量更新相应的推广计划

HTTP请求方式

POST

请求地址

https://api.e.360.cn/dianjing/campaign/batchUpdate

Headers请求参数
字段 类型 必须 描述
apiKey String Yes 注册时分配到的api key,该参数作为HTTP HEAD字段传递。
accessToken String Yes 身份认证通过后平台分配的临时token,作为操作对应广告账户的凭证,10小时有效。参数获取方式见接口clientLogin。
Body请求参数
字段 类型 必须 描述
campaigns string Yes json格式的推广计划数组,最多支持数量不得超过该账户星级对应的数量限制,详见系统限制
campaigns示例
[{
    "id": "123456",
    "name": "推广计划1",
    "budget": "1000",
    "region": "[0]",
    "searchIntention": "close",
    "schedule": "[{\"week\":1,\"hour\":[1,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}]",
    "startDate": "2016-06-01",
    "endDate": "2016-06-30",
    "negativeWords": "{\"phrase\":[\"否定词1\"],\"exact\":[\"精确否定词1\",\"精确否定词2\"]}", //会完全替换原有的否词和精确否词
    "mobilePriceRate": "90",
    "status": "pause",
    "hasServiceRatio":"1",
    "planServiceRatio":"[[1,0,1],[1,1,1]]",
    "mobilehq_switch":1,
    "mobilehq_premium":10.0
}]
campaigns字段说明
字段 类型 必须 描述
id string yes 推广计划id
name string no 推广计划名称
budget int no 推广计划每日预算,默认为0,表示不限制
region string no 投放地域,json格式的地域id数组,默认为[0],代表全地域投放
searchIntention string no 搜索意图定位, open代表打开,close代表关闭,默认为close
schedule string no json格式,Week字段1-7 表示周一至周日,若其中一星期某天不投放,可跳过,hour 总数为24 其中0为此时段不投放,1为投放。例:[{“week”:1,”hour”:[1,1,1,1,1,1,1,1,1,1……]},{“week”:3,”hour”: [1,0,1,1,1,0,1,1,1,1……]}……]每周二不投放。
startDate date no 推广计划开始日期,默认为添加之日开始
endDate date no 推广计划结束日期,默认永久有效
negativeWords string no 匹配方式为短语匹配或者精确匹配的否定关键词(否词和精否词数量不得超过该账户星级对应的数量限制,详见系统限制),使用JSON格式:其中phrase代表短语exact代表精确{"phrase":["短语匹配1"],"exact":["精确1","精确2"]},并会完全替换原有的否词和精确否词
mobilePriceRate int no 移动出价比例, mobilePriceRate 只能是10的整数倍, 出价比例区间为20-990,若不填, 默认为100, 即移动端出价与PC 端出价一样. 若该值为300, 则表示移动端出价为PC 端出价的300%. 关键词的移动出价低于0.3 时,系统使用0.3进行竞价
status string no 启用/暂停状态,enable-启用,pause-暂停,默认启用
hasServiceRatio int no 分时段出价开关,0关闭(直接忽略planServiceRatio内容,清空现有系数),1开启(使用提交过来的时段系数),无值则依据现有投放时段进行删除或无操作,当为1时,schedule和planServiceRatio参数为必填项
planServiceRatio Json no 投放时段系数 demo: [[1,10,0.1],[1,11,0.5]],格式说明[[week,hour,ratio]],范围ratio∈[0.1,10.0],当hasServiceRatio为1时,为必填项。并且week与hour需要与schedule相对应,例如schedule为[{"week":1,"hour":[1,0,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0]}],planServiceRatio对应为[[1,0,1],[1,2,1]]
mobilehq_switch int no 移动优质流量时段投放开关,0-关闭,1-开启
mobilehq_premium double no 移动优质流量溢价系数(支持一位小数),范围:1.0~10.0
请求示例
curl -X POST \ 
--header 'apiKey:APIKEY' \ 
--header 'accessToken:ACCESSTOKEN' \ 
--data 'campaigns=[{"id": 3924245063,"name": "客户端上来的","budget": "260","region": "[0]","schedule": "[{\"week\": 1,\"hour\": [0,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]},{\"week\": 2,\"hour\": [1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]},{\"week\": 3,\"hour\": [1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]},{\"week\": 4,\"hour\": [1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]},{\"week\": 5,\"hour\": [1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]},{\"week\": 6,\"hour\": [1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]},{\"week\": 7,\"hour\": [1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]}]","device": "0","status": "enable", "negativeWords": "{\"phrase\":[\"否定词1\"],\"exact\":[\"精确否定词1\",\"精确否定词2\"]}","mobilePriceRate": "90","mobilehq_switch":1,"mobilehq_premium":1.8}]' \ 
'https://api.e.360.cn/dianjing/campaign/batchUpdate'
返回结果
{
    "affectedRecords":[3924245063],
    "failures":[

    ]
}

results matching ""

    No results matching ""