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

【重要通知】

快手Mapi广告平台已经上线，所有更新功能后续将在对外平台更新，感谢您一直以来对快手Mapi的使用。

快手广告平台：https://developers.e.kuaishou.com/docs，请您移步至开放平台查看。

【更新日志】

2020.11.25

1.支持mapi通过视频查询接口查询快手聚星平台视频，方便更多样性&多类型的视频接入，提升快手广告主视频竞争力。

涉及接口「/rest/openapi/v1/file/ad/video/get」、「/rest/openapi/v1/file/ad/video/listt」

涉及对外文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#

2.营销目标为“提升应用安装”的快手广告计划，支持应用直达下载链接。

涉及参数「schema_uri」

涉及对外接口文档：https://yiqixie.com/d/home/fcABb12AIZLwBzk5itfCK395N#section=h.5y7tqn372o72

3.mapi支持加速探索，帮助快手广告主提升冷启动成功率，并提升使用该功能效率

新增4个接口：查询加速探索信息接口「/rest/openapi/v1/ad_unit/explore/info/get」，修改快手广告组的探索预算接口「/rest/openapi/v1/ad_unit/explore/budget/update」

暂停广告组的探索预算接口：「/rest/openapi/v1/ad_unit/explore/status/pause」，查询快手广告组的探索预算报表接口「/rest/openapi/v1/report/speed_explore」

涉及对外接口文档:https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.8n73suvlusg6

2020.11.14

1.新增ocpx转化目标微信复制，提升快手广告组创建效率。

新增「ocpx_action_type=715」，涉及快手广告组创建「/rest/openapi/v2/ad_unit/create」，涉及获获取快手短视频广告组信息接口「/rest/openapi/v1/ad_unit/list」，报表新增微信复制数、微信复制成本、微信复制率

使用限制：1.campaign_type=5 2.bid_type=10 3.ocpx回传门槛≥1

涉及对外文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.tc701cs2rp5o

2.Mapi支持行为兴趣定向，方便快手信息流广告选择定向人群，对齐平台定向功能使功能更完善。

在广告组创建「/rest/openapi/v2/ad_unit/create」taget新增参数「behavior_interest」，涉及获获取快手广告组信息接口「/rest/openapi/v1/ad_unit/list」。

新增接口：获取行为与兴趣"类目"「rest/openapi/v1/tool/label/behavior_interest」& 获取行为兴趣"关键词"「rest/openapi/v1/tool/keyword/query」。

涉及对外文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.iq6b7h4ss8i

3.评论管理二期接口功能升级，方便快手短视频广告主便捷管理评论内容，提升效率。

评论列表数据查询接口「/rest/openapi/v1/comment/list」根据2.0升级，新增请求参数「shield_status」「photo_query_value」「photo_tags」

新增返回参数「shield_status」「photo_name」「photo_tags」「is_root_comment_forbid」，

新增屏蔽评论接口「/rest/openapi/v1/comment/shield」

涉及对外文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.ygyc49n1e0yc

4.Mapi支持代理商角色下appid通过调用接口接口进行开户，该功能整处于白名单测试阶段，如有需求联系快手广告渠道运营同学申请通过群中给appid加白使用。

涉及对外开发者文档（暂未全面推送使用）：https://yiqixie.com/d/home/fcAAx6RYTh7op-bpjMcZYJvHf

5.程序化创意2.0支持智能抽帧&素材挖掘，方便快手广告主降低使用程序化2.0上传封面门槛，提升创建效率。

在快手广告组创建unit_type=7广告组才「/rest/openapi/v2/ad_unit/create」新增参数智能抽帧「smart_cover」、历史素材挖掘「asset_mining」，仅当unit_type=7广告组才能回传该参数。

涉及获取广告组信息接口「rest/openapi/v1/ad_unit/list」,修改广告组接口「rest/openapi/v2/ad_unit/update」一定要保证程序化创意2.0接口中封面「cover_image_tokens」为空。

涉及对外开发者文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.iq6b7h4ss8i

6.Mapi支持以接口方式体验快手广告，方便快手广告主查看自己广告展现样式&核对投放信息。

涉及对外开发者文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.mv1nv4ckw9ok

2020.11.7

1.Mapi支持线索通智能电话组件数据查看标记等功能，帮助电话收集类快手广告主提升线索管理效率。

新增接口智能电话信息查询接口「rest/openapi/v2/gemini/icc/clue/list」

