1. 广告组
磁力引擎
  • M-API 注册认证问题Q&A
  • M-API咨询类问题Q&A
  • 快速入门
    • 如何开通快手mapi
  • Oauth2.0授权
    • 授权流程
    • scope 权限说明
    • token管理
      • token有效期&续期
      • 获取 token
      • 刷新 token
  • 账户服务
    • 广告主
      • 获取广告账户信息
      • 获取广告账户余额信息
      • 获取广告账户流水信息
    • 账户罗盘
      • 获取罗盘绑定广告主列
      • 磁力罗盘对外 quota 腾挪接口
    • 代理商
      • 上传资质文件
      • 获取账号信息和开户资质
      • 创建或更新账户信息和开户资质
      • 创建或更新投放资质
      • 可复制账户列表
      • 复制账户
  • 广告投放
    • 账户层级
      • 账户日预算查询
      • 修改账户预算
      • 账户操作记录信息查询
    • 创编2.0(已下线)
      • 广告计划
        • 创建广告计划
        • 修改广告计划
        • 获取广告计划信息
        • 修改广告计划预算
      • 广告组
        • 创建广告组
        • 创建联盟定投广告组
        • 创建搜索广告组
        • 创建搜索快投广告组
        • 修改广告组
        • 修改联盟定投广告组
        • 修改搜索广告组
        • 修改搜索快投广告组
        • 定向人群预估查询
        • 获取广告组信息
      • 广告创意
        • 创建创意
        • 创建程序化 2.0 创意
        • 批量创建&修改创意
        • 修改创意
        • 修改程序化 2.0 创意
        • 获取广告创意信息
        • 获取程序化创意 2.0 信息
    • 创编3.0(已下线)
      • 广告创建接口
      • 广告创建接口(广告组和广告创意)
      • 广告计划更新接口
      • 广告组更新接口
      • 广告创意更新接口(程序化创意和自定义创意)
      • 广告详情接口
      • 广告计划详情接口
      • 广告组详情接口
      • 广告创意详情接口
    • 智能化创编
      • 广告计划
        • 创建广告计划
        • 修改广告计划
        • 获取广告计划信息
        • 修改广告计划状态
      • 广告组
        • 创建广告组
          POST
        • 修改广告组
          POST
        • 查询广告组
          GET
        • 修改广告组预算
          POST
        • 修改广告组状态
          POST
        • 修改广告组出价
          POST
      • 广告创意
        • 创建自定义创意
        • 创建程序化创意
        • 修改自定义创意
        • 修改程序化创意
        • 批量修改自定义创意
        • 查询自定义创意
        • 查询程序化创意
        • 修改创意状态
        • 创意体验
        • 创意标签填写建议
        • 获取程序化创意 2.0 审核信息
      • 批量获取监测链接接口
        POST
      • 监测链接批量更新接口
        POST
    • 高级创意
      • 获取高级创意列表
      • 创建高级创意接口
      • 删除高级创意接口
    • 搜索广告投放工具
      • 关键词管理
        • 获取关键词列表
        • 创建关键词
        • 修改关键词匹配方式
        • 修改关键词投放状态
        • 批量导出关键词
        • 获取关键词导出文件
      • 否定词管理
        • 获取否定词列表
        • 更新否定词
  • 数据报表
    • 异步任务数据报表
      • 创建历史数据查询任务
      • 获取任务状态
      • 数据下载
    • 直播报表
      • 报表新增直播数据
      • 直播间组件报表
      • 直播间报表
    • 获取原生效果数据整体概览接口(数据概览、分日转化数据分布、转化漏斗)
    • 原生效果数据报表明细接口
    • 查询原生快手号列表(for原生报表)
    • 代理商数据(t-1 数据需要第二天 9 点以后获取)
    • 广告主数据(实时)
    • 广告计划数据(实时)
    • 广告组数据
    • 广告创意数据-自定义
    • 程序化创意 2.0 数据
    • 素材报表
    • 人群分析报表
    • 小店通转化数据报表
    • 程序化落地页报表
    • 获取商品库报表
    • 关键词报表
    • 搜索词报表
    • 探索工具关键报表数据
  • 素材管理
    • 图片素材
      • 上传图片 v1 接口【逐步废弃,请使用V2接口】
      • 上传图片 v2 接口
      • 查询图片信息 get 接口
      • 查询图片接口 list 接口
      • 图片库推送
      • 获取可选的封面贴纸样式
    • 视频素材
      • 上传视频接口 v1【逐步废弃,请使用V2接口】
      • 上传视频接口 v2
      • 获取视频信息 get 接口(可通过 photo_ids 查询所有视频)
      • 获取视频信息 list 接口推荐使用,仅能查询平台&MAPI 上传,可查 uid 下所有非素造视频)
      • 批量删除视频
      • 上传图文视频
    • 视频库
      • 视频库-推送视频
      • 视频库-推送视频(新版)
      • 视频库-批量更新视频功能
      • 视频库-删除视频标签
      • 视频关联创意数查询
    • 文件上传
      • 图文音频文件MAPI上传
  • 素造平台
    • 获取素造视频接口
  • 建站管理
    • 魔力建站落地页信息查询接口
    • 魔力建站落地页批量创建接口
    • 魔力建站落地页更新CID信息
    • 魔力建站营销组件-表单查询接口
    • 魔力建站预约下载信息查询接口
    • 魔力建站落地页组信息查询接口
    • 魔力建站落地页组创建接口
    • 魔力建站落地页组更新接口
    • 魔力建站落地页组删除接口
    • 魔力建站落地页投放开关接口
  • 线索管理-老铁线索通
    • 线索通-批量创建微信小游戏
    • 线索通-获取微信小游戏列表
    • 线索 crm 信息查询接口
    • 线索 crm 意向度/进度/通话状态更新接口
    • 发起外呼接口
    • 获取通话记录
    • 线索crm赔付线索回传接口
  • DMP人群管理
    • 文件上传接口(新)
    • 人群包创建接口(新)
    • 人群包更新接口(新)
    • 人群列表查询接口
    • 人群包删除接口
    • 人群包跨账户推送
    • 人群包上线接口
    • 系统推荐定向/排除人群包
  • 联合建模
    • 样本文件上传
    • 通过上传方式新建样本
  • 工具
    • 短句
      • 通过快手号id查询授权短剧接口
      • 通过短剧id查询剧集列表
      • 获取授权的短剧作者列表
    • 查询工具
      • 创意相关
        • 获取创意推荐理由
      • 获取可选的深度优化目标
      • 获取可选的浅度优化目标
      • 获取可选的定向标签
      • 获取可选的应用定向
      • 获取可选的推荐封面
      • 获取可选的动态词包
      • 获取行动号召按钮
      • 获取可选的封面贴纸样式
      • 获取可用的转化目标
      • 获取可选白名单接口
      • 获取地域定向
      • 获取商圈地域定向
      • 获取可用咨询组件列表
      • MAPI Quota 白盒化
      • 获取创意分类查询接口
      • 快手网红-网红分类
      • 种子人群包列表
      • 快手网红-搜索快手网红
    • 功能名单
      • 获取创意分类标签白名单客户
      • 获取联盟投放白名单
    • 评论管理
      • 评论列表数据查询
      • 回复评论
      • 评论树查询
      • 屏蔽评论
      • 增加屏蔽评论信息
      • 删除屏蔽评论信息
      • 获取屏蔽评论信息列表
      • 评论管理-评论置顶
      • 评论管理-取消评论置顶
    • 应用列表
      • 获取应用列表
      • 应用权限信息列表接口
    • 行为兴趣标签-创意层级
      • 获取行为与兴趣"类目"
      • 获取行为兴趣"关键词"
    • 定向模板(新)
      • 创建定向模板
      • 更新定向模板
      • 查询定向模板
      • 删除定向模板
      • 定向模板同步
      • 模板同步失败查询
      • 查询模板关联的广告列表接口
      • 查询待升级模板列表
      • 模板升级
    • 小说库
      • 获取小说列表
      • 获取小说详情
      • 获取小说各分类枚举
      • 创建小说
      • 小说批量更新
      • 小说批量删除
      • 批量下载小说图片接口
      • 小说报表
      • 小说批量分享
    • 联盟自定义媒体包
      • 联盟定向媒体包创建
      • 联盟定向媒体包修改
      • 联盟定向媒体包删除
      • 获取联盟定向媒体包列表
      • 联盟定向媒体包广告位报表
    • 游戏试玩
      • 上传试玩素材
      • 直存试玩
      • 获取试玩按钮列表
      • 获取试玩列表
      • 试玩推送
      • 查看共享账户
    • 商品库
      • 商品库各行业商品数据校验规则
      • 查询 DPA 模板信息
      • 获取商品库列表
      • 获取商品库类目树
      • 创建商品
      • 更新商品
      • 获取商品列表
      • 获取商品列表(部分信息)
      • 获取商品列表(游标)
      • 获取SDPA创意视频模板
      • 批量模板合成SDPA创意视频
    • 出价建议
      • 批量获取广告组出价建议
      • 获取广告组曝光、转化预估
      • 获取广告组投放预估曲线
    • 直播推广
      • 获取主播列表
      • 获取直播间小铃铛列表
    • 探索工具
      • 一键复苏开启
      • 一键复苏关闭
      • 加速探索-开启接口
      • 加速探索关闭
      • 辅助探索开启
      • 探索工具状态查询
      • 探索工具报表
      • 探索工具使用记录
      • 探索工具关键报表数据
    • 智能托管
      • 枚举说明
      • 智能托管创建及更新接口
      • 智能托管状态更新
      • 智能托管删除接口
      • 获取智能托管详情接口
      • 获取智能托管物料接口
      • 智能托管报表接口
      • 分小说展开效果数据接口
    • 投前预估
      • 创建投前预估任务
      • 投前预估详情
      • 投前预估列表
      • 投前预估任务管理
    • 原生广告投放工具
      • 隐藏视频同步至个人主页
      • 获取快手号授权列表
      • 快手号授权接口
      • 获取达人原生视频列表接口
      • 共享授权接口
      • 共享授权结果
      • 共享授权-获取已共享授权授权记录
      • 获取原生快手号列表接口
      • 本地视频上传接口
  • 频控和创建限制
    • 频控和创建限制
    • 接口调用分级使用
  • 磁力聚星
    • 投后数据
      • 星视频--查询订单的投后数据
      • 星任务(视频)-查询任务的投后数据
      • 星任务(视频)-查询订单的投后数据
  • 转化归因
    • 转化归因信息合辑
      • 转化归因信息合辑
  • 应用管理
    • 接入前言
    • 文件上传【必选】
      • 【应用中心】上传 APK 文件
      • 【应用中心】上传图片
    • 应用创编【必选】
      • 【应用中心】创建 Android 应用
      • 【应用中心】创建 iOS 应用
      • 【应用中心】编辑 Android 应用
      • 【应用中心】更新 iOS 应用
    • 应用查询For单元投放【必选】
      • 获取新版应用发布列表【单元创编】
      • 获取新版分包发布列表【单元创编】
    • 应用查询For应用中心【可选】
      • 【应用中心】获取应用列表
      • 【应用中心】获取应用详情
    • 应用共享【可选】
      • 【应用中心】添加应用共享
      • 【应用中心】取消应用共享
      • 【应用中心】获取应用已共享账号列表
      • 【应用中心】获取应用已共享主体列表
      • 【应用中心】获取单个主体下共享账号列表
      • 【应用中心】获取可共享的主体列表
      • 【应用中心】获取可共享的账号列表
    • 应用操作【可选】
      • 【应用中心】iOS 应用上报更新
      • 【应用中心】发布应用
      • 【应用中心】应用上架
      • 【应用中心】应用下架
      • 【应用中心】应用商店上下架
    • 应用分包【可选】
      • 【应用中心】新建应用分包
      • 【应用中心】更新/恢复/删除应用分包
      • 【应用中心】修改应用分包备注
      • 【应用中心】获取分包管理/回收站列表
      • 【应用中心】分包失败,重新构建
    • 其他接口【可选】
      • 【应用中心】获取应用尚未发布的最新的应用包信息
      • 【应用中心】获取应用版本记录
      • 获取新版应用发布详情
      • 人群包数据
  • 附录
    • 3.0创编接口改动
    • 报错 code 枚举值
  1. 广告组

