添加推广计划
添加推广计划
HTTP请求方式
POST
请求地址
https://ms-api.e.360.cn/v1/plan/add
| 字段 |
类型 |
必须 |
描述 |
| Content-Type |
string |
yes |
application/x-www-form-urlencoded |
| apiKey |
string |
yes |
注册时分配到的api key，该参数作为HTTP HEAD字段传递。 |
| accessToken |
string |
yes |
访问token |
Body 请求参数
| 字段 |
类型 |
必须 |
描述 |
| campaign |
string |
yes |
json格式，添加推广计划需要的字段。 |
campaign示例
{
"name": "这是openapi添加的一个计划",
"budget": 0,
"ad_type": 0,
"schedule": "[{\"week\":1,\"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]}]",
"equal_budget_flag": 1,
"os": 1,
"start_date": "2020-09-25",
"end_date": "2020-09-28",
"app_id": 1,
"app_type":1
}
字段说明
| 字段 |
类型 |
必须 |
描述 |
| name |
string |
Yes |
推广计划名称，最多可输入40个汉字或80个字符 |
| os |
int |
Yes |
操作系统，1：Android；2：IOS |
| start_date |
string |
Yes |
投放时间,开始时间,格式:xxxx-xx-xx |
| end_date |
string |
No |
投放时间，结束时间，不传则结束时间为永久,格式:xxxx-xx-xx |
| budget |
int |
No |
每日预算，单位是(元)；0是不限，默认为不限；如果传大于0的数则预算设置为对应的值，需要大于等于30并且是10的倍数 |
| ad_type |
int |
No |
推广目的，0：应用激活；1：应用下载；2：移动网站推广；默认值是0应用激活 |
| 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”:2,”hour”: [1,0,1,1,1,0,1,1,1,1……]}……] |
| equal_budget_flag |
int |
No |
预算消耗方式：0：匀速；1：快速；默认值是0匀速 |
| app_id |
int |
No |
推广APP，当ad_type=0和ad_type=1并且os=1时，该字段必传 |
| app_type |
int |
No |
APP类型，1手助app、2官网app、3渠道app；当ad_type=0和ad_type=1并且os=1时，该字段必传 |
请求示例
curl -X POST \
--header 'apiKey:APIKEY' \
--header 'accessToken:ACCESSTOKEN' \
--data 'campaign={"name":"这是一个计划","budget":0,"ad_type":0,"schedule":"[{\"week\":1,\"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]}]","equal_budget_flag":1,"os":1,"start_date":"2021-04-07","end_date":"2021-04-28","app_id":473,"app_type":3}' \
'https://ms-api.e.360.cn/v1/plan/add'
返回结果
{
"err_no": 10000,
"err_msg": "",
"data": 123456
}
返回结果说明
| 字段 |
类型 |
描述 |
| err_no |
int |
错误码，详见 错误码对照 |
| err_msg |
string |
错误描述 |
| data |
int |
成功时返回创建的计划id，失败时返回0 |