信息修改接口「rest/openapi/v2/gemini/icc/clue/update」

涉及对外文档：https://yiqixie.com/d/home/fcADtLnLiWvasTjKvfRy9S9lr#section=h.n7ous3vk6x9g

2.Mapi支持视频库功能,方便广告对素材的集中管理，新增视频标签&命名帮助快手广告主对视频统一命名。

上传视频接口新增传参：视频名称「photo_name」、视频标签「photo_tag」字段。

获取视频信息接口新增返回参数:「photo_name、photo_tag、视频状态new_status、视频时长duration、视频来源source」

新增接口：删除视频接口「/rest/openapi/v1/file/ad/video/delete」，推送视频接口「/rest/openapi/v1/file/ad/video/share」，批量更新「/rest/openapi/v1/file/ad/video/update」，删除视频标签接口「rest/openapi/v1/file/ad/video/tag/delete」。

涉及对外开发者文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.hrl90f9r7u0l

3.获取广告创意信息是否为僵尸创意，方便快手广告查询创意状态信息。

涉及接口「/rest/openapi/v1/creative/list」新增回参「creativeStatusType」

涉及对外文档：https://yiqixie.com/d/home/fcAB8NFoHn82gbNSTAM4rU2re#section=h.6em3b88xlhok

4.Mapi支持智能定向，提升智能定向快手广告组创建效率。

涉及接口广告组新建、修改、查询。新增智能定向参数「auto_target」。

涉及对外文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.iq6b7h4ss8i

5.mapi报表新增支持人群分析报表，方便快手广告主分析人群，找到更精准的人群。

新增接口「rest/openapi/v1/report/audience_report」

涉及报表对外接口：https://yiqixie.com/d/home/fcAC2OzurfmGRLHLJsNRz_wIX#section=h.kk11wf7dcxdr

2020.11.4

1.人群列表查询接口新增第三方供应商名称，方便快手视频广告主筛选相同供应商

新增参数「third_platform_name」

涉及对外文档：https://yiqixie.com/d/home/fcAAfm9OQj5OeEBd9TB2gtxvD#section=h.pm1gza3jxq18

2.Mapi支持商圈定向，增加细分地域定向，使定向人群更加精准。

新增创建参数「district_ids」，涉及接口广告组创建/rest/openapi/v2/ad_unit/create、快手广告组修改/rest/openapi/v2/ad_unit/update、获取账户广告组信息/rest/openapi/v1/ad_unit/list、定向模板列表/rest/openapi/v1/target/template/list、定向模板创建/rest/openapi/v1/target/template/create、定向模板更新/rest/openapi/v1/target/template/update

新增接口「/rest/openapi/v1/region/district/list」，可以获取商圈定向信息。

涉及广告组创建接口对外文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.iq6b7h4ss8i

商圈定向查询接口对外文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.icnrjnqnqd9g

3.Mapi接口支持评论管理1期功能，方便快手广告主管理评论，并及时针对客户评论回复。（白名单，预计11.5推全使用）

新增接口评论列表查询接口「/rest/openapi/v1/comment/list」、回复评论接口「/rest/openapi/v1/comment/reply」、评论树查询接口「/rest/openapi/v1/comment/tree」

涉及对外开发者文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.ygyc49n1e0yc

2020.10.29

1.针对新门槛map获取可选的深度转化类型，帮助客户获取新账户的新门槛参数。

新增新门槛参数「campaign_type」，「app_id」。

【新门槛标准】

1.应用下载类——

1)账户维度，相应的 event_type 回传 >=1; 或者2)应用包维度，用转化追踪联调通过相应的 event_type

2.落地页类

账户维度，相应的 event_type 回传 >=1;

涉及对外文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.vcrgv6iue0q8

2020.10.14

1.Mapi支持联盟广告场景下scene_id=5创建程序化创意2.0广告创意。

2.Mapi人群包更新接口「rest/openapi/v1/dmp/population/update」更新逻辑变更，便于快手广告主循环更新人群包，降低等待时间&重复拉取人群包状态的繁杂操作，提升更新人群包的效率。

改版前人群包更新流程：已生成人群包-调用更新接口-人群包计算(系统处理)-计算完成生效使用（需要等待人群包生效后方可继续更新）

