获取快手信息流广告组信息
请求接口：https://ad.e.kuaishou.com/rest/openapi/v1/ad_unit/list
请求方式：GET/POST
数据格式：JSON
请求参数
| 字段 | 类型 | 是否必填 | 说明 | 备注 |
|---|---|---|---|---|
| advertiser_id | long | 必填 | 快手短视频广告主ID | 在获取access_token的时候返回 |
| campaign_id | long | 可选 | 快手信息流广告计划ID | 过滤筛选条件，若不传或传空则视为无限制条件 |
| campaign_type | int | 可选 | 快手短视频广告计划类型 | 过滤筛选条件；2 - 提升应用安装;3 - 获取电商下单;4 - 推广品牌活动;5 - 收集销售线索; |
| unit_id | long | 可选 | 快手信息流广告组ID | 过滤筛选条件，若不传或传空则视为无限制条件 |
| unit_name | string | 可选 | 快手APP短视频广告组名称 | 过滤筛选条件，支持模糊搜索&精确查询 |
| unit_ids | long[] | 可选 | 快手广告组ID集 | 不超过100个 |
| status | int | 可选 | 快手广告组状态 | 过滤筛选条件；-1：不限，1：计划已暂停，3：计划超预算，6：余额不足，11：审核中，12：审核未通过，14：已结束，15：已暂停，17：组超预算，19：未达投放时间，20：有效-2，22：不在投放时段。所有包含已删除10：只包含已删除不传：所有不包含已删除 其他值无效 |
| app_name | string | 可选 | 应用名称 | 过滤筛选条件，支持模糊搜索 |
| 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 |
返回参数
| 字段 | 类型 | 说明 | 备注 |
|---|---|---|---|
| code | int | 返回码 | |
| message | string | 返回信息 | |
| data | struct | JSON返回值 | |
| details | struct | 返回值详情 | |
| campaign_id | long | 快手广告计划ID | |
| unit_id | long | 快手广告组ID | |
| unit_name | string | 快手广告组名称 | |
| status | int | 快手广告组状态（优先看看这个状态，计算结果） | -1：不限，1：计划已暂停，3：计划超预算，6：余额不足，，11：审核中，12：审核未通过，14：已结束，15：已暂停，17：组超预算，19：未达投放时间，20：有效 |
| put_status | int | 投放状态（操作结果） | 1：投放中；2：暂停 3：删除 |
| create_channel | int | 创建渠道 | 0：快手推广后台创建；1：Marketing API创建 |
| 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出价 | 单位：厘 |
| smart_bid | int | 优先低成本是否自动出价 | 0：手动出价，1：自动出价 |
| ocpx_action_type | int | 优化目标 | 0：未知，2：点击转化链接，10：曝光，11：点击，31：下载完成，53：提交线索，109：电话卡激活，137：量房，180：激活，190: 付费，191：首日ROI，348：有效线索，383: 授信，384: 完件 715：微信复制;739:7日付费次数 |
| deep_conversion_type | int | 深度转化目标 | 3: 付费，7: 次日留存，10: 完件, 11: 授信 ，0：无 |
| deep_conversion_bid | long | 深度转化目标出价 | 白名单功能，单位：厘 |
| day_budget | long | 单日预算 | 单位：厘 |
| day_budget_schedule | long[] | 分日预算 | 单位：厘，单日预算和分日预算同时存在时，以分日预算为准 |
| roi_ratio | double | 付费ROI系数 | 优化目标为「首日ROI」时必填：ROI系数取值范围 ( 0,100 ] 最多支持到三位小数（如：0.066） |
| speed | int | 投放方式 | 0：未知，1：正常投放，2：平滑投放，3：优先低成本。 |
| 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 |
| scene_id | int[] | 快手广告位 | 1：快手优选广告位；2：按场景选择广告位-快手信息流广告（旧广告位，包含上下滑大屏广告）；3：快手视频播放页广告-便利贴广告；6：快手上下滑大屏广告；7：快手信息流广告（不包含快手上下滑大屏广告）10：激励视频；11：快看点场景 |
| show_mode | int | 创意展现方式 | 0：未知，1：轮播，2：优选 |
| unit_type | int | 创意制作方式 | 4: 自定义；5：程序化创意 7：程序化创意2.0 |
| convert_id | int | 转化目标 | |
| use_app_market | int | 优先从系统应用商店下载 | 0：未设置 1：优先从系统应用商店下载使用 |
| app_store | string[] | 应用商店列表 | |
| 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 |
| schema_uri | string | 调起链接 | 提升应用活跃营销目标的调起链接 |
| app_id | long | 应用ID | |
| app_icon_url | string | APP图标存储地址 | |
| diverse_data | struct | 应用信息 | 详情见下方 |
| total_count | int | 数据总数 | |
| target | struct | 定向数据 | 详情见下方 |
| site_type | int | 快手预约广告 | 1:IOS预约 缺省为不传或传0 |
| gift_data | struct | 游戏礼包码（见下） | 联盟广告暂不支持 |
| video_landing_page | Boolean | 是否使用落地页前置功能 | true: 使用 false：不使用 |
| auto_target | boolean | 智能定向 | 若开启智能定向，定向部分仅保留地域+年龄+性别+排除人群+系统纬度的定向，其他定向纬度暂不支持（报错处理）true表示开启，false表示未开启 |
| smart_cover | boolean | 程序化创意2.0智能抽帧 | 是否开启智能抽帧 |
| asset_mining | boolean | 程序化创意2.0素材挖掘 | 是否开启历史素材挖掘 |
| auto_create_photo | boolean | 是否开启自动生成视频 | |
| update_time | string | 最后修改时间 | 格式样例："2019-06-11 15:17:25" |
| item_id | long | 电商关联Id (小店通) | 1. merchantItemType为0时表示小店商品id; 2. merchantItemType为2时表示快手id |
| fiction_id | long | 小说ID | 仅支持“提升应用安装”、“收集销售线索”以及“提高应用活跃”三种计划类型，且一旦绑定，不可修改。此参数仅是绑定小说，并非自动关联小说生成的落地页，如需推广小说生成的落地页，请使用小说ID获取其生成的建站落地页后将落地页ID一并传入即可（落地页ID传参与之前建站落地页ID字段一致） |
| merchant_item_put_type | int | 电商广告投放类型（小店通） | 0: 商品; 2: 个人主页 |
| consult_id | long | 是否使用了咨询组件 | 0=未使用，1=使用；注，咨询组件仅在收集销售线索计划(campaign_type=5)下可用，且使用了咨询组件后，可用的行动号召按钮限于接口返回内容 |
| adv_card_option | int | 高级创意开关 | 0：关闭 1:开启 |
| adv_card_list | struct[] | 高级创意列表 | |
| adv_card_id | long | 卡片id | |
| card_type | int | 卡片类型 | 100:图片卡片 101:多利益卡-图文 102：多利益卡-多标签 103：电商促销样式 |
| url | string | 图片url | |
| title | string | 标题 | |
| sub_title | string | 副标题 | |
| price | int | 原价格(单位：分) | |
| sale_price | int | 售卖价(单位：分) | |
| backflow_forecast | json | {"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：回流首日预估ROI |
| merchandise_id | long | 商品ID，且一旦绑定，不可修改 | 此参数用于绑定商品（绑定商品类型受merchandise_type字段控制），与 fiction_id 字段互斥。merchandise_type=2，merchandise_id 为课程ID，仅支持“收集销售线索”计划类型，且一旦绑定不可修改 |
| merchandise_type | int | 课程类型 | 与 merchandise_id 共同使用，merchandise_type=2，merchandise_id 为课程ID，仅支持“收集销售线索”计划类型，且一旦绑定不可修改 |
| playable_orientation | int | 试玩素材的横竖适配 | 默认值为-1；0:横竖均可；1:竖屏；2:横屏 |
| playable_url | string | 试玩的url | |
| playable_file_name | string | 快手试玩广告的文件名 | |
| playable_switch | int | 快手试玩广告的开关 | 默认值为0；1:关闭；2:开启 |
| playable_id | Long | 试玩 ID | 可选字段，开启试玩时存在，否则不存在。当用户上传试玩素材成功时返回，用于之后对于广告组中试玩创意的编辑操作。 |
| play_button | String | 试玩按钮文字内容 | 开启试玩时存在，否则不存在，示例按钮内容如下：1：立即试玩；2：试玩一下；3：立即体验；4：免装试玩；5：免装体验。启用试玩时：默认“立即试玩”，未启用试玩时：内容为空。 |
| splash_ad_switch | boolean | 是否投放快手开屏广告位 | true:投放，false：不投放 |
| library_id | int | 商品库ID | sdpa类型广告组才会存在 |
| outer_id | String | 商品ID | 快手sdpa类型广告组才会存在 |
| product_name | String | 商品名称 | 快手sdpa类型广告组才会存在 |
| product_price | Double | 商品价格 | 单位：元，快手sdpa类型广告组才会存在 |
| product_image | String | 商品主图 | 快手sdpa类型广告组才会存在 |
| intention_target | boolean | 行为意向-系统优选 | 行为意向是否开启系统优选，智能定向和行为意向系统优选不能同时开启 |
江苏新沂快手广告投放联系电话是多少?快手推广步骤，江苏武进快手广告投放的区域代理/江苏快手在哪开户，江苏吴江快手广告成本高怎么办？快手信息流怎么投放，江苏如皋快手广告投放有几种形式？快手广告投放策略，江苏东台快手推广一般一个月要花多少钱？江苏快手开户，江苏江都快手广告有哪些类型/江苏快手广告开户平台，江苏兴化投放快手广告需要注意什么/江苏快手广告费用，浙江萧山快手广告投放案例/浙江快手广告投放流程，浙江临安如何在快手投放广告/浙江快手广告开户费用，浙江瑞安APP类能上快手广告吗/浙江快手广告代理平台，浙江桐乡快手视频广告计费模式/快手广告成本高怎么办，浙江兰溪快手广告怎么投效果好/快手广告账户如何起量，贵州六盘水快手开户价格多少钱?六盘水快手广告怎么开户?
评论列表