华为广告推广计划编辑任务期望出价(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"
]}
}
}
===================================================================
=====
为什么选择华为广告推广?高品质的用户人群,依托华为海量终端,结合丰富的媒体资源以及广告形式,精准触达目标用户,38 亿+月活用户;8300 万+高端商务用户群,聚集核心18-44岁年龄段的高端,优质人群,一二线城市用户占比达50%+,具有活跃度高,学历高,收入高等特征。巨宣广告服务华为广告主上百家,如果你也要在华为投放,可以联系我们,期待与您合作!

评论列表