快手广告管理平台的 Marketing API 开发文档之《NO.4》

target

字段

类型

是否必填

说明

备注

region

long[]

可选

地域

传值为[]表示不限；传递上一级 ID 时，childrenID 可以不传；不允许同时传 parentID 和 childrenID；地域信息可通过地域接口获取；仅计划的 campaign_type 为 5 时，支持设置三级地域（例如：山西 – 大同 – 左云，左云是三级地域）

district_ids

long[]

可选

商圈定向

与 region 字段不能同时传，受白名单控制，最多选 100 个。可以通过 /rest/openapi/v1/region/district/list 接口获取商圈信息

user_type

int

可选

用户类型

0：实时；1：常驻；2：不限

age

struct

可选

自定义年龄段

不传值表示不限，传值详情见下方表格；与 ages_range 不能同时传

ages_range

int[]

可选

固定年龄段

与 age 不能同时传；【18：表示 18 – 23 岁】【24：表示 24 – 30 岁】【31：表示 31 – 40 岁】【41：表示 41 – 49 岁】【50：表示 50 – 100 岁】

gender

int

可选

性别

1：女性，2：男性，0 表示不限

platform_os

int

可选

操作系统

1：Android，2：iOS，0 表示不限。当计划类型为 2（提升应用安装）时该字段可忽略

android_osv

int

可选

Android 版本

3：不限，4：4.x+，5：5.x+，6：6.x+，7：7.x+，8：8.x+，9：9.x+，10：10.x+；当计划类型为 2（提升应用安装）时，仅当 app_id 表示的是 Android 应用可使用此字段传递版本

ios_osv

int

可选

iOS 版本

6：不限，7：7.x+，8：8.x+，9：9.x+，10：10.x+；11：11.x+；12：12.x+；13：13.x+。当计划类型为 2（提升应用安装）时，仅当 appId 表示的是 iOS 应用可使用此字段传递版本

network

int

可选

网络环境

1：Wi-Fi，2：移动网络，0 表示不限

device_brand

int[]

可选

设备品牌

传值为[]表示不限；当 platform_os 为 2（iOS）时，没有设备品牌定向；1：OPPO，2：VIVO，3：华为，4：小米，5：荣耀，6：三星，7：金立，8：魅族，9：乐视，10：其他，11：苹果（只有 platform_os 为不限时支持此选项）

device_price

int[]

可选

设备价格

传值为[]表示不限；1：1500 元以下，2：1501 – 2000，3：2001 – 2500，4：2501 – 3000，5：3001 – 3500，6：3501 – 4000，7：4001 – 4500，8：4501 – 5000，9：5001 – 5500，10：5500 元以上

business_interest_type

int

可选

商业兴趣类型

0：不限，1：智能推荐，2：按照兴趣标签；投放账户二级行业为空（个别情况）时不可使用智能推荐

business_interest

long[]

商业兴趣

当 business_interest_type 为 2 时必填，id 不能重复且必须准确，具体 id 可通过下方标签接口获取

fans_star

long[]

可选

网红粉丝

id 不能重复且必须准确，具体 id 可通过下方标签接口获取

interest_video

long[]

可选

兴趣视频用户

id 不能重复且必须准确，具体 id 可通过下方标签接口获取

app_interest

long[]

可选

APP 行为 – 按分类

id 不能重复且必须准确，具体 id 可通过下方标签接口获取；仅包含安卓数据，若操作系统定向 IOS 则无效；不能同时选择 app_ids

app_ids

long[]

可选

APP 行为 – 按 APP 名称

id 不能重复且必须准确，具体 id 可通过下方应用接口获取，建议不超过 10 个，否则可能出现报错；仅包含安卓数据，若操作系统定向 IOS 则无效；不能同时选择 app_interest

filter_converted_level

int

可选

过滤已转化人群纬度

快手联盟广告、快手小店通不支持。优化目标不支持【封面曝光数】和【封面点击数】。非应用下载类推广不支持过滤【APP】纬度。0(默认)：不限，1：广告组，2：广告计划，3：本账户，4：公司主体，5：APP

population

long[]

可选

人群包定向

通过 /rest/openapi/v1/dmp/population/list 获取，人群包 id。population 不能重复，与 exclude_population 不能有交集，不能传付费人群包，付费人群包标识字段：population_type = 7

exclude_population

long[]

可选

人群包排除

通过 /rest/openapi/v1/dmp/population/list 获取，人群包 id。exclude_population 不能重复，不能传付费人群包，付费人群包标识字段：population_type = 7

paid_audience

long[]

可选

付费人群包 id

通过 /rest/openapi/v1/dmp/population/list 获取人群包 id。1、不能重复，只能传付费人群包，且 third_platform_code 要一样；2、如果传了【population 或 exclude_population】，报错；修改时要也要保证【population 或 exclude_population】不能同时传；3、创建时若已经有了【population 或 exclude_population】修改时只传 paid_audience 也会报错，这时需要把 population 或 exclude_population 设为[]才行，反之也一样。总之，【population 或 exclude_population】与【paid_audience】不能同时存在

intelli_extend

struct

可选

智

能扩量

不传值表示不使用，传值详情见下方表格

behavior_interest

struct

非必填

行为兴趣定向

behavior.keyword 、behavior.label、interest.lable 其中一个必传，具体传值见下方表格