查询快手广告组（1）

疑难解答

查询快手广告组（1）

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

查询快手广告组

请求方式：GET/POST

数据格式：JSON

请求参数

字段	类型	是否必填	说明	备注
advertiser_id	long	必填	快手广告主 ID	在获取 access_token 的时候返回
campaign_id	long	选填	快手广告计划 ID	过滤筛选条件，若不传或传空则视为无限制条件
unit_id	long	选填	快手广告组 ID	过滤筛选条件，若不传或传空则视为无限制条件
unit_name	string	选填	快手广告组名称	过滤筛选条件，支持模糊搜索&精确查询
unit_ids	long[]	选填	快手广告组 ID 集	不超过 100 个
status	int	选填	快手广告组状态	过滤筛选条件；-2：不限(已删除)；10：快手广告组已删除；40：快手广告创意已删除.所有不包含已删除其他值无效
start_date	string	选填	开始时间	与 end_date 同时传或同时不传；过滤筛选条件，格式为"yyyy-MM-dd"，参数值对应 update_time 信息
end_date	string	选填	结束时间	与 start_date 同时传或同时不传；过滤筛选条件，格式为"yyyy-MM-dd"，参数值对应 update_time 信息
time_filter_type	int	选填	按创建时间或者更新时间进行筛选	1.如传入此字段时不传"start_date"，与"end_date"字段，则不根据时间筛选。2.传入"start_date"，与"end_date"字段，且此字段为 1 时，按照创建时间进行筛选。3.传入"start_date"，与"end_date"字段，此字段不传，或传值为 0 时，则按照更新时间进行筛选
page	int	选填	请求的页码数	默认为 1
page_size	int	选填	请求的每页行数	默认为 20
review_status_list	int[]	选填	单元审核状态筛选	1：待审核；2：审核通过；3：审核失败；7：待送审
put_status_list	int[]	选填	单元投放状态筛选	1：快手广告投放；2：暂停；3：删除

查询快手广告组巨宣网络

返回参数