查询广告组

开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
GET
https://ad.e.kuaishou.com/rest/openapi/gw/dsp/unit/list

请求参数#

字段类型是否必填说明备注
advertiser_idlong必填广告主 ID在获取 access_token 的时候返回
campaign_idlong选填广告计划 ID过滤筛选条件,若不传或传空则视为无限制条件
unit_idlong选填广告组 ID过滤筛选条件,若不传或传空则视为无限制条件
unit_namestring选填广告组名称过滤筛选条件,支持模糊搜索&精确查询
unit_idslong[]选填广告组 ID 集不超过 100 个
statusint选填广告组状态过滤筛选条件;-2:不限(已删除);10:广告组已删除;40:广告创意已删除.所有不包含已删除 其他值无效
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选填请求的页码数默认为 1
page_sizeint选填请求的每页行数默认为 20
review_status_listint[]选填单元审核状态筛选1:待审核;2:审核通过;3:审核失败;7:待送审
put_status_listint[]选填单元投放状态筛选1:投放;2:暂停;3:删除

返回参数#

字段类型说明备注
campaign_idlong广告计划 ID
unit_idlong广告组 ID
unit_namestring广告组名称
put_statusint投放状态(操作结果)1:投放中;2:暂停 3:删除
statusint广告组状态(优先看看这个状态,计算结果)-1:不限,1:计划已暂停,3:计划超预算,6:余额不足,,11:审核中,12:审核未通过,14:已结束,15:已暂停,17:组超预算,19:未达投放时间,20:有效,22:不在投放时段
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:eCPC
bidlong出价单位:厘
cpa_bidlongOCPC 出价单位:厘
ocpx_action_typeint优化目标0:未知,2:点击转化链接,10:曝光,11:点击,31:下载完成,53:提交线索,109:电话卡激活,137:量房,180:激活,190: 付费,191:首日 ROI,348:有效线索,383: 授信,384: 完件 715:微信复制;739:7 日付费次数;774:7 日ROI;810:激活付费
deep_conversion_typeint深度转化目标3:付费,7:次日留存,10:完件, 11:授信;13:添加购物车;14:提交订单;15:购买;44:有效线索;92:付费 roi;181:激活后24H次日留存;0:无;
deep_conversion_bidlong深度转化目标出价白名单功能,单位:厘
enhance_conversion_typeint增强目标
roi_ratiodouble付费 ROI 系数优化目标为「首日 ROI」时必填:ROI 系数取值范围 ( 0,100 ] 最多支持到三位小数(如:0.066)
scene_idint[]广告位1:优选广告位;2:按场景选择广告位-信息流广告(旧广告位,包含上下滑大屏广告)6:上下滑大屏广告;7:信息流广告(不包含上下滑大屏广告)24:激励视频;11:快看点场景
unit_typeint创意制作方式3:DPA 自定义创意(仅在计划类型为商品库推广下使用) 4: 常规自定义创意; 7:程序化创意 2.0
begin_timestring投放开始时间格式:yyyy-MM-dd
end_timestring投放结束时间格式:yyyy-MM-dd,排期不限为 null
schedulestruct投放时段不投放的时段为 null,详请见下方,历史字段,即将废弃
schedule_timestring投放时段24*7 的字符串,0 为不投放,1 为投放,例如:0010000000001....0000
day_budgetlong单日预算单位:厘
day_budget_schedulelong[]分日预算单位:厘,单日预算和分日预算同时存在时,以分日预算为准,优先级高于day_budget
convert_idint转化目标
url_typeinturl 类型当计划类型为 3 时(获取电商下单)时有返回。1:淘宝商品短链 2:淘宝商品 itemID
web_uri_typeinturl 类型当计划类型为 5(收集销售线索)&使用建站时有返回:需使用魔力建站 不传默认 1,2:落地页
urlstring落地页链接计划类型是 2(提升应用安装):返回应用下载地址;计划类型是 3(获取电商下单):根据 url_type 返回相应信息;计划类型是 4(推广品牌活动):返回落地页 url 计划类型是 5(收集销售线索):返回落地页 url 计划类型是 5(收集销售线索):建站 idl
site_idlong建站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_detailstruct程序化落地页信息广告组ID绑定的程序化落地页组信息
schema_uristring调起链接提升应用活跃营销目标的调起链接
schema_idString微信小程序外部调起链接目前只有收集营销线索计划下的联盟广告位该字段才有效
app_idlong应用 ID
app_download_typeint应用下载方式0:直接下载1:落地页下载(仅在提升应用安装计划下生效)
download_page_urlstring自定义落地页URL选择落地页下载方式时的自定义落地页URL,仅在提升应用活跃和提升应用安装下生效,site_id 优先级高于此字段,白名单功能
use_app_marketint优先从系统应用商店下载0:未设置 1:优先从系统应用商店下载使用
app_storestring[]应用商店列表
diverse_datastruct应用信息详情见下方
show_modeint创意展现方式0:未知,1:轮播,2:优选
site_typeint预约广告1:IOS 预约 缺省为不传或传 0
smart_coverboolean程序化创意 2.0 智能抽帧是否开启智能抽帧
asset_miningboolean程序化创意 2.0 素材挖掘是否开启历史素材挖掘
consult_idlong是否使用了咨询组件0=未使用,1=使用;注,咨询组件仅在收集销售线索计划(campaign_type=5)下可用,且使用了咨询组件后,可用的行动号召按钮限于接口返回内容
adv_card_optionint高级创意开关0:关闭 1:开启
adv_card_liststruct[]高级创意列表
playable_idLong试玩 ID可选字段,开启试玩时存在,否则不存在。当用户上传试玩素材成功时返回,用于之后对于广告组中试玩创意的编辑操作。
play_buttonString试玩按钮文字内容开启试玩时存在,否则不存在,示例按钮内容如下:1:立即试玩;2:试玩一下;3:立即体验;4:免装试玩;5:免装体验。启用试玩时:默认“立即试玩”,未启用试玩时:内容为空。
playable_orientationint试玩素材的横竖适配默认值为-1;0:横竖均可;1:竖屏;2:横屏
playable_file_namestring试玩广告的文件名
dpa_unit_sub_typeint商品广告类型:1-DPA,2-SDPA,3-动态商品卡
library_idint商品库ID
outer_idString商品第三方ID
dpa_outer_idsString[]DPA商品ID集合
dpa_category_idsString[]DPA商品类目集合
product_nameString商品名称
product_priceDouble商品价格单位:元
product_imageString商品主图
jingle_bell_idlong小铃铛组件id
live_user_idlong粉丝直播推广时,为主播id、 短剧推广时为短剧作者id
extend_searchboolean智能扩词开启状态false:关闭,true:开启
custom_mini_app_datastruct推广小程序营销目标小程序信息推广快手小程序时必填,具体见下方表格。
targetstruct定向数据详情见下方
template_idlong定向模板ID
outer_loop_nativeint是否开启原生0关闭,1开启,不填默认为0仅在计划 campaignType=2提升应用安装、5收集销售线索、7提升应用活跃、19推广快手小程序时,可开启原生投放。
quick_searchint是否开启快投0:关闭、1:开启
target_exploreint是否开启搜索人群探索0:关闭、1:开启
negative_word_paramStruct搜索广告否词搜索广告新增
backflow_forecastStruct回流预估信息回流预估信息
ad_typeint广告计划类型0:信息流,1:搜索
unit_sourceint广告组来源0:常规(非托管)、1:托管
update_timestring最后修改时间格式样例:"2019-06-11 15:17:25"
package_idlong新版应用中心:应用包ID
series_idlong短剧id
episode_idlong短剧下剧集id
series_card_typeint是否使用短剧卡片0关闭,1开启
series_card_infostruct短剧卡片信息具体见下方表格

