华为广告推广：编辑任务期望出价

当前位置：首页 > 疑难解答

疑难解答

华为广告推广：编辑任务期望出价

发布时间：2022-07-18浏览次数：61

华为广告推广计划编辑任务期望出价(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

否

树状结构定向数据

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％+，具有活跃度高，学历高，收入高等特征。巨宣广告服务华为广告主上百家，如果你也要在华为投放，可以联系我们，期待与您合作！

原文链接：https://huawei.juxuan.net/h/jd/875.html

华为推广,华为开户平台