专业从事网络营销外包代运营服务

提供广告推广代运营,网站推广,竞价托管,网站建设制作,SEM搜索引擎推广、信息流广告营销、移动短视频广告,社交媒体推广等品牌营销服务

获取快手信息流广告组信息

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

请求方式:GET/POST

数据格式:JSON

请求参数

字段类型是否必填说明备注advertiser_idlong必填快手短视频广告主ID在获取access_token的时候返回campaign_idlong可选快手信息流广告计划ID过滤筛选条件,若不传或传空则视为无限制条件campaign_typeint可选快手短视频广告计划类型过滤筛选条件;2 - 提升应用安装;3 - 获取电商下单;4 - 推广品牌活动;5 - 收集销售线索;unit_idlong可选快手信息流广告组ID过滤筛选条件,若不传或传空则视为无限制条件unit_namestring可选快手APP短视频广告组名称过滤筛选条件,支持模糊搜索&*查询unit_idslong[]可选快手广告组ID集不超过100个statusint可选快手广告组状态过滤筛选条件;-1:不限,1:计划已暂停,3:计划超预算,6:余额不足,11:审核中,12:审核未通过,14:已结束,15:已暂停,17:组超预算,19:未达投放时间,20:有效-2,22:不在投放时段。所有包含已删除10:只包含已删除不传:所有不包含已删除 其他值无效app_namestring可选应用名称过滤筛选条件,支持模糊搜索start_datestring可选开始时间与end_date同时传或同时不传;过滤筛选条件,格式为"yyyy-MM-dd",参数值对应update_time信息end_datestring可选结束时间与start_date同时传或同时不传;过滤筛选条件,格式为"yyyy-MM-dd",参数值对应update_time信息time_filter_typeint可选按创建时间或者更新时间进行筛选1.如传入此字段时不传"start_date",与"end_date"字段,则不根据时间筛选。2.传入"start_date",与"end_date"字段,且此字段为1时,按照创建时间进行筛选。3.传入"start_date",与"end_date"字段,此字段不传,或传值为0时,则按照更新时间进行筛选pageint可选请求的页码数默认为1page_sizeint可选请求的每页行数默认为20

返回参数

