Release Note
2025-07-30
广告主账户列表接口新增字段
本次更新针对广告主账户列表接，新增： - acc_type: 账号类型 - configure_status: 账户状态
2025-07-24
新增充值接口
新增充值接口，接口如下：
2025-06-10
单元接口支持调起优化
本次更新针对单元接口，新增了调起优化transfer_optimize字段
2023-08-31
单元接口支持手机品牌定向
本次更新针对单元接口，新增了手机品牌的定向和排除功能
2022-12-08
投放媒体media_group字段新增支持媒体
本次更新针对单元层级的media_group字段，新增一个趣盟媒体集，并且下线流量比较差的4个媒体集，具体可查看投放媒体的枚举值
人群扩展directional_media字段新增支持媒体
本次更新针对人群包扩展的directional_media字段，新增一个趣盟，来替换扩展流量较差的热点段子
2022-08-31
单元接口retention_rate字段规则更新
本次针对新建、修改单元的接口，调整retention_rate字段可输入区间值。区间值从0.01%~99.99%调整为10%~60%。
2022-08-25
新建单元接口字段下线
本次针对新建单元接口，下线cpa_check_priority字段。新建深度oCPX单元时，无论是否填写该字段，都将按照"cpa_check_priority" : "BOTH" 存值
2022-05-06
广告素材列表接口字段升级
本次针对广告素材列表接口，增加可按照id进行排序功能。并且在返回素材内容时，增加素材宽高、时长、大小、创建时间的参数返回
2022-03-16
单元下线auto_stage2字段
本次针对单元新建、修改接口，下线auto_stage2字段，更新后，无论是否传auto_stage2字段，oCPX单元都将自动二阶段
2021-12-03
数据报表增加API回传字段
本次针对数据报表，增加跳转小程序api_jump_miniprogram字段。
2021-11-19
微信小程序支持新的转化目标
本次针对广告单元中的conversion_goal字段，增加新的转化目标，支持跳转小程序。
2021-11-16
创意层级增加跳转厂商应用商店开关
本次针对广告创意的新建、修改，当推广目标为应用推广时，增加是否跳转应用商店。
2021-11-11
商业开发平台接入降低准入门槛
本次针对广告主/代理商等的接入，降低了准入门槛，用户可直接使用已有的ADV平台账户登录商业开放平台，注册成为开发者。具体见首页趣智营销Marketing-API产品介绍文档。
其中，第三方开发者接入，依然需要联系官方的运营人员来开通账户。
2021-10-08
去除广告单元中优先深度转化选项
本次更新针对广告单元的cpa_check_priority字段，删除了优先深度转化选项
2021-09-24
新建单元下线oCPC投放目标
本次更新针对新建单元时，直接去掉转化(oCPC)这个选项。
2021-09-07
人群包支持同主体间广告主共享
本次更新针对DMP人群包支持了同主体间广告账户共享。
2021-09-03
单元维度增加转化目标过滤选项
本次更新针对单元维度增加了转化目标过滤选项，设计接口如下：
修改内容：
- 新增字段
conversion_filter_orient_duration - 新增枚举值 转化目标过滤枚举
2021-08-30
上传人群包结果集支持删减操作
本次更新针对DMP人群包支持了对上传人群包的结果集进行删除(Reduce)操作
2021-06-02
创建广告单元支持排除已转化人群
本次更新针对创建单元支持了排除已转化人群，涉及接口如下：
修改内容：
- 新增字段
conversion_filter_orient - 新增字段
conversion_filter_orient_duration
2021-06-02
更新广告账户信息接口
在广告账户信息接口返回字段增加赔付字段compensation，单位为分
广告账户信息接口：https://openapi.aiclk.com/openapi/v1/account/info
在账户服务下新增加账户流水接口
广告账户流水信息接口：https://openapi.aiclk.com/openapi/v1/account_fund/list
2021-05-24
新增媒体方数据报表接口
对于接入QTT的媒体方，可通过该接口，获取广告投放相关数据信息。
媒体方数据报表接口: https://openapi.aiclk.com/openapi/v1/outer_media/report
2021-05-10
新增OCPM计费方式
本次针对广告单元的 API 支持了 OCPM 计费方式，相关接口的字段有部分改动，涉及接口如下：
修改内容：
- 目标转化出价字段：
ocpc_bid修改为cpa_bid - 深度转化出价字段：
deep_cpa修改为deep_cpa_bid - OCPX扩量工具字段：
ocpc_expand修改为ocpx_expand - 是否开启深度OCPX字段：
is_deep_ocpc修改为is_deep_ocpx - OCPX状态字段：
ocpc_status修改为ocpx_status
2021-04-14
报表查询接口新增字段查询
报表查询接口新增转化目标：
- 有效阅读数
api_app_read - 表单提交数
api_ldy_pay_form
新增转化目标
- 广告投放新增转化目标：有效阅读
EFFECTIVE_READING - 广告投放新增深度转化目标：表单付费
FORM_CHARGE
2021-04-07
为了便于用户校验素材是否重复上传，对广告素材列表接口进行升级，将素材md5值同素材信息一并返回，作为素材唯一性标识。
更新接口
广告素材列表（material/get）： 返回列表新增素材md5值（material_md5）字段
2021-03-31
代理商授权模式下，支持查询其下广告账户信息。
新增接口
代理商信息：https://openapi.aiclk.com/docs/account/ad_agent/
更新接口
广告账户信息：代理商授权模式下，支持代理商查询自己下属账户信息。
2021-03-26
为提供更好服务，趣头条-趣智商业开放平台针对部分接口进行了更新操作，请各位开发者关注以下内容，及时更新接口。
更新接口：
- 2021.04.09日起，新建广告单元（adgroup/create_v2）中 目标成本考核（cpa_check_priority）字段将下线 优先目标转化（GOAL）和优先深度转化（DEEP）枚举值
- 2021.04.16日起新建创意接口（creative/create）将下线展现监测url（impression_feedback_url）参数
- 2021.04.16日起修改创意接口（creative/update）将下线展现监测url（impression_feedback_url）参数
- 2021.04.16日起获取创意接口（creative/get）该下线展现监测url（impression_feedback_url）参数
2021-02-04
为提供更好服务，趣头条-趣智商业开放平台针对部分接口进行了下线和更新操作，请各位开发者关注以下内容，及时更新接口。
接口下线：
新建广告单元、修改广告单元、获取广告单元中的v1请求接口将在2021年3月1日后下线。接口下线后无法使用v1接口进行新建、修改、获取广告单元操作，各位开发者需自行替换为v2接口。
更新接口：
- 获取广告计划（campaign/get）：新增
修改时间过滤（updated_at）参数 - 获取广告单元（adgroup/get_v2）：新增
修改时间过滤（updated_at）参数 - 获取广告创意（creative/get）: 新增
修改时间过滤（updated_at）参数 - 数据报表接口（report/get）:返回字段增加
广告计划名称（campaign_name）、广告单元名称（adgroup_name）、广告创意名称（creative_name）
2020-11-04
广告单元支持媒体通投
创建广告单元：https://openapi.aiclk.com/docs/ad_manage/adgroup/create/
修改广告单元：https://openapi.aiclk.com/docs/ad_manage/adgroup/update/
查询广告单元：https://openapi.aiclk.com/docs/ad_manage/adgroup/get/
数据报表支持细分查询：https://openapi.aiclk.com/docs/report/insight/
数据报表新增枚举：https://openapi.aiclk.com/docs/appendix/insight_fields/
媒体类型枚举：https://openapi.aiclk.com/docs/appendix/enum_value/
2020-09-22
DMP人群包上传流程优化 DMP人群包原有的文件流上传流程需要客户把文件分割成50MB左右的小文件才能完成上传操作，优化后通过阿里云COS临时授权的方式，将文件的限制扩大到了1GB。
2020-08-19
新增授权信息查询接口 开发者通过该接口可以查询某一个Access_Token对应的有效时间、频控信息、以及已经授权的账号信息。
详见：查看授权信息
2020-08-11
新增接口小版本升级标志
为了解决接口小版本升级的兼容问题，请求Header中引入了版本控制参数X-Release-Date
详情见：发起请求
更新接口：
Tip
以下更新需要接口请求满足：Header中新增X-Release-Date，且传值大于2020-08-12
涉及到的接口需要开发者在2020年9月14日之前完成新增，否则将会影响调用
- 广告创意的列表接口(/creative/create)：
-
新增字段：
target_type(建站类型)，clk_site_id(建站ID) -
新增字段：
target_type(建站类型)，clk_site_id(建站ID) - 新增字段：
target_type(建站类型)，clk_site_id(建站ID)
2020-07-27
【重要功能】趣智商业开放平台上线
- 什么是趣智商业开放平台？https://developers.aiclk.com
- 趣智商业开放平台是为Marketing API提供应用管理、账号授权等功能，协助客户实现营销管理自动化的平台。在使用Marketing Api之前，客户需要先进入商业开放平台进行操作。
- 趣智开放平台能够做什么？
- 可对应用进行管理，包括新增应用，修改应用权限等等
- 商业开放平台支持对应用进行账户绑定和解绑，绑定成功后可进行账户读/写和DMP人群管理
- 如何申请商业开放平台账户？
- 请联系销售运营同学进行申请。
2020-07-15
更新接口：
- 广告计划的列表接口(/campaign/get)：
-
新增字段：
effective_status(广告计划操作状态) -
新增字段：
effective_status(广告单元操作状态) - 新增字段：
effective_status(广告创意操作状态)
2020-07-01
更新接口：
- 广告创意的创建接口(/creative/create)：
-
新增字段：
motivate_video_autoplay(激励视频plus开关) -
新增字段：
motivate_video_autoplay(激励视频plus开关) - 新增字段：
motivate_video_autoplay(激励视频plus开关)
2020-06-17
更新接口：
- 广告单元的创建接口(/adgroup/create)：
-
新增字段：
auto_stage2(直接进入二阶段出价开关),retention_rate(目标次留率) -
新增字段：
auto_stage2(直接进入二阶段出价开关),retention_rate(目标次留率) - 新增字段：
auto_stage2(直接进入二阶段出价开关),retention_rate(目标次留率)
2020-04-28
新增接口：
- 广告计划的创建(/campaign/create)、广告计划的更新(/campaign/update)
- 广告单元的创建(/adgroup/create)、广告单元的更新(/adgroup/update)
- 广告创意的创建(/creative/create)、广告创意的更新(/creative/update)
- 素材上传(/material/upload)
更新接口：
-
- 新增字段：
app_filter,app_filter_value,app_package,app_package_value,audience_orient,audience_orient_filter,click_frequency,conversion_from,conversion_goal,cpa_check_priority,create_time,deep_conversion_goal,deep_ocpc_status,device_orient,frequency,hours,is_deep_ocpc,network,ocpc_expand,os_type,phone_level,regions,user_orient,unable_reason,creative_id
- 新增字段：
-
- 新增字段：
account_id,api_id,app_introduction,app_logo,app_name,back_end_conversion,clk_site_id,conversion_target,conversion_type,game_material_id,js_conversion_id,motivate_style,pkg_name,play_action,play_duration,sub_cate,target_url_h5,video_title - 废弃字段：
feed_title
- 新增字段：