字段	类型	说明	备注
campaign_id	long	快手广告计划 ID
unit_id	long	快手广告组 ID
unit_name	string	快手广告组名称
put_status	int	快手广告投放状态（操作结果）	1：快手广告投放中；2：暂停 3：删除
status	int	快手广告组状态（优先看看这个状态，计算结果）	-1：不限，1：计划已暂停，3：计划超预算，6：余额不足，，11：审核中，12：审核未通过，14：已结束，15：已暂停，17：组超预算，19：未达快手广告投放时间，20：有效，22：不在快手广告投放时段
review_detail	string	审核拒绝理由
study_status	int	学习期	1:学习中,2:学习成功,3:学习失败
compensate_status	int	赔付状态	0=不需要赔付(不需要展示赔付标志)，1=成本保障生效中，2=成本保证确认中，3=已赔付完成，4=已失效
bid_type	int	出价类型	1：CPM，2：CPC，6：OCPC(使用 OCPC 代表 OCPX)，10：OCPM，20：eCPC
bid	long	出价	单位：厘
cpa_bid	long	OCPC 出价	单位：厘
ocpx_action_type	int	优化目标	0：未知，2：点击转化链接，10：曝光，11：点击，31：下载完成，53：提交线索，109：电话卡激活，137：量房，180：激活，190: 付费，191：首日 ROI，348：有效线索，383: 授信，384: 完件 715：微信复制;739:7 日付费次数;774:7 日ROI;810:激活付费
deep_conversion_type	int	深度转化目标	3:付费，7:次日留存，10:完件, 11:授信；13:添加购物车；14:提交订单；15:购买；44：有效线索；92：付费 roi；181：激活后24H次日留存；0：无
deep_conversion_bid	long	深度转化目标出价	白名单功能，单位：厘
enhance_conversion_type	int	增强目标
roi_ratio	double	付费 ROI 系数	优化目标为「首日 ROI」时必填：ROI 系数取值范围 ( 0,100 ] 支持到三位小数（如：0.066）
scene_id	int[]	快手广告位	1：选快手广告位；2：按场景选择快手广告位-快手信息流广告（旧广告位，包含上下滑大屏广告）6：上下滑大屏广告；7：双列快手信息流广告（不包含上下滑大屏广告）24：激励视频；11：快看点场景
unit_type	int	创意制作方式	3：DPA 自定义创意（仅在计划类型为商品库推广下使用） 4: 常规自定义创意； 7：程序化创意 2.0
begin_time	string	快手广告投放开始时间	格式：yyyy-MM-dd
end_time	string	快手广告投放结束时间	格式：yyyy-MM-dd,排期不限为 null
schedule	struct	快手广告投放时段	不投放的时段为 null，详请见下方，历史字段，即将废弃
schedule_time	string	快手广告投放时段	24*7 的字符串，0 为不投放，1 为投放，例如：0010000000001....0000
day_budget	long	单日预算	单位：厘
day_budget_schedule	long[]	分日预算	单位：厘，单日预算和分日预算同时存在时，以分日预算为准，优先级高于day_budget
convert_id	int	转化目标
url_type	int	url 类型	当计划类型为 3 时（获取电商下单）时有返回。1：某宝商品短链 2：某宝商品 itemID
web_uri_type	int	url 类型	当计划类型为 5（收集销售线索）&使用建站时有返回：需使用魔力建站不传默认 1，2：落地页
url	string	落地页链接	计划类型是 2（提升应用安装）：返回应用下载地址；计划类型是 3（获取电商下单）：根据 url_type 返回相应信息；计划类型是 4（快手广告推广品牌活动）：返回落地页 url 计划类型是 5（收集销售线索）：返回落地页 url 计划类型是 5（收集销售线索）：建站 idl
site_id	long	建站ID/下载中间页ID	当 web_uri_type = 2 时表示建站 ID，必须为数字，通过「/rest/openapi/v2/lp/page/list」获取。计划类型是2（提升应用安装）且关联应用为安卓时，表示安卓下载中间页ID，通过「/rest/openapi/v2/lp/page/list」获取 "view_comps = 7" 的建站ID。
page_group_detail	struct	程序化落地页信息	快手广告组ID绑定的程序化落地页组信息
schema_uri	string	调起链接	提升应用活跃快手广告营销目标的调起链接
schema_id	String	微信小程序外部调起链接	目前为收集快手广告营销线索计划下的联盟广告位该字段才有效
app_id	long	应用 ID
app_download_type	int	应用下载方式	0：直接下载1：落地页下载（仅在提升应用安装计划下生效）
download_page_url	string	自定义落地页URL	选择落地页下载方式时的自定义落地页URL，仅在提升应用活跃和提升应用安装下生效，site_id 优先级高于此字段，白名单功能
use_app_market	int	优先从系统应用商店下载	0：未设置 1：先从系统应用商店下载使用
app_store	string[]	应用商店列表
diverse_data	struct	应用信息	详情见下方
show_mode	int	创意展现方式	0：未知，1：轮播，2：优选
site_type	int	预约广告	1:IOS 预约缺省为不传或传 0
smart_cover	boolean	程序化创意 2.0 智能抽帧	是否开启智能抽帧
asset_mining	boolean	程序化创意 2.0 素材挖掘	是否开启历史素材挖掘
consult_id	long	是否使用了咨询组件	0=未使用，1=使用；注，咨询组件仅在收集销售线索计划(campaign_type=5)下可用，且使用了咨询组件后，可用的行动号召按钮限于接口返回内容
adv_card_option	int	高级创意开关	0：关闭 1:开启
adv_card_list	struct[]	高级创意列表
playable_id	Long	试玩 ID	可选字段，开启试玩时存在，否则不存在。当用户上传试玩素材成功时返回，用于之后对于快手广告组中试玩创意的编辑操作。
play_button	String	试玩按钮文字内容	开启试玩时存在，否则不存在，示例按钮内容如下：1：立即试玩；2：试玩一下；3：立即体验；4：免装试玩；5：免装体验。启用试玩时：默认“立即试玩”，未启用试玩时：内容为空。
playable_orientation	int	试玩素材的横竖适配	默认值为-1；0:横竖均可；1:竖屏；2:横屏
playable_file_name	string	试玩快手广告的文件名
dpa_unit_sub_type	int	商品广告类型：1-DPA，2-SDPA，3-动态商品卡
library_id	int	商品库ID
outer_id	String	商品第三方ID
dpa_outer_ids	String[]	DPA商品ID集合
dpa_category_ids	String[]	DPA商品类目集合
product_name	String	商品名称
product_price	Double	商品价格	单位：元
product_image	String	商品主图
jingle_bell_id	long	小铃铛组件id
live_user_id	long	粉丝直播推广时，为主播id、短剧推广时为短剧作者id
extend_search	boolean	智能扩词开启状态	false：关闭，true：开启
custom_mini_app_data	struct	推广小程序营销目标小程序信息	推广快手小程序时必填，具体见下方表格。
target	struct	定向数据	详情见下方
template_id	long	定向模板ID
outer_loop_native	int	是否开启原生	0关闭，1开启，不填默认为0仅在计划 campaignType=2提升应用安装、5收集销售线索、7提升应用活跃、19推广快手小程序时，可开启原生投放。
quick_search	int	是否开启快投	0:关闭、1:开启
target_explore	int	是否开启搜索人群探索	0:关闭、1:开启
negative_word_param	Struct	快手搜索广告否词	快手搜索广告新增
backflow_forecast	Struct	回流预估信息	回流预估信息
ad_type	int	快手广告计划类型	0:快手信息流广告，1:快手搜索广告
unit_source	int	快手广告组来源	0:常规（非托管）、1:托管
update_time	string	最后修改时间	格式样例："2019-06-11 15:17:25"
package_id	long	新版应用中心：应用包ID
series_id	long	短剧id
episode_id	long	短剧下剧集id
series_card_type	int	是否使用短剧卡片	0关闭，1开启
series_card_info	struct	短剧卡片信息	具体见下方表格
series_pay_template_id	long	短剧付费模板id	仅在计划 campaignType=30快手号-短剧推广时支持
series_pay_mode	int	短剧付费模式	仅在计划 campaignType=30快手号-短剧推广时，与付费模板一起返回，1-打包，2-虚拟币
u_link	String	Universal Link 链接	IOS下优先调起该链接

快手广告平台以其用户基数大、定向精准和形式多样等特点，成为了广告主们的营销利器。通过快手查询广告组的分析，快手广告平台能够准确地找到目标用户，实现品牌信息的精准传递。同时，其丰富的广告形式和创意的互动体验，能够吸引用户的注意力，提高广告的点击率和转化率。未来，随着技术的发展和市场的变化，快手广告平台将继续优化和创新，为广告主提供更加优质的服务。选择快手广告平台，让品牌在竞争激烈的市场中脱颖而出，让营销目标触手可及！

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

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