字段类型说明备注codeint返回码messagestring返回信息datastructJSON返回值detailsstruct返回值详情campaign_idlong快手广告计划IDunit_idlong快手广告组IDunit_namestring快手广告组名称statusint快手广告组状态(优先看看这个状态,计算结果)-1:不限,1:计划已暂停,3:计划超预算,6:余额不足,,11:审核中,12:审核未通过,14:已结束,15:已暂停,17:组超预算,19:未达投放时间,20:有效put_statusint投放状态(操作结果)1:投放中;2:暂停 3:删除create_channelint创建渠道0:快手推广后台创建;1:Marketing API创建review_detailstring审核拒绝理由study_statusint学习期1:学习中,2:学习成功,3:学习失败compensate_statusint赔付状态0=不需要赔付(不需要展示赔付标志),1=成本保障生效中,2=成本保证确认中,3=已赔付完成,4=已失效bid_typeint出价类型1:CPM,2:CPC,6:OCPC(使用OCPC代表OCPX),10:OCPM,20:eCPCbidlong出价单位:厘cpa_bidlongOCPC出价单位:厘smart_bidint优先低成本是否自动出价0:手动出价,1:自动出价ocpx_action_typeint优化目标0:未知,2:点击转化链接,10:曝光,11:点击,31:下载完成,53:提交线索,109:电话卡激活,137:量房,180:激活,190: 付费,191:首日ROI,348:有效线索,383: 授信,384: 完件 715:微信复制;739:7日付费次数deep_conversion_typeint深度转化目标3: 付费,7: 次日留存,10: 完件, 11: 授信 ,0:无deep_conversion_bidlong深度转化目标出价白名单功能,单位:厘day_budgetlong单日预算单位:厘day_budget_schedulelong[]分日预算单位:厘,单日预算和分日预算同时存在时,以分日预算为准roi_ratiodouble付费ROI系数优化目标为「首日ROI」时必填:ROI系数取值范围 ( 0,100 ] *多支持到三位小数(如:0.066)speedint投放方式0:未知,1:正常投放,2:平滑投放,3:优先低成本。begin_timestring投放开始时间格式:yyyy-MM-ddend_timestring投放结束时间格式:yyyy-MM-dd,排期不限为nullschedulestruct投放时段不投放的时段为null,详请见下方,历史字段,即将废弃schedule_timestring投放时段24*7的字符串,0为不投放,1为投放,例如:0010000000001....0000scene_idint[]快手广告位1:快手优选广告位;2:按场景选择广告位-快手信息流广告(旧广告位,包含上下滑大屏广告);3:快手视频播放页广告-便利贴广告;6:快手上下滑大屏广告;7:快手信息流广告(不包含快手上下滑大屏广告)10:激励视频;11:快看点场景show_modeint创意展现方式0:未知,1:轮播,2:优选unit_typeint创意制作方式4: 自定义;5:程序化创意 7:程序化创意2.0convert_idint转化目标use_app_marketint优先从系统应用商店下载0:未设置 1:优先从系统应用商店下载使用app_storestring[]应用商店列表url_typeinturl类型当计划类型为3时(获取电商下单)时有返回。1:淘宝商品短链 2:淘宝商品itemIDweb_uri_typeinturl类型当计划类型为5(收集销售线索)&使用建站时有返回:需使用魔力建站 不传默认1,2:落地页urlstring落地页链接计划类型是 2(提升应用安装):返回应用下载地址;计划类型是 3(获取电商下单):根据url_type返回相应信息;计划类型是 4(快手推广品牌活动):返回落地页url计划类型是 5(收集销售线索):返回落地页url计划类型是5(收集销售线索):建站idlschema_uristring调起链接提升应用活跃营销目标的调起链接app_idlong应用IDapp_icon_urlstringAPP图标存储地址diverse_datastruct应用信息详情见下方total_countint数据总数targetstruct定向数据详情见下方site_typeint快手预约广告1:IOS预约 缺省为不传或传0gift_datastruct游戏礼包码(见下)联盟广告暂不支持video_landing_pageBoolean是否使用落地页前置功能true: 使用 false:不使用auto_targetboolean智能定向若开启智能定向,定向部分仅保留地域+年龄+性别+排除人群+系统纬度的定向,其他定向纬度暂不支持(报错处理)true表示开启,false表示未开启smart_coverboolean程序化创意2.0智能抽帧是否开启智能抽帧asset_miningboolean程序化创意2.0素材挖掘是否开启历史素材挖掘auto_create_photoboolean是否开启自动生成视频update_timestring*后修改时间格式样例:"2019-06-11 15:17:25"item_idlong电商关联Id (小店通)1. merchantItemType为0时表示小店商品id; 2. merchantItemType为2时表示快手idfiction_idlong小说ID仅支持“提升应用安装”、“收集销售线索”以及“提高应用活跃”三种计划类型,且一旦绑定,不可修改。此参数仅是绑定小说,并非自动关联小说生成的落地页,如需推广小说生成的落地页,请使用小说ID获取其生成的建站落地页后将落地页ID一并传入即可(落地页ID传参与之前建站落地页ID字段一致)merchant_item_put_typeint电商广告投放类型(小店通)0: 商品; 2: 个人主页consult_idlong是否使用了咨询组件0=未使用,1=使用;注,咨询组件仅在收集销售线索计划(campaign_type=5)下可用,且使用了咨询组件后,可用的行动号召按钮限于接口返回内容adv_card_optionint*创意开关0:关闭 1:开启adv_card_liststruct[]*创意列表adv_card_idlong卡片idcard_typeint卡片类型100:图片卡片 101:多利益卡-图文 102:多利益卡-多标签 103:电商促销样式urlstring图片urltitlestring标题sub_titlestring副标题priceint原价格(单位:分)sale_priceint售卖价(单位:分)backflow_forecastjson{"backflow_cv_lower": 2,"backflow_cv_upper": 5,"backflow_timestamp": 1614134110150,"backflow_payment":100,"backflow_roi":0.33}backflow_cv_lower:回流预估值的下限;backflow_cv_upper:回流预估值的上限;backflow_timestamp:本次回流预估数据的时间戳,13位毫秒时间戳;backflow_payment:回流预估总金额;backflow_roi:回流首日预估ROImerchandise_idlong商品ID,且一旦绑定,不可修改此参数用于绑定商品(绑定商品类型受merchandise_type字段控制),与 fiction_id 字段互斥。merchandise_type=2,merchandise_id 为课程ID,仅支持“收集销售线索”计划类型,且一旦绑定不可修改merchandise_typeint课程类型与 merchandise_id 共同使用,merchandise_type=2,merchandise_id 为课程ID,仅支持“收集销售线索”计划类型,且一旦绑定不可修改playable_orientationint试玩素材的横竖适配默认值为-1;0:横竖均可;1:竖屏;2:横屏playable_urlstring试玩的urlplayable_file_namestring快手试玩广告的文件名playable_switchint快手试玩广告的开关默认值为0;1:关闭;2:开启playable_idLong试玩 ID可选字段,开启试玩时存在,否则不存在。当用户上传试玩素材成功时返回,用于之后对于广告组中试玩创意的编辑操作。play_buttonString试玩按钮文字内容开启试玩时存在,否则不存在,示例按钮内容如下:1:立即试玩;2:试玩一下;3:立即体验;4:免装试玩;5:免装体验。启用试玩时:默认“立即试玩”,未启用试玩时:内容为空。splash_ad_switchboolean是否投放快手开屏广告位true:投放,false:不投放library_idint商品库IDsdpa类型广告组才会存在outer_idString商品ID快手sdpa类型广告组才会存在product_nameString商品名称快手sdpa类型广告组才会存在product_priceDouble商品价格单位:元,快手sdpa类型广告组才会存在product_imageString商品主图快手sdpa类型广告组才会存在intention_targetboolean行为意向-系统优选行为意向是否开启系统优选,智能定向和行为意向系统优选不能同时开启


