快手投放广告平台:查询定向模板接口

发布时间:2023-06-13 22:23:04 作者:巨宣网络 来源:juxuan.net 浏览量(82)

请求接口:https://ad.e.kuaishou.com/rest/openapi/v1/target/template/list

请求方式:GET/POST

数据格式:JSON

请求参数

字段类型是否必填说明备注
advertiser_idlong必填快手广告主 ID,在获取 accessToken 的时候返回
pageint选填请求的页码,默认为 1
page_sizeint选填每页行数,默认 20

返回参数

字段类型说明备注
codeint请求返回码见文后【返回码】
messagestring请求返回信息见文后【返回信息】
datajsonjson返回值
totoal_countlong总数
template_idint定向模板 ID
template_namestring定向模板名称
create_timestring定向模板创建时间,"2019-06-11 15:17:25"
update_timestring定向模板最近修改时间
auto_targetboolean选填过滤定向模版默认:返回所有类型模版;false:只获取自定义定向模版;true :只获取智能定向模版
targetstruct定向信息见下
unit_countint绑定unit个数
intention_targetboolean行为意向-系统优选
behavior_intereststruct行为兴趣定向详情见下方

target

字段类型是否必填说明备注
regionlong[]可选地域传值为 [] 表示不限,传递上一级 id 时,children id 可以不传,不允许同时传 parent id 和 children id, 地域信息可通过/region/list接口获取
district_idslong[]可选商圈定向与region字段不能同时传、白名单控制,最多选100个。 可以通过/rest/openapi/v1/region/district/list接口获取商圈信息
user_typeint可选用户类型0:实时 1:常驻 2:不限
ages_rangeint []可选可选年龄段18:18-23岁 24:24-30岁 31:31-40岁 41:41-49岁 50:50-100岁
agestruct可选自定义年龄段年龄最小限制,大于等于 18 min 和 max 年龄区间最小为 5 岁
genderint可选性别1:女性, 2:男性,0 表示不限
platform_osint可选定向的 os 版本应用安装类计划以app_id中的platform_os为准 1:Android,2:iOS,0 表示不限
android_osvint可选Android 版本3:不限, 4:4.x+, 5:5.x+, 6:6.x+, 7:7.x+
ios_osvint可选iOS 版本6:不限, 7:7.x+, 8:8.x+, 9:9.x+, 10:10.x+
networkint可选网络环境1:WI-FI,2:移动网络,0:表示不限
filter_converted_levelint可选过滤已转化人群纬度0:不限 1:广告组 2:快手广告代运营计划 3:本账户 4:公司主体 5:APP
device_brandint[]可选设备品牌1:OPPO,2:VIVO, 3:华为,4:小米,5:荣耀,6:三星,7:金立,8:魅族,9:乐视,10:其他,11:苹果(只有 platform_os 为不限时支持此选项); 传值为 [] 表示不限; 当 platform_os 表示 iOS 的时候,没有设备品牌定向
device_priceint[]可选设备价格,1:1,500元以下,2:1,501~2,000,3:2,001~2,500,4:2,501~3,000,5、3,001~3,500,6:3,501~4,000,7:4,001~4,500,8:4,501~5,000,9:5,001~5,500,10:5,500元以上,传值为 [] 表示不限
business_interest_typeint可选商业兴趣类型0:默认值 1:智能投放 2:兴趣标签
business_interestlong[]可选商业兴趣,具体 id 可通过 /rest/openapi/v1/tool/targeting_tags/list 获取 当 business_interest_type 为 2 时必填,id 不能重复且必须准确
fans_starlong[]可选网红类别id 不能重复且必须准确
interest_videolong[]可选兴趣视频,id 不能重复且必须准确
app_interestlong[]可选APP行为-按分类1、APP 行为分类选择,id 不能重复且必须准确; 2、只有「提升应用安装」的计划且 Android 应用支持此定向;其他计划填写无效; 3、iOS 不支持行为定向,填写无效;app_ids 和 app_interest 不能同时选择
app_idslong[]可选APP行为-按APP名称可通过 /rest/openapi/v1/tool/app/search 查询 1、APP 行为定向,id 不能重复且必须准确; 2、只有「提升应用安装」的计划且 Android 应用支持此定向;其他计划填写无效; 3、iOS 不支持行为定向,填写无效;app_ids 和 app_interest 不能同时选择
populationlong[]可选定向人群包可通过/rest/openapi/v1//dmp/population/list查询 1、定向人群包,人群包 id 不能重复且必须准确 2、人群包状态必须是已推送状态
paid_audiencelong[]可选付费人群包可通过/rest/openapi/v1//dmp/population/list查询 1、付费人群包,人群包 id 不能重复且必须准确 2、人群包状态必须是已推送状态,与定向、排除人群包互斥
exclude_populationlong[]可选排除人群包1、排除人群包,人群包 id 不能重复且必须准确;人群包状态必须是已推送状态 2、如果同时传了 population 和 exclude_population,则表示同时定向排除; 3、population 和 exclude_population 这两个字段不能包含交集的 id
intelli_extendstruct可选智能扩量不传值表示不使用,传值具体见下方表格

