创建快手广告组（2）

疑难解答

创建快手广告组（2）

发布时间：2024-01-05浏览次数：62

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（提升应用安装）,7（提升应用活跃）时，仅当 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+；14：14.x+；15：15.x+；16：16.x+；当计划类型为 2（提升应用安装）,7（提升应用活跃）时，仅当 app_id 表示的是 IOS 应用可使用此字段传递版本
network	int	选填	网络环境	1：Wi-Fi，2：移动网络，0：表示不限
device_brand_ids	long[]	选填	设备品牌ID列表	传值为[]表示不限；当 platform为iOS定向时，没有设备品牌定向。
device_price	int[]	选填	设备价格	1：1500元以下（近期下线），新增 11:1000元以下，12:1001~1500，请直接使用新枚举值； 2：1501~2000，3：2001~2500，4：2501~3000，5：3001~3500，6：3501~4000，7：4001~4500（近期下线），新增：13:4001~5000； 8：4501~5000（近期下线），新增：13:4001~5000； 9：5001~5500（近期下线），新增：14:5001~6000； 10：5500元以上（近期下线），新增：15:6000元以上；传值为[]表示不限；
app_interest_ids	long[]	选填	APP 行为-按分类	id 不能重复且必须准确，具体 id 可通过下方标签接口获取；仅包含安卓数据，若操作系统定向 IOS 则无效；不能同时选择 app_ids（新标签体系字段，替换 app_interest，与 app_interest 同时传递，app_interest 字段失效）。该定向仅支持快手站内广告位，不支持联盟广告位。
app_ids	long[]	选填	APP 行为-按 APP 名称	id 不能重复且必须准确，具体 id 可通过下方应用接口获取，建议不超过 10 个，否则可能出现报错；仅包含安卓数据，若操作系统定向 IOS 则无效；不能同时选择 app_interest。该定向仅支持快手站内广告位，不支持联盟广告位。
filter_converted_level	int	选填	过滤已转化人群纬度	快手搜索广告、快手联盟广告、小店通不支持。优化目标不支持【封面曝光数】和【封面点击数】非应用下载类推广不支持过滤【APP】纬度。0(默认)：不限；1：快手广告组 2：快手广告计划；3：本账户；4：公司主体；5：APP；6:快手广告运营自定义产品名
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】不能同时存在。该定向仅支持快手站内广告位，不支持联盟广告位。
seed_population	long[]	选填	种子人群包	当快手广告账户开通种子人群包功能后方可使用此功能。该定向仅支持快手站内广告位，不支持联盟广告位。
intelli_extend_option	int	选填	智能定向开关	0：智能定向关闭；1：智能定向开启；2：智能定向Pro开启（白名单可用）；和auto_population字段互斥，只能有一个字段开启
behavior_type	int	条件必填	行为兴趣类型	0：不限；1：自定义行为意向；2：行为意向系统优选，快手联盟广告位不支持。当target定向字段不为null时，此字段必填，无默认值。
behavior_interest	struct	选填	行为兴趣定向	behavior.keyword 、behavior.label、interest.lable 其中一个必传，具体传值下方表格；仅在 behavior_type = 1 时生效。快手联盟广告位不支持interest。
disable_installed_app_switch	int	选填	过滤已安装人群维度	0：过滤（默认），1：不限
filter_time_range	int	选填	用户的转化时间范围	0：30天；1：60天；2:90天。该定向仅支持快手站内广告位，不支持联盟广告位。
celebrity	struct	选填	快手网红	behaviors、fans_star两个字段必填充。该定向仅支持快手站内广告位，不支持联盟广告位。
media	long[]	选填	媒体定向包	若选择使用定向行业优质流量包（media_source_type = 1），此处单选：1 - 超休闲游戏；2 - 重度游戏；4 - 直营电商；5 - 平台电商；若选择使用快手广告主自定义媒体包（media_source_type = 2），此处多选，填写媒体包 id【快手联盟广告位生效】
exclude_media	long[]	选填	媒体定向排除包	media 和 exclude_media 只可选其一，若选择使用排除行业优质流量包（media_source_type = 1），此处单选：1 - 超休闲游戏；2 - 重度游戏；4 - 直营电商；5 - 平台电商；若选择使用快手广告主自定义媒体包（media_source_type = 2），此处多选，填写媒体包 id；【快手联盟广告位生效】
media_source_type	int	选填	媒体包来源	默认为 0，0-不限，未指定，1-行业优质流量包，2-快手广告主自定义
ip_type	int	选填	地域IP类型	白名单可用，0-默认IP、1-广协IP
auto_population	int	选填	智能人群包	白名单可用，0-默认、1-智能人群包开启。和 intelli_extend_option 字段互斥，只能有一个字段开启
disable_installed_app_switch	int	选填	过滤已安装人群	0：过滤（默认）；1：不限；快手广告营销目标为提升应用安装时可用

