批量更新推广计划
根据计划id批量更新相应的推广计划
HTTP请求方式
POST
请求地址
https://api.e.360.cn/dianjing/campaign/batchUpdate
字段 |
类型 |
必须 |
描述 |
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":[
]
}