schedule#

字段类型说明备注
monint[]周一时间段时间段范围0, 23
tuesint[]周二时间段时间段范围0, 23
wedint[]周三时间段时间段范围0, 23
thurint[]周四时间段时间段范围0, 23
friint[]周五时间段时间段范围0, 23
satint[]周六时间段时间段范围0, 23
sunint[]周日时间段时间段范围0, 23

diverse_data#

字段类型说明备注
app_namestring应用名称
app_package_namestring应用包名
device_os_typeint应用操作系统类型0:未知,1:ANDROID,2:IO

target#

字段类型说明备注
regionlong[]地域传值为[]表示不限;传递上一级 ID 时,childrenID 可以不传;不允许同时传 parentID 和 childrenID;地域信息可通过地域接口获取;仅计划的 campaign_type 为 5 时,支持设置三级地域(例:山西-大同-左云,左云是三级地域)
district_idslong[]商圈定向与 region 字段不能同时传、白名单控制,最多选 100 个。可以通过/rest/openapi/v1/region/district/list 接口获取商圈信息。该定向仅支持快手站内广告位,不支持联盟广告位。
user_typeint用户类型0:实时;1:常驻;2:不限
agestruct自定义年龄段不传值表示不限,传值具体见下方表格;与 ages_range 不能同时传
ages_rangeint[]固定年龄段与 age 不能同时传;【18:表示 18-23 岁】;【24:表示 24-30 岁】;【31:表示 31-40 岁】;【41:表示 41-49 岁】;【50:表示 50-100 岁】
genderint性别1:女性, 2:男性,0 表示不限
platform_osint操作系统1:Android,2:iOS,0 表示不限;当计划类型为 2(提升应用安装)时该字段可忽略
android_osvintAndroid 版本3:不限,4:4.x+,5:5.x+,6:6.x+,7:7.x+,8:8.x+,9:9.x+,10:10.x+;当计划营销目标类型为 2(提升应用安装)、7(提升应用活跃)时,仅当 app_id 表示的是 Android 应用可使用此字段传递版本
ios_osvintiOS 版本6:不限,7:7.x+,8:8.x+,9:9.x+,10:10.x+;11:11.x+;12:12.x+;13:13.x+;14:14.x+;15:15.x+;16:16.x+;当计划营销目标类型为 2(提升应用安装)、7(提升应用活跃)时,仅当 appId 表示的是 iOS 应用可使用此字段传递版本
networkint网络环境1:Wi-Fi,2:移动网络,0:表示不限
device_brand_idslong[]设备品牌ID列表传值为[]表示不限;当 platform为iOS定向时,没有设备品牌定向;1:苹果(platform字段为空时可选);2:VIVO;3:OPPO;4:华为;5:小米;6:荣耀;7:三星;8:魅族;9:金立;10:HTC;11:联想;12:酷派;13:酷比;14:中兴;15:乐视;16:LG;17:中国移动;18:360;19:百度;20:努比亚;21:一加;22:海信;23:朵唯;24:美图;25:锤子;26:谷歌;27:小辣椒;28:诺基亚;29:康佳
device_priceint[]设备价格1:1500 元以下(11:1000元以下,12:10011500),2:15012000,3:20012500,4:25013000,5:30013500,6:35014000,7:40014500(13:40015000),8:45015000(13:40015000),9:50015500(14:50016000),10:5500 元以上(15:6000元以上)
app_interest_idslong[]APP 行为-按分类id 不能重复且必须准确,具体 id 可通过下方标签接口获取;仅包含安卓数据,若操作系统定向 IOS 则无效;不能同时选择 app_ids(新标签体系字段,替换 app_interest,与 app_interest 同时传递,app_interest 字段失效)。该定向仅支持快手站内广告位,不支持联盟广告位。
app_idslong[]APP 行为-按 APP 名称id 不能重复且必须准确,具体 id 可通过下方应用接口获取,建议不超过 10 个,否则可能出现报错;仅包含安卓数据,若操作系统定向 IOS 则无效;不能同时选择 app_interest。该定向仅支持快手站内广告位,不支持联盟广告位。
filter_converted_levelint过滤已转化人群纬度搜索广告、联盟广告、小店通不支持。优化目标不支持【封面曝光数】和【封面点击数】非应用下载类推广不支持过滤【APP】纬度。0(默认):不限;1:广告组 2:广告计划;3:本账户;4:公司主体;5:APP;6:运营自定义产品名
populationlong[]人群包定向/rest/openapi/v1/dmp/population/list 获取人群包 id。population 不能重复,与 exclude_population 不能有交集,不能传付费人群包,付费人群包标识字段:population_type=7
exclude_populationlong[]人群包排除/rest/openapi/v1/dmp/population/list 获取人群包 id。exclude_population 不能重复,不能传付费人群包,付费人群包标识字段:population_type=7
paid_audiencelong[]付费人群包 id/rest/openapi/v1/dmp/population/list 获取人群包 id。1、不能重复,只能传付费人群包,且 third_platform_code 要一样,2、如果传了【population 或 exclude_population】,报错;修改时要也要保证【population 或 exclude_population】不能同时传。3、创建时若已经有了【population 或 exclude_population】修改时只传 paid_audience 也会报错,这时需要把 population 或 exclude_population】设为[]才行,反之也一样。总之,【population 或 exclude_population】与【paid_audience】不能同时存在。该定向仅支持快手站内广告位,不支持联盟广告位。
seed_populationlong[]种子人群包当账户开通种子人群包功能后方可使用此功能。该定向仅支持快手站内广告位,不支持联盟广告位。
intelli_extend_optionint智能定向开关0:智能定向关闭;1:智能定向开启【计划层级开启智能调控时,只能传1】;当计划层级开启了自动调控功能,不传默认智能定向开启状态,其他清空默认智能定向关闭。
behavior_typeint行为兴趣类型0:默认;1:自定义行为意向;2:行为意向系统优选。联盟广告位不支持后者。
behavior_intereststruct行为兴趣定向behavior.keyword 、behavior.label、interest.lable 其中一个必传,具体传值下方表格;仅在 behavior_type = 1 时生效
disable_installed_app_switchint过滤已安装人群维度0:过滤(默认),1:不限
filter_time_rangeint用户的转化时间范围0:30天;1:60天;2:90天。该定向仅支持快手站内广告位,不支持联盟广告位。
celebritystruct快手网红behaviors、fans_star两个字段必填充。该定向仅支持快手站内广告位,不支持联盟广告位。
medialong[]媒体定向包
exclude_medialong[]媒体定向排除包
media_source_typeint媒体包来源默认为 0,0-不限,未指定,1-行业优质流量包,2-广告主自定义
ip_typeint地域IP类型白名单可用,0-默认IP、1-广协IP
auto_populationint智能人群包白名单可用,0-默认、1-智能人群包勾选。加白账户在计划层级开启智能操盘时必须为1