江苏新沂快手广告投放联系电话是多少?快手推广步骤,江苏武进快手广告投放的区域代理/江苏快手在哪开户,江苏吴江快手广告成本高怎么办?快手信息流怎么投放,江苏如皋快手广告投放有几种形式?快手广告投放策略,江苏东台快手推广一般一个月要花多少钱?江苏快手开户,江苏江都快手广告有哪些类型/江苏快手广告开户平台,江苏兴化投放快手广告需要注意什么/江苏快手广告费用,浙江萧山快手广告投放案例/浙江快手广告投放流程,浙江临安如何在快手投放广告/浙江快手广告开户费用,浙江瑞安APP类能上快手广告吗/浙江快手广告代理平台,浙江桐乡快手视频广告计费模式/快手广告成本高怎么办,浙江兰溪快手广告怎么投效果好/快手广告账户如何起量,贵州六盘水快手开户价格多少钱?六盘水快手广告怎么开户?

本文标题:快手广告平台:获取广告组信息《*》

本文链接:https://www.eatui.cn/xinxiliu/17869.html

小象网络是一家以提供网站推广网站建设网站优化信息流广告搜索引擎推广视频广告、软文营销发布为主的互联网营销公司。以客户需求为导向,客户利益为出发点,结合媒体渠道及行业资源优势,为客户提供从基础建设到营销推广的一整套解决方案,探索并实现客户商业价值较大化,为所有谋求长远发展的企业贡献全部力量。