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

请求接口：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