celebrity#

字段类型说明备注
behaviorsint[]该字段为平台对应快手网红功能中的行为类型,可多选,但不可不选,不选会导致快手网红定向失效,定义如下 0:关注、1:视频互动、2:直播互动
fans_starsfans_star[]该字段包括平台对应快手网红功能中的网红分类和快手网红两项,数据保证录入顺序,可从【快手网红-网红分类】和【快手网红-搜索快手网红】接口获取对应数据

fans_star#

字段类型说明备注
idstring如使用该功能则必填此项,该字段有两种含义 1、当是网红分类,即type=1时,该字段传入对应网红分类对应的父ID与当前ID的拼接字符串,如传入"33-177"表示一级网红分类"游戏"下的二级网红分类"沙盒游戏",如选中的是一级网红分类,则直接传入当前ID如"33" 2、当是快手网红,即type=2时,该字段传入对应快手网红的author_id,如传入"1151465119"表示快手网红小脑斧来自N次元
typeint如使用该功能则必填此项,该字段为平台对应快手网红功能中的网红分类和快手网红两项,可从【快手网红-网红分类】和【快手网红-搜索快手网红】接口获取对应数据 1:网红分类、2:快手网红
namestring如使用该功能则必填此项,该字段有两种含义 1、当是网红分类,即type=1时,该字段传入对应网红分类对应的父name与当前name的拼接字符串,如传入"游戏-沙盒游戏"表示一级网红分类"游戏"下的二级网红分类"沙盒游戏",如选中的是一级网红分类,则直接传入当前ID如"游戏",保证传入的值与传入id对应网红标签name(拼接)一致 2、当是快手网红,即type=2时,该字段传入对应快手网红的kwai_id,如传入"小脑斧来自N次元"表示快手网红小脑斧来自N次元,保证传入的值与传入id对应的快手网红的kwai_id保持一致
categoryint[]当是快手网红,即type=2时,该字段传值有效,对应当前快手网红的分类,格式为first_label_id,second_label_id,如果second_label_id不存在,则只传入first_label_id,如传入32, 241表示当前快手网红属于影视-影视分类二级网红分类

