跳转至

新建广告计划

新建广告计划

请求地址

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" 
  }
}