华为的广告推广：规划投放（下）

参数名称

类型

是否必选

描述

adgroup_name

string

是

任务名称为必填项，其最大长度不得超过 128 ，需满足正则 regexp=”^[^^|]+$”，且不能重名

campaign_id

string

是

计划 ID 最大长度不得超 50 ，必填，只能填写数字，满足正则 regexp=”^[^^\n|]+$”。

注：该任务所属计划和产品上的产品类型需一致。

详见【创建计划】

channel_package_id

string

否

渠道包 ID 。

即查询渠道包接口中返回的 channel_package_id 。

注：当推广产品类型 product_type 为 ANDROID_APP 时会用到。

详见【查询渠道包】

targeting_template_id

long

是

定向模板 ID 。

即创建定向模板接口中返回的 targeting_template_id 。

注：非 APP 的推广产品不能有 APP 安装定向。

定向模板仅用于创建广告时快捷选择定向条件；编辑定向模板，不会自动将定向内容同步到与此定向模板相关联的广告中。

详见【创建定向模板】

product_id

long

是

推广产品 ID 。

即创建推广产品中接口中返回的 product_id 。

注：任务上非 app 的产品 ID 和任务 ID 为一对一对应关系。

计划和产品上的产品类型需一致，详见【创建推广产品】

adgroup_begin_time

string

是

投放开始日期，格式：YYYY-MM-DD 。

例如：2020-01-01 。

注：开始时间不能小于当前时间，开始时间不能大于结束时间。

开始时间和结束时间差值需要在 5.1.1 查询版位获得的投放此版位的任务最短和最长投放时间范围之内

adgroup_end_time

string

否

投放结束日期，格式：YYYY-MM-DD，为空表示长期投放，例如：2020-01-02 。

注：若存在结束时间，那么结束时间不能小于开始时间

time_period_type

string

是

时间段类型，可以从三种类型中根据自身需求选择其一。

版位查询到的 is_support_time_period 要有权限。

当 time_period 为空时，时间段类型不得为 TIME_PERIOD_DAY_SPECIFIC 或 TIME_PERIOD_HOUR_SPECIFIC 。

详见【时间段类型】

time_period

string

否

当 time_period_type 为 TIME_PERIOD_DAY_SPECIFIC 、TIME_PERIOD_HOUR_SPECIFIC 时必填，且满足正则^[01]{336}$ 。

按照特定时间段投放时，01010100010010……表示指定特殊时段，以半小时为粒度，用 0、1 标识是否选中，1 为选中，0 为未选中。一天 24 小时，即每天 24*2=48 位，共 7 天，即共 48*7=336 位 。

如果 time_period_type 为 TIME_PERIOD_ALL ，则表示一周内每天的特定小时，需要每 48 个值都重复。

注：时间段要与任务的日期区间有交集。

例：如果任务开始时间是 2020-06-22 (周一) ， 结束时间是 2020-06-24 (周三) ，且选择的类型是 TIME_PERIOD_DAY_SPECIFIC 或 TIME_PERIOD_HOUR_SPECIFIC ，那 time_period 的入参需要与任务的时间段有交集；若用户想在 22/23/24 的每天早上 6 点到 9 点投放任务，则 time_period 的参数可表示为 00000000000011111100…0000…(共 336 位, 每 48 位代表一天 24 小时，重复 7 次)

price_type

string

是

出价方式。

注：CPM(CostPerMille)，CPC(CostPerClick)，CPD(CostPerDownload) 。

详见【付费方式】

price

float

是

出价，整数位不得超过 9 位，小数位不得超 2 位。

注：范围在计划日限额和对应出价方式查询版位底价之间

conversion_cost

float

否

期望转化成本，当 price_type 为 PRICING_OCPC 时专用，暂时只支持 APP 和网页。

整数位不得超过 9 位，小数位不得超 2 位

creative_size_id

long

是

版位 ID 。

详见【查询版位】

channel_info

string

否

转化跟踪参数不得超 1024 位，只允许出现英文字母大小写、数字、中划线、下划线。

dyn_price_flag

string

否

智能提价标志。

仅当推广产品为 ANDROID_APP 且定向模板中 installed_apps_struct 值为 true 时有效。

详见【智能提价标志】

当 dyn_price_flag 为 DYNAMIC_PRICE_ENABLE 时。

必填。

智能提价上限，范围在 1 到 10 之间，

整数位不得超过 2 位，小数位不得超 1 位

tracking_id

long

否

转化跟踪指标 ID，当 price_type 为 PRICING_OCPC 时必填

参数名称

类型

是否必选

描述

code

string

是

返回码

message

string

否

返回描述

data

Struct1

否

任务 ID

参数名称

类型

是否必选

描述

adgroup_id

long

是

任务 ID

参数名称

类型

是否必选

描述

page_num

integer

是

搜索页码，取值范围 1~10000

page_size

integer

是

一页展示数量，取值范围 10~50

以下为过滤条件

campaign_id

string

否

计划 ID 最大长度不得超 50 ，必填，只能填写数字，不能使用“^”和换行

adgroup_name

string

否

任务名称，注：字段不能为 null

adgroup_ids

long[]

否

任务 ID 列表

product_type

string

否

推广产品，详见【推广产品】

product_id

long

否

推广产品 ID ，注：任务上非 app 的产品 ID 和任务 ID 为一对一关系，计划和产品上的产品类型需一致

store_app_id

string

否

华为应用市场 APP ID，如：C12345

updated_begin_time

string

否

任务更新的开始时间，格式:”yyyy-MM-ddHH:mm:ss”

updated_end_time

string

否

任务更新的结束时间，格式:”yyyy-MM-ddHH:mm:ss”