celebrity

字段	类型	是否必填	说明	备注
behaviors	int[]	必填	行为类型	该字段为平台对应快手网红功能中的行为类型，可多选，但不可不选，不选会导致快手网红定向失效，定义如下 0:关注、1:视频互动、2:直播互动
fans_stars	fans_star[]	必填	网红内容	该字段包括平台对应快手网红功能中的网红分类和快手网红两项，数据保证录入顺序，可从【快手网红-网红分类】和【快手网红-搜索快手网红】接口获取对应数据

fans_star

字段	类型	是否必填	说明	备注
id	string			如使用该功能则必填此项，该字段有两种含义 1、当是网红分类，即type=1时，该字段传入对应网红分类对应的父ID与当前ID的拼接字符串，如传入"33-177"表示一级网红分类"游戏"下的二级网红分类"沙盒游戏"，如选中的是一级网红分类，则直接传入当前ID如"33" 2、当是快手网红，即type=2时，该字段传入对应快手网红的author_id，如传入"1151465119"表示快手网红小脑斧来自N次元
type	int			如使用该功能则必填此项，该字段为平台对应快手网红功能中的网红分类和快手网红两项，可从【快手网红-网红分类】和【快手网红-搜索快手网红】接口获取对应数据 1:网红分类、2:快手网红
name	string			如使用该功能则必填此项，该字段有两种含义 1、当是网红分类，即type=1时，该字段传入对应网红分类对应的父name与当前name的拼接字符串，如传入"游戏-沙盒游戏"表示一级网红分类"游戏"下的二级网红分类"沙盒游戏"，如选中的是一级网红分类，则直接传入当前ID如"游戏"，保证传入的值与传入id对应网红标签name（拼接）一致 2、当是快手网红，即type=2时，该字段传入对应快手网红的kwai_id，如传入"小脑斧来自N次元"表示快手网红小脑斧来自N次元，保证传入的值与传入id对应的快手网红的kwai_id保持一致
category	int[]			当是快手网红，即type=2时，该字段传值有效，对应当前快手网红的分类，格式为first_label_id,second_label_id，如果second_label_id不存在，则只传入first_label_id，如传入32, 241表示当前快手网红属于影视-影视分类二级网红分类

快手广告投放创建广告组

age

字段	类型	是否必填	说明	备注
min	int	必填	年龄小的限制	年龄区间小的为 18 岁
max	int	必填	年龄大的限制	年龄区间大的为 55 岁，且年龄大的限制须大于等于年龄小的限制

behavior_interest

字段	类型	是否必填	说明	备注
behavior	struct	必填	行为定向	behavior 与 interest 同时不传，则清空行为兴趣定向
interest	struct	选填	兴趣定向	behavior 与 interest 同时不传，则清空行为兴趣定向

behavior

字段	类型	是否必填	说明	备注
keyword	struct[]	选填	行为定向关键词	根据/rest/openapi/v1/tool/keyword/query 接口获取
label	string[]	选填	行为定向类目词	根据/rest/openapi/v1/tool/label/behavior_interest 接口获取。将行为类目 id 从高层类目 id 开始，以“-”连接起来，假如有一个类目 id 为 80202，父类目 id 为 802，高层类目 id 为 8，则此时应该写"8-802-80202"；如果想全选高层类目"8"底下的所有子类目，填"8"
time_type	int	必填	在多少天内发生行为的用户	0:7 天；1：15 天；2：30 天；3：90 天；4：180 天
strength_type	int	必填	行为强度	0：不限；1：高强度
scene_type	int[]	必填	行为场景	1：社区；2：APP；3:电商；4：快手广告推广

