查询快手广告组（2）

疑难解答

查询快手广告组（2）

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

schedule

字段	类型	说明	备注
mon	int[]	周一时间段	时间段范围0, 23
tues	int[]	周二时间段	时间段范围0, 23
wed	int[]	周三时间段	时间段范围0, 23
thur	int[]	周四时间段	时间段范围0, 23
fri	int[]	周五时间段	时间段范围0, 23
sat	int[]	周六时间段	时间段范围0, 23
sun	int[]	周日时间段	时间段范围0, 23

diverse_data

字段	类型	说明	备注
app_name	string	应用名称
app_package_name	string	应用包名
device_os_type	int	应用操作系统类型	0：未知，1：ANDROID，2：IO

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（提升应用活跃）时，仅当 appId 表示的是 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：行为意向系统优选。联盟广告位不支持后者。
behavior_interest	struct	行为兴趣定向	behavior.keyword 、behavior.label、interest.lable 其中一个必传，具体传值下方表格；仅在 behavior_type = 1 时生效
disable_installed_app_switch	int	过滤已安装人群维度	0：过滤（默认），1：不限
filter_time_range	int	用户的转化时间范围	0：30天；1：60天；2:90天。该定向仅支持快手站内广告位，不支持联盟广告位。
celebrity	struct	快手网红	behaviors、fans_star两个字段必填充。该定向仅支持快手站内广告位，不支持联盟广告位。
media	long[]	媒体定向包
exclude_media	long[]	媒体定向排除包
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：不限；快手广告营销目标为提升应用安装时可用