改版后人群包更新流程：已生成人群包-可重复调用更新接口-人群包计算-人群包推送-人群包使用（无需等待人群包状态，可循环更新人群包接口。但是需要注意：一定需要在更新人群包后调用推送人群包，保证定向中使用的为更新后人群包）

2020.10.13

1.Mapi推荐理由2期上线，可实现填写2个推荐理由，使用户一目了然产品优势&特点，提升快手广告转化率&效果。

新增参数推荐理由2期标签「new_expose_tag」

涉及接口创意创建接口「/rest/openapi/v2/creative/create」；

创意更新接口「/rest/openapi/v2/creative/update」；

批量创意创建&修改接口「/rest/openapi/v2/creative/batch/update」；

获取账户创意信息查询接口「/rest/openapi/v1/creative/list」

涉及创建创意接口对外文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.tc701cs2rp5o

涉及创意信息查询接口对外文档：https://yiqixie.com/d/home/fcAB8NFoHn82gbNSTAM4rU2re#section=h.6em3b88xlhok

2020.9.30

1.支持创意分类&标签，对齐快手平台创建创意流程，方便用户创建创意标签提升提升创意创建效率。

新增创意分类查询接口：「rest/openapi/v1/creative/creative_category/list」；新增字段创意分类「creative_category」创意标签「creative_tag」。

涉及接口创意接口：创意新建「/rest/openapi/v2/creative/create」，创意更新「rest/openapi/v2/creative/update」

创意批量更新&新建「/rest/openapi/v2/creative/batch/update」，账户创意信息获取「rest/openapi/v1/creative/list 」

涉及程序化创意2.0接口：程序化创意创建「rest/openapi/v2/creative/advanced/program/create」

程序化创意更新「rest/openapi/v2/creative/advanced/program/update」，

程序化创意获取「rest/openapi/v2/creative/advanced/program/list」

创意创建接口：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.tc701cs2rp5o

程序化创意创建接口：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.4ejaneuj6elr

2.获取程序化创意2.0部分组合审核未通过信息，方便快手广告主修改程序化创意物料信息。

新增审核信息获取接口「/rest/openapi/v2/creative/advanced/program/review_detail」

涉及获取信息接口：https://yiqixie.com/d/home/fcAB8NFoHn82gbNSTAM4rU2re#section=h.4c0js5emjaln

3.新增计划提高应用活跃营销目标，方便此类型广告主通过mapi快速创建广告。

新增计划类型「type=7」,涉及计划创建接口「rest/openapi/v2/campaign/creat」

新增快手广告组调起链接字段「schema_uri」，涉及广告组新建「rest/openapi/v2/ad_unit/create」；广告组更新「/rest/openapi/v2/ad_unit/update」；广告组信息获取「rest/openapi/v1/ad_unit/list」

注意：仅支持「bid_type=10(OCPM)」/「ocpx_action_type」联盟只支持行为数(2)；非联盟支持行为数(2)、激活(180)、提交订单(394)

涉及快手广告计划创建接口：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.dld72olq1s50

涉及快手广告组创建接口：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.iq6b7h4ss8i

涉及快手广告组更新接口：https://yiqixie.com/d/home/fcABb12AIZLwBzk5itfCK395N#section=h.5y7tqn372o72

涉及快手广告组获取接口：https://yiqixie.com/d/home/fcAB8NFoHn82gbNSTAM4rU2re#section=h.4219y9umdag5

2020.9.25

1.为保证快手广告应用分发符合国家保护用户隐私的要求，需要明示被分发软件申请的用户权限，以达到保护用户隐私目的。针对安卓下载类APP新增必填传参「app_privacy_url」

涉及应用创建接口「rest/openapi/v1/file/ad/app/create」应用更新接口「rest/openapi/v1/file/ad/app/update」

应用列表查询接口「rest/openapi/v1/file/ad/app/list」

涉及应用创建接口：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#

应用修改接口：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.r3kjx98xuqo3

应用列表查询接口：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.1xo1c825z5z1

2020.09.15

1.Mapi支持定向模板，提升快手广告主提升操作使用定向效率，降低重复操作的人力成本。

新增查询定向模板接口「rest/openapi/v1/target/template/list」，创建定向模板接口「rest/openapi/v1/target/template/create」，修改定向模板更新napi/v1/target/template/update」，删除定向模板接口「rest/openapi/v1/target/template/delete」。

快手广告组新建&修改接口新增定向模板传参「template_id」。

