新建广告计划
新建广告计划
请求地址
https://openapi.aiclk.com/openapi/v1/campaign/create
所属权限
ads_write
请求方式
POST
Header: Content-Type: application/json
请求参数
请求Url中添加参数:
| 字段名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| account_id | int | 是 | 广告主ID(广告投放平台的userID) |
Post-Body添加参数:
| 字段名 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| campaign_name | string | 是 | 计划名称 |
| start_date | string | 是 | 投放开始时间,格式:yyyy-mm-dd |
| end_date | string | 是 | 投放结束时间,格式:yyyy-mm-dd |
| configure_status | string | 否 | 计划状态,默认开启 允许值:开启- ENABLE, 暂停-PAUSED |
| optimization_goal | string | 是 | 推广目标,枚举值 |
| app_marketing_type | string | 否 | 营销目标,账户一级行业为应用下载时必填 拉新-ACQUISITION,拉活-ACTIVATION |
| budget | int | 是 | 投放预算,单位:分,范围:100元-5000000元 |
| tomorrow_budget | int | 否 | 明日预算 单位:分,范围:100元-5000000元 不填默认为0,表示关闭 |
Body示例
{
"campaign_name" : "test_campaign",
"start_date" : "2020-01-02",
"end_date" : "2020-01-02",
"budget" : 50002
}
请求示例
curl -X POST \
'https://openapi.aiclk.com/openapi/v1/campaign/create?account_id=1000009' \
-H 'Content-Type: application/json' \
-H 'OGW_ACCESS_TOKEN: your_access_token' \
-d '{"campaign_name":"test_campaign","start_date":"2020-01-02","end_date":"2020-01-02","budget":50002}'
返回字段释义
| 字段名 | 类型 | 描述 |
|---|---|---|
| code | int | 返回码 |
| message | string | 返回信息 |
| data | json | 返回值,json格式,包含如下字段 |
| - campaign_id | int | 广告计划ID |
| - campaign_name | string | 计划名称 |
返回示例
{
"code": 200,
"message": "success",
"data": {
"campaign_id":23847161, // 计划id
"campaign_name": "test_campaign"
}
}