age#

字段类型说明备注
minint年龄最小限制18
maxint年龄最大限制55

behavior#

字段类型说明备注
keywordstruct[]行为定向关键词,详情见下方
labelstring[]行为定向,类目词
time_typeint在多少天内发生行为的用户0:7 天 1:15 天 2:30 天 3:90 天 4:180 天
strength_typeint行为强度0:不限 1:高强度
scene_typeint[]行为场景1:社区 2:APP 4:推广

keyword#

字段类型说明备注
idlong关键词 id
namestring关键词名称

interest#

字段类型说明备注
labelstring[]兴趣定向类目词

page_group_detail#

字段类型说明备注
group_idlong程序化落地页组ID
group_namestring程序化落地页组名称
page_review_detailstruct[]程序化落地页组下的页面信息

page_review_detail#

字段类型说明备注
page_idlong落地页ID
review_statusstring落地页审核状态1-审核中 2-审核通过 3-审核拒绝
review_detailstring落地页的审核拒绝理由
urlstring落地页URL信息

custom_mini_app_data#

字段类型是否必填说明备注
mini_app_id_platformstring选填小程序APPID计划 campaignType=19 推广快手小程序时必填,不能超过30个字符。 注:当账户加了小游戏推广白名单时,不需要填写。
bootstrap_pagestring选填小程序启动页面跳转小程序时将直接进入该页面,计划 campaignType=19 小程序推广时必填。例:page/app/index。注:当账户加了小游戏推广白名单时,必填。
bootstrap_paramsstring选填小程序启动参数启动参数可以追踪页面来源,计划 campaignType=19 小程序推广时选填。例:name=lilei&age=18。注:当账户加了小游戏推广白名单时,不需要填写。

