抖音资讯

douyinzx

抖音资讯

快手广告的 Marketing API 更新日志《NO.3》

iseeyu2年前 (2024-03-28)抖音资讯127

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」新增动态词包、封面快手广告语等返回字段。

快手信息流推广开户代理商找哪家比较靠谱，现在巨宣网络是非常不错的选择，做快手广告主要是素材要不断的更新，我们有这方面的优势，想做推广的客户找巨宣网络是比较靠谱的！不单是能做快手广告，像快手广告、亚马逊广告、网易广告、华为广告、百度开户等我们都是可以做的，快手和快手的广告我们都是可以代运营视频素材的哦！快手开户电话是：4009602809