修改快手广告组（1）

当前位置：首页 > 疑难解答

疑难解答

修改快手广告组（1）

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

修改快手广告组

请求方式：POST

数据格式：JSON

注意事项：修改接口可仅传只需要修改的字段。传null或者不传表示不修改其他字段。传默认值、空列表表示清空某字段。

修改快手广告组巨宣网络

请求参数

字段	类型	是否必填	是否可修改	说明	备注
advertiser_id	long	必填	-	快手广告主 ID	在获取 access_token 的时候返回
unit_id	long	必填	-	快手广告组 ID
unit_name	string	必填	是	快手广告组名称	长度为 1-100 个字符，同一个计划下的快手广告组名称不能重复
put_status	int	选填	是	快手广告组的投放状态	1：快手广告组投放中；2：快手广告组暂停投放；3：删除快手广告组，已删除的广告组不可变更。
bid_type	int	必填	否	优化目标出价类型	2：CPC（计划类型为粉丝直播推广、DPA不支持，计划出价为MCB不支持；快手广告组选择开屏不支持；快手搜索广告需要添加白名单才可支持）；10：OCPM ；12:转化
bid	long	选填	是	出价	bid_type 为 CPC 时该字段必填，单位：厘，不得低于 0.2 元，不得高于 100 元，不得高于组预算
cpa_bid	long	选填	是	出价	bid_type 是 OCPM 时该字段必填，单位：厘，ocpx_action_type 为 2 时，不得低于 0.1 元，不得高于 10 元；ocpx_action_type 为 180 时，不得低于 1 元，不得高于 3000 元，ocpx_action_type 为 53 时，不得低于 5 元，不得高于 3000 元；不得高于组预算
deep_conversion_bid	int	选填	是	深度转化出价	单位：厘，仅当 deep_conversion_type 可用且快手广告账户满足白名单时选填，出价需大于 cpa_bid，小于 min{组预算，3000 元}，不得高于组预算，不支持从 0 改为其他值，也不支持从其他值改为 0
deep_conversion_type	int	选填	否	深度转化目标	3:付费，7:次日留存，10:完件, 11:授信；13:添加购物车；14:提交订单；15:购买；44：有效线索；92：付费 roi；181：激活后24H次日留存。可通过下方深度转化信息查询接口获取当前账户可选的深度转化目标
roi_ratio	double	选填	是	付费 ROI 系数	优化目标为「首日 ROI」时必填：ROI 系数取值范围 ( 0,100 ] 支持到三位小数（如：0.066）
scene_id	int[]	选填	否	资源位置	快手联盟广告不可修改，快手广告组下有创意也不能修改
begin_time	string	选填	是	快手广告投放开始时间	格式为 yyyy-MM-dd，需大于等于当前时间
end_time	string	选填	是	快手广告投放结束时间	格式为 yyyy-MM-dd，不传值表示从今天开始长期投放，传值表示设置开始时间和结束时间，且快手广告投放结束时间需大于等于快手广告投放开始时间。想要设置为长期投放时，传空字符串。
schedule_time	string	选填	是	快手广告投放时间段	格式为 24*7 位字符串，且都为 0 和 1，以一个小时为小粒度，从周一零点开始至周日 24 点结束；0 为不投放，1 为投放，不传/全传 1/全传 0 视为全时段投放
day_budget	long	选填	是	分日预算	单位：厘，指定 0 表示预算不限，默认为 0；每天不小于 100 元，不超过 100000000 元，仅支持输入数字；修改预算不得低于该广告组当日花费的 120% 和修改前预算的较小者，与 day_budget 不能同时传，均不能低于组出价
day_budget_schedule	long[]	选填	是	分日预算	单位：厘，指定 0 表示预算不限，默认为 0；每天不小于 100 元，不超过 100000000 元，仅支持输入数字；修改预算不得低于该账户当日花费的 120% 和修改前预算的较小者，与 day_budget 不能同时传，优先级高于day_budget
url_type	int	选填	否	url 类型	当计划类型为获取电商下单（campaign.type=3）时必填，其它场景下无效；3 - 手淘落地页（深度唤醒手机某宝，scene_id为5时联盟场景不可用）；
web_uri_type	int	选填	否	url 类型	当计划类型为收集销售线索、提升应用活跃（campaign.type = 5/7 ）且使用建站落地页时必填；1：快手广告主自有链接，默认填充值； 2：建站落地页，此时siteId_id 需要填充；3：程序化落地页，此时group_id需要填充（仅收集营销线索下可用）；4：微信小程序调起链接（仅收集营销线索下且scene_id包含5可用）；
url	string	选填	否	快手广告投放链接	长度不超过 1000 字符；计划类型是获取电商下单（campaign.type=3)，url_type = 3 时表示手淘落地页；计划类型是 4（快手广告推广品牌活动）：落地页 URL；web_uri_type = 1 时表示客户自有链接必填；web_uri_type = 4 时表示小程序的落地页；「房地产」「家装建材」「招商加盟」三个二级行业【收集销售线索】目标下隐藏客户自有链接填写入口。
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。
group_id	long	选填	否	程序化落地页ID	web_uri_type = 3 时表示程序化落地页ID，必须为数字，通过「/rest/openapi/gw/magicsite/v1/group/list」获取；
schema_uri	string	选填	是	调起链接	提升应用活跃营销目标的调起链接；应用推广下在已经安装 app 的用户手机上可以拉起 app（需要运营加白），快手开屏广告如果营销目标是应用活跃，调起链接必须在品牌开屏白名单中；当 web_uri_type = 4 时，该字段必填，表示带归因参数的小程序启动页面链接，当campaign.type=5时，白名单用户可填
schema_id	String	选填	否	微信小程序ID	收集营销线索下，web_uri_type = 4时生效，表示微信小程序ID
app_id	long	选填	否	应用 ID	当计划类型为提升应用活跃/提升应用安装/商品库推广（campaign.type = 2/7/9）时必填，可通过应用列表接口「/rest/openapi/v2/file/ad/app/list」获取应用 ID；当计划类型为粉丝直播推广（campaign.type = 16），且组件类型为小铃铛关联了应用时必填。
app_download_type	int	选填	否	应用下载方式	0 - 直接下载；1 - 落地页下载；仅在提升应用活跃（默认是直接下载）、提升应用安装（默认是落地页下载）下白名单生效。
download_page_url	string	选填	否	自定义落地页URL	选择落地页下载方式时的自定义落地页URL，仅在提升应用活跃和提升应用安装下生效，site_id 优先级高于此字段，白名单功能
use_app_market	int	选填	是	优先从系统应用商店下载	下载模式：允许值：0，1；1：先从系统应用商店下载使用，默认 0。仅提升应用安装计划类型且选择的 app 为安卓才支持。
app_store	string[]	选填	是	应用商店列表	只支持计划类型为 2 且应用是 Android 类型的推广
show_mode	int	选填	否	创意展现方式	1 - 轮播；2 - 优选（默认）
site_type	int	选填	否	预约快手广告	1 - IOS预约；2 - ANDROID 预约；【仅在计划类型为收集营销线索，web_uri_type = 2 时生效】
smart_cover	boolean	unit_type=7 选填	否	程序化创意 2.0 智能抽帧	是否开启智能抽帧
asset_mining	boolean	unit_type=7 选填	是	程序化创意 2.0 素材挖掘	是否开启历史素材挖掘
consult_id	long	选填:从工具-获取可选咨询组件	否	咨询组件 id	1、仅可被用于线索类计划下的 unit；2、仅当落地页使用了建站落地页或者建站程序化落地页时可使用；3、注意本字段不可被更新；4、本属性不可与附加表单组件(component_id)同时使用；通过「/rest/openapi/v2/lp/consult/list」接口获取
adv_card_option	int	选填	是	高级创意开关	0：关闭；1:开启；
adv_card_list	long[]	选填	是	绑定卡片 id	card_type=100 为 1 个；card_type=101 为 3 个；card_type=102 为 3 个；card_type=103 为 1 个
playable_id	Long	选填	是	试玩 ID	可选字段，开启试玩时存在，否则不存在。当用户上传试玩素材成功时返回，用于之后对于快手广告组中试玩创意的编辑操作。通过接口「 /rest/openapi/gw/dsp/v1/playable/list 」获取
play_button	String	选填	是	试玩按钮文字内容	开启试玩时存在，否则不存在，示例按钮内容如下：1：立即试玩；2：试玩一下；3：立即体验；4：免装试玩；5：免装体验。启用试玩时：默认“立即试玩”，未启用试玩时：内容为空。通过接口「/rest/openapi/gw/dsp/v1/playable/play_buttons」获取
dpa_unit_param	struct	选填	否	DPA 相关商品信息	当计划类型为商品库推广时必填。
jingle_bell_id	long	选填	否	小铃铛组件id	计划 campaignType=16 粉丝直播推广时必填写
live_user_id	long	选填	否	主播id	计划 campaignType=16 粉丝直播推广时必填写
conversion_type	int	选填	否	转化途径	计划 campaignType=16 粉丝直播推广时必填写 6
extend_search	int	选填	是	快手搜索广告智能扩词开启状态	0：关闭，1：开启；为空则为不修改
custom_mini_app_data	struct	选填	否	推广小程序营销目标小程序信息	计划 campaignType=19 推广快手小程序时必填，具体见下方表格。具体见下方表格
target	struct	必填	是	定向数据	具体见下方表格
template_id	long	选填	是	定向模板 id	此字段关联到定向信息后，target 字段失效。会将关联的定向信息填充到快手广告组中。
quick_search	int	选填	是	搜索快投开关	0：不开启（默认填充）；1：开启搜索快投
target_explore	int	选填	是	搜索人群探索	0：不开启；1：开启；开启后系统将基于用户搜索行为探索定向人群以外的更多优质人群，仅在 quick_search = 1时生效；
negative_word_param	struct	选填	是	搜索否词	更新否词可填，不更新设置为null
package_id	long	选填	否	应用包ID	新版应用中心，应用包ID；使用新版应用，该字段必填，老版本非必填
series_pay_template_id	long	选填	是	短剧付费模板id	仅在计划 campaignType=30快手号-短剧推广时支持使用，需要跟付费模式一起使用
series_pay_mode	int	选填	是	短剧付费模式	仅在计划 campaignType=30快手号-短剧推广时，需要跟付费模板一起使用，1-打包，2-虚拟币
u_link	String	选填	是	Universal Link 链接	仅在计划 campaignType=7 提升应用活跃时使用，输入后IOS将优先调起该链接，不超过2000字符

快手广告平台凭借其强大的用户基础、精准的定向能力和创新的广告形式，成为广告主们青睐的平台。它不仅能够快速触达目标受众，还能有效提升品牌知名度和用户转化率。在未来，随着5G技术的普及和AI技术的发展，快手广告平台将进一步优化用户体验，提升广告效果。同时，平台还将不断创新，推出更多元化、个性化的广告产品，满足快手广告主不断变化的需求。因此，对于寻求高效营销效果的广告主来说，快手广告平台无疑是一个值得信赖的选择。

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

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