涉及定向模板接口：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.tqam0z1hz3f8

涉及快手广告组创建开发者文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.iq6b7h4ss8i

涉及快手广告组修改开发者文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.vcrgv6iue0q8

2020.9.14

1.支持注册优化目标「ocpx_action_type=396」,帮助注册优化目标广告主快速创建，提升创建效率。

涉及接口广告组创建「rest/openapi/v2/ad_unit/create」，快手广告组更新「rest/openapi/v2/ad_unit/update」获取深度转化信息接口「rest/openapi/v1/ad_unit/ocpc/conversion_infos」。

涉及快手广告组创建开发者文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.iq6b7h4ss8i

涉及快手广告组修改开发者文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.vcrgv6iue0q8

涉及深度转化信息接口文档：https://yiqixie.com/d/home/fcABb12AIZLwBzk5itfCK395N#section=h.5y7tqn372o72

2.新增行动号召按钮文案获取接口，方便广告主快速获取行动号召按钮文案，实时更新文案。

新增接口「rest/openapi/v1/creative/action_bar_text/list」

涉及对外开发者文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.e95a52du0uz1

3.获取电商下单营销目标支持非金牛电商途径下的“订单提交”优化目标，,帮助注册优化目标广告主快速创建，提升创建效率。

涉及接口快手广告组创建「rest/openapi/v2/ad_unit/create」，快手广告组更新「rest/openapi/v2/ad_unit/update」获取深度转化信息接口「rest/openapi/v1/ad_unit/ocpc/conversion_infos」

2020.9.10

1.支持获取素造视频封面&标签，对齐素造平台能力，提升快手信息流广告主分类使用素造视频。

获取素造视频信息接口「rest/openapi/v1/ad_creator/video/list」
a）新增返回参数：封面「covers」，素造视频标签「material_tag」；

b）返回参数视频同步日期「sync_date」格式升级为yyyy-MM-dd HH:mm:ss

b）请求参数「start_date」&「end_date」格式升级为yyyyMMdd HH:mm:ss，并兼容原yyyyMMdd格式

涉及开发者文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.2kybg2k0dex8

2.支持便利贴快手广告(scene_id=3)使用第三方第三方点击按钮监测链接「actionbar_click_url」.

涉及接口创意创建「/rest/openapi/v2/creative/create」，创意修改「/rest/openapi/v2/creative/update」，批量创建创意「/rest/openapi/v2/creative/batch/update」

3.获取程序化创意2.0信息查询接口，新增筛选条件，方便快手广告主快速筛选需要的程序化创意信息，提升查询效率。

新增筛选参数「unit_ids」、「package_name」、「status」、「start_date」、「end_date」。

新增返回参数「create_time」、「update_time」

涉及开发者文档：https://yiqixie.com/d/home/fcAB8NFoHn82gbNSTAM4rU2re#section=h.khgmbvkt8i1c

2020.9.6

1.支持获取使用全部人群包数据，节省快手广告主需要将付费人群包推送至人群管理操作路径，简化快手广告主操作，提升快手视频广告主使用付费人群包效率。

涉及开发者文档：https://yiqixie.com/d/home/fcAAfm9OQj5OeEBd9TB2gtxvD#

2.支持优先低成本手动出价&自动出价，并支持优先低成本预算&时段设置，方便用户使用优先低成本投放方式。

新增参数「smart_bid」，支持接口广告组创建「/rest/openapi/v2/ad_unit/create」、快手广告组修改「/rest/openapi/v2/ad_unit/update」、广告组信息获取「/rest/openapi/v1/unit/list」

涉及创建开发者文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.iq6b7h4ss8i

涉及修改开发者文档：https://yiqixie.com/d/home/fcABb12AIZLwBzk5itfCK395N#section=h.5y7tqn372o72

涉及获取开发者文档：https://yiqixie.com/d/home/fcAB8NFoHn82gbNSTAM4rU2re#section=h.4219y9umdag5

3.支持双侧快手信息流广告落地页前置功能，提升广告组创建落地页前置效率，缩短客户转化路径，提升后端效果。

新增参数「video_landing_page」，支持接口广告组创建「/rest/openapi/v2/ad_unit/create」、广告组修改「/rest/openapi/v2/ad_unit/update」、广告组信息获取「/rest/openapi/v1/unit/list」

涉及创建开发者文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.iq6b7h4ss8i

