快手广告的 Marketing API 版本更新记录《NO.3》-精准获客

2020.6.3

批量上传与修改创意

新增接口「rest/openapi/v2/creative/batch/update」，能够实现创意的批量创建及修改。若未上传「creative_id」则为新建操作；若上传了「creative_id」则为修改操作，支持部分字段的更新，若未传递相关字段则使用原创意字段。

参数分为公共参数和批量参数（creatives）。公共参数涵盖了该计划下创意共用的部分，比如设置或修改了监测链接，那么此计划下的所有创意都会共用这个监测链接。
新建时，一个unit最多能够创建15个创意；修改时传入的创意id不能重复，并且该创意id必须处于对应的unitId之下。

涉及开发者文档：

https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.83zzieggf300

2020.5.28

获取素造视频接口「openapi/v1/file/ad/video/su_zao/list」新增「素造视频素材id：material_id」。

2020.5.27

MAPI支持对大部分平台创建的广告进行投放修改。

可修改的计划类型为「2: 提升应用安装、3：获取电商下单、4：推广品牌活动、5：收集销售线索」。

可修改的广告组unit_type为「4: 自定义、5：程序化创意」。

涉及开发者文档：

https://yiqixie.com/d/home/fcABb12AIZLwBzk5itfCK395N

2020.5.22

为方便快手广告主查询第三方点击按钮检测链接，转化目标查询接口新增字段「app_id」「app_name」「click_url」。

涉及接口「/rest/openapi/v1/tool/convert/list」。

涉及开发者文档：

https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.u6uzsmbpr518

2020.5.21

1.获取素造快手视频信息广告接口新增字段「signature」「details」，原有的「detail」字段已被废弃，涉及接口「/rest/openapi/v1/file/ad/video/su_zao/list」。

涉及开发者文档：

https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#

2.查询操作日志功能已上线，新增接口「rest/openapi/v1/tool/operation_record/list」。

涉及开发者文档：

https://yiqixie.com/d/home/fcAB8NFoHn82gbNSTAM4rU2re#section=h.35kyfc5byuz4

2020.5.20

1.视频获取接口部分生效视频未匹配MD5值的情况已得到解决，增加了视频MD5值。

2.视频获取接口返回值新增字段「status」，涉及接口「rest/openapi/v1/file/ad/video/get」「/rest/openapi/v1/file/ad/video/list」。

涉及开发者文档：

https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.xnhxth7vne66

2020.5.15

1.支持通过创建历史查询任务获取「程序化创意报表」，字段新增「view_type：6程序化创意报表、virtual_creative_ids程序化创意id集」。

涉及开发者文档：

https://yiqixie.com/d/home/fcAC2OzurfmGRLHLJsNRz_wIX#section=h.ey8xpi1qlc8e

2020.5.12

1.支持查询删除广告，涉及接口「账户查询接口-获取广告计划信息/获取广告组信息/获取快手广告创意信息」。

涉及开发者文档：

https://yiqixie.com/d/home/fcAB8NFoHn82gbNSTAM4rU2re#section=h.5wzfj0a4eva8

2020.5.9

1.支持「优先低成本」，字段「speed」新增 3 – 优先低成本。

涉及「创建广告接口-广告组创建：/rest/openapi/v2/ad_unit/create」。

2.

OCPX 优化目标为「激活」的底价调低至 1 元，涉及接口「创建广告接口-广告组创建、修改广告接口-广告组修改」。

2020.4.27

1. 支持「优先从系统应用商店下载」，新增字段「use_app_market」，涉及接口「创建广告接口-广告组创建、快手推广账户查询接口-广告组查询、修改广告接口-广告组修改」。

2.创意层级作品广告语不支持换行与多空格，涉及字段「description」。

2020.4.22

「账户查询模块」新增接口「/rest/openapi/v1/advertiser/budget/get」支持查询快手账户日预算。

2020.4.22

1.广告组创建和修改付费人群包。

创建和修改unit时支持付费人群包，涉及接口：/rest/openapi/v2/ad_unit/create，rest/openapi/v2/ad_unit/update。

