华为广告推广投放
计划
创建计划
通过此接口可以创建计划
请求地址 https://ads.cloud.huawei.com/openapi/v2/promotion/campaign/create
请求方法 POST
请求参数
参数名称 | 类型 | 是否必选 | 描述 |
campaign_name | string | 是 | 计划名称满足正则 regexp = "^[^^|]+$" 最大长度不得超过 50.计划名称不得重复 |
product_type | string | 是 | 推广产品 详见【推广产品】 |
daily_budget | integer | 是 | 日限额 当日限额与次日限额都 为此值 整数位数长度不得超 9 位 日限额不得低于最小日限额 现网最小日限额为 500 现阶段最小日限额为 30 |
请求示例
=================================================================== =======================================POST
/openapi/v2/promotion/campaign/create HTTP/1. 1
Accept:application/json
Content-Type:application/json
Authorization:Bearer CgB6e3x9ERGComr9dENxZX22iBk+mLuf1yGtQVPUjPJUMrstfKlqpdXk+kfHU9J8ZJ/soY IZHZzT446GeSYumluQuhsK7jvz4kz1Bkms4CLI/rE=
{
"campaign_name":"信息流小图计划 0510",
"product_type":"WEB",
"daily_budget":500
}
=================================================================== =======================================
响应字段
参数名称 | 类型 | 是否必选 | 描述 |
code | string | 是 | 返回码, 200 成功,其他失败 |
message | string | 否 | 返回描述 |
data | Struct1 | 否 | 计划 ID |
data(Struct1)定义
参数名称 | 类型 | 是否必选 | 描述 |
campaign_id | string | 是 | 计划 ID |
应答示例
=================================================================== =======================================HTTPS/1. 1 200 OK
{
"code": 200,
"data": {
"campaign_id": "35003379"
}
}
=================================================================== =======================================
2、查询计划
通过此接口可以查询计划
请求地址
https://ads.cloud.huawei.com/openapi/v2/promotion/campaign/query
请求方法
GET
请求参数
参数名称 | 类型 | 是否必选 | 描述 |
page_num | integer | 是 | 搜索页码 取值范围 1~10000 |
page_size | integer | 是 | 一页展示数量 取值范围 10~50 |
以下为过滤字段 | |||
campaign_name | string | 否 | 计划名称, 最大长度不得超过 50. 满足正则 regexp = "^[^^|]+$" |
campaign_ids | string[] | 否 | 推广计划 ID 列表,最多 100 个 |
updated_begin_time | string | 否 | 计划更新的开始时间,格 式:"yyyy-MM-dd HH:mm:ss" |
updated_end_time | string | 否 | 计划更新的结束时间,格 式:"yyyy-MM-dd HH:mm:ss" |
请求示例
GET
/openapi/v2/promotion/campaign/query?page_num=1&page_size=11&campaign_ids=350064 41 HTTP/1. 1
Accept:application/json
Content-Type:application/json
Authorization:Bearer CgB6e3x9ERGComr9dENxZX22iBk+mLuf1yGtQVPUjPJUMrstfKlqpdXk+kfHU9J8ZJ/soY IZHZzT446GeSYumluQuhsK7jvz4kz1Bkms4CLI/rE=
响应字段
参数名称 | 类型 | 是否必选 | 描述 |
code | string | 是 | 返回码 |
message | string | 否 | 返回描述 |
data | Struct1 | 否 | 计划列表 |
data(Struct1)定义
参数名称 | 类型 | 是否必选 | 描述 |
total | integer | 是 | 总条数 |
data | Struct2[] | 否 | 计划列表 |
data(Struct2)定义
参数名称 | 类型 | 是否必选 | 描述 |
campaign_name | string | 是 | 计划名称 |
campaign_id | string | 是 | 计划 ID |
campaign_status | string | 是 | 操作状态 详见【计划/任务/创意操作状 态】 |
campaign_daily_budget_ status | string | 是 | 计划日限额状态 详见【计划日限额状态】 |
user_balance_status | string | 是 | 账户余额状态 详见【账户余额状态】 |
product_type | string | 是 | 推广产品 计划的 product_type 与关联推广产品的 product_type 需要保持一致 详见【推广产品】 |
tomorrow_daily_budget | integer | 否 | 次日计划日限额,不返回表示与 当日计划日限额相同 详见【日限额说明】 |
today_daily_budget | integer | 是 | 当日计划日限额 详见【日限额说明】 |
应答示例
=================================================================== ======================================
HTTPS/1. 1 200 OK
{
"code": "200",
"data": {
"total": 1210,
"data": [{
"campaign_name": "美丽传说营销节",
"product_type": "ANDROID_APP",
"user_balance_status": "ADVERTISER_BALANCE_NOT_EXCEED", "campaign_status": "OPERATION_STATUS_ENABLE", "campaign_daily_budget_status": "CAMPAIGN_DAILY_BUDGET_NOT_EXCEED", "show_status": "CAMPAIGN_STATUS_DELIVERY_OK",
"campaign_id": "35002310",
"today_daily_budget": "40"
},
{
"campaign_name": "憧憬人生",
"product_type": "ANDROID_APP",
"user_balance_status": "ADVERTISER_BALANCE_NOT_EXCEED", "campaign_status": "OPERATION_STATUS_ENABLE", "campaign_daily_budget_status": "CAMPAIGN_DAILY_BUDGET_NOT_EXCEED",
"campaign_id": "35002309",
"today_daily_budget": "200"
}]
}
}
=================================================================== ======================================
3、编辑计划状态
通过此接口可以编辑计划状态
请求地址
https://ads.cloud.huawei.com/openapi/v2/promotion/campaign/status/update
请求方法
POST
请求参数
参数名称 | 类型 | 是否必选 | 描述 |
campaign_id | string | 是 | 计划 ID 长度为 1 到 50 满足正则^[A-Za-z0-9]*$ |
op_type | string | 是 | 操作类型 当操作类型为开始或者暂停时: 竞价只支持未删除 当操作类型为删除时: 计划状态不能为已删除, 90 天 无数据,则计划将被删除。有数 据无法被删除。 原状态为删除,不可更新 启动操作需要保证计划原状态是 暂停状态 详见【操作类型】 |
请求示例
=================================================================== ======================================
POST openapi/v2/promotion/campaign/status/update HTTP/1. 1
Accept:application/json
Content-Type:application/json
Authorization:Bearer CgB6e3x9ERGComr9dENxZX22iBk+mLuf1yGtQVPUjPJUMrstfKlqpdXk+kfHU9J8ZJ/soY IZHZzT446GeSYumluQuhsK7jvz4kz1Bkms4CLI/rE=
{
"campaign_id":"10",
"op_type":"OPERATION_ENABLE"
}
=================================================================== ======================================
响应字段
参数名称 | 类型 | 是否必选 | 描述 |
code | string | 是 | 返回码 |
message | string | 否 | 返回描述 |
应答示例
=================================================================== ======================================
HTTPS/1. 1
{
"code":200
}
=================================================================== ======================================
- 2024-10-12
金投赏鲸鸿动能专场,华为广告全场景释放数… - 2024-09-23
华为广告大卡智投支持oCPD,强势助力品效合… - 2024-09-23
冲量黄金周—华为广告鲸鸿动能国庆投放指南… - 2024-09-12
如何1分钟玩转华为广告AI大模型微调推理?… - 2024-09-07
共创价值·赋能增长:携手影娱/资讯/教育行… - 2024-08-22
2024 CDEC高峰论坛:鸿蒙生态技术赋能 构筑… - 2024-08-20
华为广告携手某炒股软件,首次解锁「智慧多… - 2024-08-17
华为广告开户流程和广告计费、展示、形式有… - 2024-08-13
鲸鸿动能五大行业解决方案发布,以生态力量… - 2024-04-11
华为广告 | “低代码开发实践分享:共创未…
管理员
该内容暂无评论