华为广告推广计划编辑任务期望出价(oCPC)
通过此接口可以编辑任务期望出价, 需要向运营申请 oCPC 版位和转化指标权限
请求地址
https://ads.cloud.huawei.com/openapi/v2/promotion/adgroup/conversion_cost/update
请求方法
POST
请求参数
参数名称 | 类型 | 是否必选 | 描述 |
adgroup_id | long | 是 | 任务 ID |
conversion_cost | float | 是 | 期望转化成本, price_type 为 PRICING_OCPC 时专用, 暂时 |
只支持 APP 和网页。 整数位不得超过 9 位,小数位不 得超 2 位 |
请求示例
=================================================================== =======================================POST
openapi/v2/promotion/adgroup/conversion_cost/update HTTP/1. 1
Accept:application/json
Content-Type:application/json
Authorization:Bearer CgB6e3x9ERGComr9dENxZX22iBk+mLuf1yGtQVPUjPJUMrstfKlqpdXk+kfHU9J8ZJ/soY IZHZzT446GeSYumluQuhsK7jvz4kz1Bkms4CLI/rE=
{
"adgroupId":"4000026",
"conversionCost":"113.00"
}
===================================================================
=======================================
响应字段
参数名称 | 类型 | 是否必选 | 描述 |
code | string | 是 | 返回码 |
message | string | 否 | 返回描述 |
应答示例
=================================================================== =======================================HTTPS/1. 1 200 OK
{
"code":"200"
}
=================================================================== =======================================
查询应用详情
通过此接口可以查询应用详情。新建任务时,可以通过此接口查询应用详情在界面展 示给用户。
请求地址
https://ads.cloud.huawei.com/openapi/v2/promotion/adgroup/app_detail/query
请求方法
GET
请求参数
参数名称 | 类型 | 是否必选 | 描述 |
store_app_id | string | 是 | 华为应用市场的 APP ID |
请求示例
=================================================================== =======================================GET
openapi/v2/promotion/adgroup/app_detail/query?store_app_id=C3000075007 HTTP/1. 1
Accept:application/json
Content-Type:application/json
Authorization:Bearer CgB6e3x9ERGComr9dENxZX22iBk+mLuf1yGtQVPUjPJUMrstfKlqpdXk+kfHU9J8ZJ/soY IZHZzT446GeSYumluQuhsK7jvz4kz1Bkms4CLI/rE=
=================================================================== =======================================
响应字段
参数名称 | 类型 | 是否必选 | 描述 |
code | string | 是 | 返回码 |
message | string | 否 | 返回描述 |
data | Struct1 | 否 | 应用详情 |
Struct1 定义
参数名称 | 类型 | 是否必选 | 描述 |
store_app_id | string | 是 | 华为应用市场 APP ID |
package_name | string | 是 | 包名 |
product_name | string | 是 | 应用名称 |
icon_url | string | 是 | 应用图标 |
description | string | 是 | 描述/介绍 |
应答示例
=================================================================== ======================================
HTTPS/1. 1 200 OK
{
"code": "200",
"data": {
"icon_url": "https://appimg.dbankcdn.com/hwmarket/files/application/icon144/fc5e43d094, "package_name": "com.zjxnkj.countrysidecommunity",
"description": "村支书便民服务平台",
"store_app_id": "C100643361",
"package_name": "村支书",
"devunion_app_id": "300075007"
}
}
=================================================================== ======================================
查询定向字典
通过此接口可以查询定向字典
请求地址
https://ads.cloud.huawei.com/openapi/v2/promotion/adgroup/targeting_rule/query
请求方法
GET
请求参数
参数名称 | 类型 | 是否必选 | 描述 |
targeting_list | string[] | 是 | 用户查询哪些定向模板集合 详见【定向模板集合】 |
请求示例
=================================================================== ======================================
GET
openapi/v2/promotion/adgroup/targeting_rule/query?targeting_list=gender&targeting_lis=age HTTP/1. 1
Accept:application/json
Content-Type:application/json
Authorization:Bearer CgB6e3x9ERGComr9dENxZX22iBk+mLuf1yGtQVPUjPJUMrstfKlqpdXk+kfHU9J8ZJ/soY IZHZzT446GeSYumluQuhsK7jvz4kz1Bkms4CLI/rE=
=================================================================== ======================================
响应字段
参数名称 | 类型 | 是否必选 | 描述 |
code | string | 是 | 返回码 |
message | string | 否 | 返回描述 |
data | Struct1 | 否 | 定向字典列表 |
Struct1 定义
参数名称 | 类型 | 是否必选 | 描述 |
tree_targeting_map | Map<strin g, List<Struct 2> | 否 | 树状结构定向数据 Map 中的 Key 为: region_geo 、region_level、 app_category 、series_type |
linear_targeting_map | Map<strin g, List<Struct 3> | 否 | 线状结构定向数据 Map 中的 Key 为: dmpGender 、dmpAge 、gender、 age 、device_price 、 network_type 、 pre_define_audience 、 not_pre_define_audience |
Struct2 定义
参数名称 | 类型 | 是否必选 | 描述 |
id | string | 是 | 元素 ID |
pId | string | 否 | 父节点元素 ID |
label | string | 是 | 显示的内容 |
value | string | 是 | 元素的值 |
code | string | 否 | 地域定向 region_geo 、 region_level 有返回值。定向选 择当前在这里的人, 提交时使用 code 替代 value |
Struct3 定义
参数名称 | 类型 | 是否必选 | 描述 |
id | string | 是 | 元素 ID |
label | string | 是 | 显示的内容 |
value | string | 是 | 元素的值 |
additional | string | 否 | pre_define_audience 、 not_pre_define_audience 定向存 在,内容为“公共”、“专 属”、“私有”,展示时使用 |
应答示例
=================================================================== ======================================
HTTPS/1. 1 200 OK
{
"code": "200",
"data": {
"linear_targeting_map": {
"gender": [{
"label": "男",
"value": "g_m"
},
{
"label": "女",
"value": "g_f"
}],
"age":[{
"label": "18 岁以下",
"value": "1"
},
{
"label": "18~23 岁",
"value": "2"
},
{
"label": "24~34 岁",
"value": "3"
},
{
"label": "35~44 岁",
"value": "4"
}]
}
}
}
=================================================================== ======================================
查询关联的定向模板详情
通过此接口可以查询定向包详情
请求地址
https://ads.cloud.huawei.com/openapi/v2/promotion/adgroup/targeting_package/query
请求方法
GET
请求参数
参数名称 | 类型 | 是否必选 | 描述 |
targeting_id | long | 是 | 任务关联定向包 ID 注:定向模板仅用于创建广告时 快捷选择定向条件; 编辑定向模 板,不会自动将定向内容同步到 与此定向模板相关联的广告中。 |
请求示例
=================================================================== ======================================
GTE openapi/v2/promotion/adgroup/targeting_package/query?targeting_id=65002585 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)定义
参数名称 | 类型 | 是否必选 | 描述 |
targeting_id | long | 是 | 任务关联定向包 ID |
gender_struct | Struct4 | 否 | 性别定向, 值为 gender 定向中 的 value |
age_struct | Struct4 | 否 | 年龄定向, 值为 age 定向中的 value |
current_location_struct | Struct4 | 否 | 当前在这里的人,值为 region_geo 和 region_level 定向 中的 code |
residence_location_struct | Struct4 | 否 | 常驻在这里的人,值为 region_geo 和 region_level 定向 中的 value |
series_type_struct | Struct4 | 否 | 手机系列定向,值为 series_type 定向中的 value |
device_price_struct | Struct4 | 否 | 设备价格定向,值为 device_price 定向中的 value |
installed_apps_struct | Struct4 | 否 | 已安装应用定向,如果选择此 定向, value 不为空 |
not_installed_apps _struct | Struct4 | 否 | 未安装应用定向,如果选择此 定向, value 不为空 |
app_category_installed _struct | Struct4 | 否 | 已安装 APP 分类定向, 值为 app_category 定向中的 value |
not_app_category_instal l_struct | Struct4 | 否 | 未安装 APP 分类定向, 值为 app_category 定向中的 value |
app_category_active _struct | Struct4 | 否 | 一个月内活跃 APP 分类定向, 值为 app_category 定向中的 value |
network_type_struct | Struct4 | 否 | 网络类型定向,值为 network_type 定向中的 value |
pre_defined_audience _struct | Struct4 | 否 | 自定义人群定向,值为 pre_define_audience 定向中的 id |
not_pre_defined _audience_struct | Struct4 | 否 | 排除自定义人群定向,值为 not_pre_define_audience 定向中 的 id |
Struct4 定义
参数名称 | 类型 | 是否必选 | 描述 |
value | string[] | 是 | 定向选中的值 |
additional | string | 否 | 返回值 current_location_struct 和 residence_location_struct 会存在 此字段。 REGION_GEO:使用定向 region_geo 进行选择 REGION_LEVEL:使用定向 region_level 进行选择 |
应答示例
=================================================================== ======================================
HTTPS/1. 1 200 OK
{
"code ": 200,
"data": {
"targeting_name": "XXXXX",
"targeting_id": 65002585,
"current_location_struct": {
"additional": "REGION_GEO",
"value": [
"1156410100",
"1156410200",
"1156411500",
"1156419000"
]},
"series_type_struct": {
"value": [
"Honor Other Series"
]}
}
}
===================================================================
=====
- 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
华为广告 | “低代码开发实践分享:共创未…
管理员
该内容暂无评论