新增字段：population、exclude_population、paid_audience。

2.查询账户下的付费人群包。

涉及接口：/rest/openapi/v1/dmp/population/list。

新增响应参数字段：third_platform_code。

3.创建付费人群包-游戏精选标签。

新增接口：/rest/openapi/v1/dmp/population/paid/game_select_tag/create。

2020.4.21

为提升快手广告主账户查询速度，对严重影响性能的字段做下线处理。

https://yiqixie.com/d/home/fcAB8NFoHn82gbNSTAM4rU2re#

1.接口：/campaign/list，status字段筛选不再支持，campaign_name改成精确查询。

2.接口：/ad_unit/list，status、campaign_type、app_name字段筛选不再支持，unit_name改成精确查询。

3.接口：/creative/list，status字段筛选不再支持，creative_name改成精确查询。

2020.4.13

1.平台投放部分双出价改为单出价，marketing api支持快手广告组的新建和查询，快手联盟广告暂不支持。

2.ocpx_action_type由行为数:2、激活:180、表单:53，新增付费:190、授信:383、完件:384。需通过接口「rest/openapi/v1/ad_unit/ocpc/conversion_infos」获取是否可以选择「激活」、「表单转化」、「付费」、「授信」、「完件」的优化目标。

2020.4.8

1. 支持白名单账户定投联盟广告，创建、修改广告组和创建、修改创意的相关接口均有相应注意事项，可查阅「创建快手广告模块」3.3、3.7、3.8 部分，「修改广告模块」3.4、3.5、3.6 部分。

2. 程序化创意多广告语字段description_titles上线，原广告语字段description即将废弃，详情可查看程序化创意的创建、修改接口，创意的查询接口。

2020.3.30

1. 「创建广告模块」新增接口「/rest/openapi/v1/tool/download_page/list」，支持获取可用于创建快手广告创意的安卓下载中间页，同时创建、修改、查询创意的接口新增site_id参数。目前暂不支持程序化创意，后续会进行升级更新。

2. 创建广告组时，scene_id与投放平台对齐，可选择“优选广告位”或其他分场景广告位的组合。

2020.3.20

1. 「创建广告模块」新增接口「/rest/openapi/v1/file/ad/video/su_zao/list」，支持获取素造平台的视频用于广告创建。

2020.3.13

1. 「账户查询模块」新增权限码account_service，历史已授权账户已默认开通，新授权的快手推广账户进行授权操作时，授权URL的scope参数中需自行按授权文档格式拼接该授权码进行授权，才能够使用「获取广告账户信息」、「获取广告账户余额信息」、「获取广告账户流水信息」三个接口。

2. 创建创意、修改创意、查询创意三个接口，增加「便利贴广告短广告语」参数short_slogan。

3. 权限进行严格划分，广告主只能操作已备案主体的对应账户，代理商只能操作自己权限范围内的账户。

2020.3.5

新增历史投放报表数据接口「/rest/openapi/v1/async_task/create」、「/rest/openapi/v1/async_task/list」、「/rest/openapi/v1/async_task/download」，以异步任务的方式支持查询历史数据。其他注意事项详见报表模块文档。

2020.3.2

1. 支持转化追踪目标(JS/Xpath/API/SDK)的使用，新增查询转化目标接口「/rest/openapi/v1/tool/convert/list」，快手广告推广组创建/查询接口，同步新增convert_id字段。

2. 支持分场景投放，广告组创建接口的scene_id字段新增可选值，同时创意创建/修改接口的click_track_url、impression_url、ad_photo_played_t3s_url新增相关备注。

2020.2.20

支持程序化创意，新增创建程序化创意、修改程序化创意接口「/rest/openapi/v2/creative/programmed/create」、「/rest/openapi/v2/creative/programmed/update」，历史接口中，新建快手广告组接口「/rest/openapi/v2/ad_unit/create」的unit_type字段增加新参数值，查询创意信息接口「/rest/openapi/v1/creative/list」新增相应字段。

2020.2.13

报表接口更新，广告主/广告计划/广告组/广告创意报表查询接口增加字段report_dims，支持分场景数据导出。