涉及修改开发者文档：https://yiqixie.com/d/home/fcABb12AIZLwBzk5itfCK395N#section=h.5y7tqn372o72

涉及获取开发者文档：https://yiqixie.com/d/home/fcAB8NFoHn82gbNSTAM4rU2re#section=h.4219y9umdag5

4.支持首日ROI优化目标，对齐平台优化目标，方便快手广告主创建。

新增ocpx_action_type参数「191」&付费ROI系数「roi_ratio」。支持接口快手广告组创建「/rest/openapi/v2/ad_unit/create」、广告组修改「/rest/openapi/v2/ad_unit/update」、广告组信息获取「/rest/openapi/v1/unit/list」获取可选深度转化目标「/rest/openapi/v1/ad_unit/ocpc/conversion_infos」

涉及创建开发者文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.iq6b7h4ss8i

涉及修改开发者文档：https://yiqixie.com/d/home/fcABb12AIZLwBzk5itfCK395N#section=h.5y7tqn372o72

涉及获取开发者文档：https://yiqixie.com/d/home/fcAB8NFoHn82gbNSTAM4rU2re#section=h.4219y9umdag5

涉及转化目标开发者文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.vcrgv6iue0q8

5.支持IOS预约广告，方便快手广告主创建。

新增参数「site_type」，只有是白名单快手广告账户才可以使用，联盟广告暂不支持。

支持接口快手广告组创建「/rest/openapi/v2/ad_unit/create」、广告组修改「/rest/openapi/v2/ad_unit/update」、广告组信息获取「/rest/openapi/v1/unit/list」

涉及创建开发者文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.iq6b7h4ss8i

涉及修改开发者文档：https://yiqixie.com/d/home/fcABb12AIZLwBzk5itfCK395N#section=h.5y7tqn372o72

涉及获取开发者文档：https://yiqixie.com/d/home/fcAB8NFoHn82gbNSTAM4rU2re#section=h.4219y9umdag5

6.素材&程序化创意报表新增 photoId和imageToken返回，方便快手广告主对素材数据归因&更好迭代素材。

涉及离线报表/实时报表的素材报表&程序化创意报表。

7.所有离线&实时报表新增数据字段

平均千次素材曝光花费(元)「click_1k_cost」，预约表单数「event_appoint_form」，预约表单点击成本「event_appoint_form_cost」，预约表单点击率「event_appoint_form_ratio」，预约跳转点击数「event_appoint_jump_click」，预约跳转点击成本「event_appoint_jump_click_cost」，预约跳转点击率「event_appoint_jump_click_ratio」

2020.8.31

1.支持查询APP定向对应的APP名称，方便快手广告主双向查询创建APPID对应APP名称，提升查询使用效率。

涉及接口「rest/openapi/v1/ad_unit/list」，target中新增字段「app_names」。

涉及开发者文档：https://yiqixie.com/d/home/fcAB8NFoHn82gbNSTAM4rU2re#

2.支持创意广告语使用动态词包，提升快手广告语多样性&相关性，提升广告效果。

快手联盟广告和程序化创意不支持动态词包，涉及接口创建「/rest/openapi/v2/creative/create」、批量创建「/rest/openapi/v2/creative/batch/update」、修改「/rest/openapi/v2/creative/update」。

涉及创建开发者文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.tc701cs2rp5o

涉及批量创建开发者文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#section=h.bwtq3bcndvq2

涉及修改开发者文档：https://yiqixie.com/d/home/fcABb12AIZLwBzk5itfCK395N#section=h.1dgdcefib8y

3.支持快手广告组层级支持过滤已转化人群，避免转化人群重复曝光，提升广告主投放效率。

涉及接口快手广告组创建「/rest/openapi/v2/ad_unit/create」、广告组更新「/rest/openapi/v2/ad_unit/update」、广告组信息查询「/rest/openapi/v1/ad_unit/list」。

涉及快手广告组创建开发者文档：https://yiqixie.com/d/home/fcACuwYpSB3pFCkgbykniO7_h#

涉及快手广告组更新开发者文档：https://yiqixie.com/d/home/fcABb12AIZLwBzk5itfCK395N#

涉及快手广告组查询开发者文档：https://yiqixie.com/d/home/fcAB8NFoHn82gbNSTAM4rU2re#

---

文章均来自互联网如有不妥请联系作者删除QQ:314111741 地址：http://www.mqs.net/post/2241.html