negative_word#

字段类型说明备注
exact_wordsstring[]精确否定词搜索广告新增
phrase_wordsstring[]短语否定词搜索广告新增

backflow_forecast#

字段类型说明备注
backflow_cv_lowerInteger回流预估值的下限
backflow_cv_upperInteger回流预估值的上限
backflow_timestampLong本次回流预估数据的时间戳,13 位毫秒时间戳
backflow_paymentDouble回流预估总金额
backflow_roiDouble回流首日预估 ROI

series_card_info#

字段类型说明备注
pic_idlong短剧卡片封面
labelstring[]短剧卡片标签
descriptionstring短剧卡片简介
cover_imagestring短剧卡片封面图
titlestring短剧卡片标题

请求参数

Body 参数application/json

示例

返回响应

🟢200成功
application/json
Bodyapplication/json

请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://ad.e.kuaishou.com/rest/openapi/gw/dsp/unit/list' \
--header 'Content-Type: application/json' \
--data '{
   "advertiser_id": 20000146,
   "page":1,
   "page_size":1
}'
响应示例响应示例
{
    "code": 0,
    "data": {
        "total_count": 0,
        "details": [
            {
                "site_type": 0,
                "ad_type": 0,
                "bid_type": 0,
                "put_status": 0,
                "smart_cover": true,
                "dsp_version": 0,
                "playable_id": 0,
                "schema_id": "string",
                "unit_source": 0,
                "app_id": 0,
                "campaign_id": 0,
                "day_budget": 0,
                "ocpx_action_type": 0,
                "use_app_market": 0,
                "target_explore": 0,
                "component_id": 0,
                "create_time": "string",
                "show_mode": 0,
                "unit_name": "string",
                "quick_search": 0,
                "day_budget_schedule": [
                    "string"
                ],
                "status": 0,
                "unit_type": 0,
                "study_status": 0,
                "update_time": "string",
                "library_id": null,
                "unit_id": 0,
                "web_uri_type": 0,
                "review_detail": "string",
                "end_time": null,
                "compensate_status": 0,
                "scene_id": null,
                "begin_time": "string",
                "app_icon_url": null,
                "convert_id": 0,
                "url": "string",
                "target": {
                    "gender": null,
                    "media": [
                        "string"
                    ],
                    "device_price": [
                        "string"
                    ],
                    "media_source_type": 0,
                    "target_source": null,
                    "user_type": 0,
                    "exclude_population": [
                        "string"
                    ],
                    "device_brand_ids": [
                        "string"
                    ],
                    "ages_range": null,
                    "district_ids": null,
                    "android_osv": 0,
                    "behavior_type": 0,
                    "disable_installed_app_switch": 0,
                    "filter_converted_level": 0,
                    "population": [
                        "string"
                    ],
                    "platform_os": 0,
                    "filter_time_range": 0,
                    "device_brand": [
                        "string"
                    ],
                    "ios_osv": 0,
                    "app_interest_ids": [
                        "string"
                    ],
                    "paid_audience": [
                        "string"
                    ],
                    "intelli_extend_option": 0,
                    "region": null,
                    "exclude_media": [
                        "string"
                    ]
                },
                "schedule_time": "string",
                "cpa_bid": 0,
                "playable_orientation": 0,
                "bid": 0,
                "adv_card_option": 0
            }
        ]
    },
    "message": "string",
    "request_id": "string"
}
修改于 2023-10-24 03:46:48
上一页
修改广告组
下一页
修改广告组预算
Built with