keyword

字段	类型	是否必填	说明	备注
id	long	必填	关键词 id	id 与 name 需互相匹配
name	string	必填	关键词名称	id 与 name 需互相匹配

interest

字段	类型	是否必填	说明	备注
label	string[]	选填	兴趣定向类目词	根据/rest/openapi/v1/tool/label/behavior_interest 接口获取。将兴趣类目 id 从高层类目 id 开始，以“-”连接起来，假如有一个类目 id 为 80202，父类目 id 为 802，高层类目 id 为 8，则此时应该写"8-802-80202"；如果想全选高层类目"8"底下的所有子类目，填"8"
strength_type	int	必填	兴趣标签强度	0：不限 1：高强度

dpa_unit_param

字段	类型	是否必填	说明	备注
dpa_unit_sub_type	int	选填	商品广告类型	商品广告必填：1-DPA，2-SDPA，3-动态商品卡（2/3在提升应用安装、提升应用活跃、收集营销线索、小程序推广营销目标下可用）
library_id	long	选填	商品库ID	商品广告必填
product_id	string	选填	快手商品ID	SDPA必填
outer_id	string	选填	外部商品ID	SDPA必填
click_url	string	选填	点击跳转监测链接	DPA可用（scene_id = 5 须在 creative 填写）
actionbar_click_url	string	选填	Actionbar点击跳转监测链接	DPA可用（scene_id = 5 须在 creative 填写）
impression_url	string	选填	曝光监测链接,DPA可用（scene_id = 5不支持）	DPA可用
dpa_outer_ids	String[]	选填	DPA 商品ID集合	DPA可用（仅scene_id = 5支持），与dpa_category_ids 二选一，两者并存优先dpa_outer_ids
dpa_category_ids	String[]	选填	DPA商品类目集合	DPA可用。类目 ID 通过商品库类目信息接口获取。类目之间用 - 分隔，如："一级类目ID-二级类目ID-三级类目ID" 或 "一级类目ID"。与 dpa_outer_ids 二选一，两者皆空则全类目投放

custom_mini_app_data

字段	类型	是否必填	说明	备注
mini_app_id_platform	string	选填	小程序APPID	计划 campaignType=19 推广快手小程序时必填，不能超过30个字符。注：当快手广告账户加了小游戏推广白名单时，不需要填写。
bootstrap_page	string	选填	小程序启动页面	跳转小程序时将直接进入该页面，计划 campaignType=19 小程序推广时必填。例：page/app/index。注：当快手广告账户加了小游戏推广白名单时，必填。
bootstrap_params	string	选填	小程序启动参数	启动参数可以追踪页面来源，计划 campaignType=19 小程序推广时选填。例：name=lilei&age=18。注：当快手广告账户加了小游戏推广白名单时，不需要填写。

negative_word_param

字段	类型	是否必填	说明	备注
exact_words	string[]	精确否定词	快手搜索广告新增
phrase_words	string[]	短语否定词	快手搜索广告新增

series_card_info

字段	类型	是否必填	说明	备注
pic_id	long	选填	短剧卡片封面	图片比例3:4，仅支持PNG/JPEG/JPG，图片不能大于2M
label	string[]	必填	短剧卡片标签	『专属推荐』、『口碑好剧』、『本月精品』、『本月热播』、『爽文改编』五选二
description	string	必填	短剧卡片简介	不超过100个字，若选择开启短剧卡片，该字段必填

返回参数

字段	类型	是否必填	说明	备注
code	number	返回码
message	struct	返回信息
data	struct	JSON 返回值
unit_id	long	快手广告组 ID

在数字化营销的浪潮中，快手广告投放以其精准的定位、丰富的内容形式和高效的转化效果，成为品牌与消费者之间的桥梁。它不仅提升了品牌知名度，更实现了营销目标的有效转化。未来，随着技术的不断创新和市场的深入发展，快手广告投放将继续引领行业趋势，助力更多企业在激烈的市场竞争中脱颖而出，实现商业价值与社会效益的双赢。

原文链接：https://www.kuai-ad.com/jd/7276.html

快手视频推广,快手开户平台