intelli_extend

字段类型说明备注
is_openint可选开启智能扩量默认为0,为1时打开智能扩量,其他数值报错;关闭智能扩量时,以下三个字段必须为0
no_age_breakint可选不可突破年龄默认为0(可突破/无需控制),定向age数据不为空时,可设为1(不可突破)。
no_gender_breakint可选不可突破性别默认为0(可突破/无需控制),定向gender数据不为空时,可设为1(不可突破)。
no_area_breakint可选不可突破地域默认为0(可突破/无需控制),定向region数据不为空时,可设为1(不可突破)。

age

字段类型说明备注
minint可选年龄最小值年龄最小限制,大于等于 18
maxint可选年龄最大值年龄最大限制,少于等于 55

behavior

字段类型说明备注
keywordstruct[]行为定向关键词,详情见下方
labelstring[]行为定向,类目词
time_typeint在多少天内发生行为的用户0:7天 1:15天 2:30天 3:90天 4:180天
strength_typeint行为强度0:不限 1:高强度
scene_typeint[]行为场景1:社区 2:APP 3:电商 4:推广

behavior

字段类型说明备注
idlong关键词id
namestring关键词名称

interest

字段类型说明备注
labelstring[]兴趣定向类目词
strength_typeint兴趣标签强度0:不限 1:高强度

如果你想知道家装行业的广告在快手平台如何营销,想知道更多干货知识,想知道快手平台的短视频、直播内容怎么做,就找一家专业的互联网网络公司帮助你,想知道更多内部消息就来巨宣网络吧!!详情请拨打我们的客服电话:4009602809!!

公司优势

提供80+媒体资源

我司提供互联网广告营销服务超10年,拥有专业的人才储备

行业头部客户运营经验

拥有单账户日消耗百万运营经验,广告账户总量超1万!

专业建站/美工/拍摄团队

账户开通后,提供专业的建站运营服务,百名运营服务!

较高政策优惠

如无需我司进行代运营,可提供较高返点政策,靠谱!

注意事项

首次开通账户注意哪些?
不论您是想投放那个媒体,都需要提前确定开户资质,避免因为资质不全无法上线,资质齐全才能上线广告,不论任何广告平台,资质齐全是广告上线最重要的第一步!
开通广告账户需要多少钱?
每个广告账户开户价格都有所差距,业内基础开户价格基本为5000元起充值,如低于该费用,需再三核实对方信息,避免上当受骗!
一般开通广告账户需要多长时间?
如果您的资质齐全,开户时间基本当天就可以下户,如行业较为特殊,开户时间基本不超过3个工作日。
开户后你们能做哪些服务?
开通广告账户后,我司可以协助广告主搭建落地页、上传广告素材、制作广告素材、效果优化等服务,我司拥有运营人员上百人!
可以帮助我们拍摄视频吗?
我司不提供免费视频拍摄,因目前各平台对于素材审核较为严格,视频素材如需我司提供需与我司客服沟通拍摄要求,视频拍摄价格从300元-3000元不等,根据广告主需求确定价格。

巨宣网络

专注信息流广告/直播广告/搜索广告/短视频广告开户服务!