2020.2.11

报表接口更新，广告计划/广告组/广告创意报表查询接口增加campaign_ids、unit_ids、creative_ids字段，如单次查询需处理的有效快手广告计划/广告组/广告创意数量超过 5000，会提示“报表查询处理 ID 数比较多，请分批次传 ID 进行查询”，错误码 410006。分页查询的 page_size 扩展到 1000。

2020.1.21

1、支持便利贴广告，创建广告组接口「/rest/openapi/v2/ad_unit/create」的scene_id参数值对应关系有变动、上传图片接口「/rest/openapi/v2/file/ad/image/upload」的type参数新增参数值。

2、支持获取推荐封面，新增接口「/rest/openapi/v1/tool/key_frame」。

3、各层级分日预算字段上线，相关接口均有涉及「/rest/openapi/v2/campaign/create」、「/rest/openapi/v2/ad_unit/create」、「/rest/openapi/v1/advertiser/update/budget」、「/rest/openapi/v2/campaign/update」、「/rest/openapi/v2/ad_unit/update」。

2020.1.10

1、创建、更新、查询广告组接口「/rest/openapi/v2/ad_unit/create」、「/rest/openapi/v2/ad_unit/update」、「/rest/openapi/v1/ad_unit/list」商业兴趣参数business_interest_type新增参数值，支持智能推荐。

2、创建、更新、查询广告组接口「/rest/openapi/v2/ad_unit/create」、「/rest/openapi/v2/ad_unit/update」、「/rest/openapi/v1/ad_unit/list」安卓操作系统版本参数android_osv新增参数值，支持 8+、9+、10+版本，与投放平台对齐。

3、创建、更新、查询应用组接口「/rest/openapi/v1/file/ad/app/create」、「/rest/openapi/v1/file/ad/app/update」、「/rest/openapi/v1/file/ad/app/list」新增use_sdk字段，支持对接了快手广告监测SDK的广告主使用。

4、创意查询接口「/rest/openapi/v1/creative/list」新增first_frame_type字段，便于快手广告主判断视频封面能否重复使用。

2019.11.26

1、创建、更新、查询广告组接口「/rest/openapi/v2/ad_unit/create」、「/rest/openapi/v2/ad_unit/update」、「/rest/openapi/v1/ad_unit/list」时新增ages_range（固定年龄段）字段。

2、查询接口「/rest/openapi/v1/campaign/list」、「/rest/openapi/v1/ad_unit/list」、「/rest/openapi/v1/creative/list」、「/rest/openapi/v1/file/ad/image/list」、「/rest/openapi/v1/file/ad/video/list」请求时增加start_date与end_date字段作为过滤筛选条件。

3、查询计划/组/创意时，返回创建来源、开关按钮状态。接口「/rest/openapi/v1/campaign/list」、「/rest/openapi/v1/ad_unit/list」、「/rest/openapi/v1/creative/list」，返回结果新增create_channel、put_status字段。

2019.11.11

1、通过image_token获取图片接口「/rest/openapi/v1/file/ad/image/get」新增返回字段signature，即图片MD5值，仅当图片通过API上传时，该参数有值。

2、查询creative信息接口「/rest/openapi/v1/creative/list」新增动态词包、封面快手广告语等返回字段。

快手信息流推广开户代理商哪家更靠谱？当下精准获客是绝佳选择。做快手广告关键在于素材的持续更新，我们在此方面颇具优势。有意推广的客户选择精准获客是可靠之选！我们不仅能承接快手广告业务，像亚马逊广告、网易广告、华为广告、百度开户等我们都能胜任，快手和快手的广告我们也能代运营视频素材哦！快手开户电话是：

1 本站内容观点不代表本站立场，并不代表本站赞同其观点和对其真实性负责；
2 本站部分内容来源于网络，仅供学习与参考，如有侵权，请联系网站管理员删除
3 本站一律禁止以任何方式发布或转载任何违法的相关信息，访客发现请向站长举报
4 精准获客感谢您的访问！希望本站内容对您有所帮助！

THE END