V1.2更新日志

2020-05-14

1. 转化归因为 AMS 侧提供给客户的全新的转化工具，旨在提供一体化的转 化数据链路相关工具的维护和使用，同时打通数据与投放，帮助客户实现更高效、更准确的数据上报，从而提升广告投放效率及效果。
2. 现平台提供转化查询模块，支持查询已创建的转化详情；支持广告创建时关联转化id。

2020-05-13

1. 为了更好地优化广告主在优量汇的投放效果，并方便广告主理解，“优量汇流量场景细分” 更名为 “优量汇行业定投流量包”，“优量汇流量场景屏蔽” 更名为“优量汇行业屏蔽流量包”。
2. 此外，此次新增“轻度游戏广告主定制、阅读行业广告主定制”的优量汇 定投与屏蔽行业流量包，分别适用于轻度游戏（注重留存且以广告内嵌为变现形式的游戏广告主）与阅读行业（注重留存的阅读行业广告主）广告主，优化投放的后项效果指标。

2020-05-12

1. 为了更好支持广告主对全平台的创意形式做创意预览，平台新增 adcreative_template_previews/get接口，支持所有站点集合进行创意预览（包括微信朋友圈、微信公众号及小程序、优量汇、腾讯新闻、腾讯视频、移动内部站点等）。
   原 adcreative_template_preview/get 功能不变（仅支持微信站点），但功能不再演进，未来将会废弃，建议开发者及时升级切换至新接口进行使用。

2020-05-07

1. 为了提升行为兴趣定向标签列表管理、更新效率，现平台在原有行为兴趣名称管理的基础上新增支持ID方式的管理。
   涉及接口：
   创建定向（targetings/add）、更新定向（targetings/update）、获取定向（targetings/get）、创建广告组（adgroups/add）、更新广告组（adgroups/update）、获取广告组（adgroups/get）、人数预估（estimation/get）、获取定向标签（targeting_tags/get）

   涉及字段：
   1、行为（behavior） 、 兴趣（interest）定向添加两个子节点：标签ID列表（category_id_list）、关键词列表（keyword_list）。
   （targeting_tags待废弃，后续仅支持 category_id_list、 keyword_list ）
   2、获取定向接口（targeting_tags/get），应答字段新增行为兴趣标签返回类型（tag_class）便于区分行为兴趣类目（CATEGORY）、关键词（KEYWORD），当tag_class为category时，返回的id为标签id, 这个id用于category_id_list。

2020-04-29

1. 为了降低微信公众平台代理商管理子客数据的理解及操作成本，所有接口均支持使用子客的account_id进行操作，短期将继续兼容代理商使用直客account_id操作子客数据的逻辑，请及时升级。此外，本次新增了接口wechat_advertiser_specification/get及wechat_daily_cost/get，用于替换原有的wechat_advertiser_detail/get及daily_cost/get接口。这两个接口的具体功能升级点为：1）新接口将支持直客使用；2）新接口返回的account_id为子客id。。
2. 为支持批量上传广告渠道包，新增异步批量上传渠道包功能，提升渠道包上传效率。
   涉及接口：创建异步任务（async_tasks/add）、获取异步任务（async_tasks/get），新增两个任务类型（TASK_TYPE_CREATE_ANDROID_UNION_CHANNEL_PACKAGE、TASK_TYPE_UPDATE_ANDROID_UNION_CHANNEL_PACKAGE）。
   新增接口：获取广告渠道包信息（android_union_channel_packages/get）
3. 为提升自定义人群使用效率，定向用户群与排除人群使用的上限由50提升至200个。
     涉及接口：创建广告组（adgroups/add）、更新广告组（adgroups/update）、获取广告组（adgroups/get）；
     涉及字段：定向用户群(custom_audience)、排除用户群(excluded_custom_audience)

2020-04-24

1. 为了降低微信公众平台代理商管理子客数据的理解及操作成本，所有接口均支持使用子客的account_id进行操作，短期将继续兼容代理商使用直客account_id操作子客数据的逻辑，请及时升级。此外，本次新增了接口wechat_advertiser_specification/get及wechat_daily_cost/get，用于替换原有的wechat_advertiser_detail/get及daily_cost/get接口。这两个接口的具体功能升级点为：1）新接口将支持直客使用；2）新接口返回的account_id为子客id。。

2020-04-21

1. 因流量策略要求年龄定向需统一升级，涉及字段：创建广告组（adgroups/add）、更新广告组（adgroups/update）、创建定向（targetings/add）、更新定向（targetings/update）人数预估（estimation/get）中的年龄定向添加限制，min值最小值 14，最大值 66，（15、16、17不可以使用），max值最小值 18，最大值 66。

2020-04-16

1. 为满足广告主投放QQ小游戏排除已使用数据，现平台新增QQ小游戏使用定向（mini_game_qq_status），当且仅当投放QQ小游戏推广目标（promoted_object_type= PROMOTED_OBJECT_TYPE_MINI_GAME_QQ）时可以使用，涉及字段：创建广告组（adgroups/add）、更新广告组（adgroups/update）、获取广告组（adgroups/get）、创建定向（targetings/add）、更新定向（targetings/update）、获取定向（targetings/get）、人数预估（estimation/get） 。（该功能灰度开放，如有接入需求，请联系对接运营）
2. 为满足广告主使用系统优选功能优化广告效果，平台在创建广告组（adgroups/add）、更新广告组（adgroups/update）、获取广告组（adgroups/get）新增系统优选（auto_audience）能力，系统优选不支持朋友圈广告使用，（该功能灰度开放，如有接入需求，请联系对接运营同学）
   系统优选(auto_audience)和行为兴趣定向(behavior_or_interest)不能同时填写，即行为兴趣和系统优选功能二选一；
   系统优选(auto_audience)和自动扩量(expand_enabled)功能、定向包 id（targeting_id）、自定义人群(custom_audience)功能互斥

2020-04-13

1. 为了提升错误信息的准确度，现平台针对白名单类错误码进行了优化，新增白名单类错误码，并且为白名单类的错误码增加了错误体结构（errros结构）。详情可见返回码。

2020-04-08

1. 为了满足广告主对已审核通过的广告提前进行预览，现平台新增了微信公众号流量的广告预览能力，同时全流量的预览能力与投放端完全对齐。涉及接口：adcreative_previews/add， adcreative_previews/get。
2. 为了解决SDPA创意合成过程中报错不明确的问题，平台对报错逻辑进行了细化，业务请求和响应无改动，仅新增了部分错误码并对报错文案进行了细化。涉及接口：dynamic_ad_videos/add，dynamic_ad_images/add。
3. 创建广告创意(adcreative/add)、更新广告创意(adcreatives/update) 、 获取广告创意（adcreatives/get) 接口新增了优量汇下载器字段：union_market_switch。

2020-04-02

1. 为了提升客户投放的决策能力，人群预估接口（estimation/get）新增支持联盟的定向字段：移动媒体类型定向（mobile_union_category）和广告展示场景（display_scene）。

2020-04-01

1. 为了扩展客户投放能力和创意形态，支持在优量汇版位上投放试玩素材。试玩素材为广告主上传的H5页面，平台支持广告主上传视频素材+试玩素材，并在优量汇版位上展示广告。涉及的接口包括试玩素材创建（playable_pages/add）、试玩素材获取（playable_pages/get）、创建广告创意（adcreatives/add）。
2. 为了提升客户效果数据查询的效率，现平台支持微信公众平台广告主通过实时报表接口查询广告主（REPORT_LEVEL_ADVERTISER_WECHAT）、计划（REPORT_LEVEL_CAMPAIGN_WECHAT）、广告组（REPORT_LEVEL_ADGROUP_WECHAT）、广告（REPORT_LEVEL_AD_WECHAT）等维度的报表数据。其中仅创建了多创意广告的客户可查询到AD维度的报表数据。涉及接口：daily_reports/get，hourly_reports/get。
3. 为了提升客户投放朋友圈广告的体验，现平台取消部分朋友圈广告（campaign_type=CAMPAIGN_TYPE_WECHAT_MOMENTS）、激励视频广告（adcreative_template_id为559或560）投放特殊限制，具体如下：
   1. 废除adgroup层级is_rewarded_video字段。无需填写该字段即可投放激励视频广告，历史广告仍可获取该字段。建议您检查代码，废除对该字段的依赖，后续将会对该字段进行下线处理。
   2. 激励视频广告可以使用私有定向包进行广告投放(targeting id)。
   3. 朋友圈及激励视频广告选择地理位置定向（geo_location）时，所选城市范围无需处于同一城市等级，且无需按城市等级出价，统一遵循一般cpm/ocpm出价限制。
   4. targeting_tags/get接口关于城市等级(city_level)的维护将停止，您仍可获取历史数据信息。
   涉及接口包括：adgroups/add，adgroups/update，adgroups/get，targeting_tags/get。

2020-03-31

1. 为了满足广告主更精准进行流量资源投放的诉求，现平台新增微信朋友圈站点（SITE_SET_MOMENTS），当前该站点仅对部分腾讯广告账户灰度开放。
2. 为了确保客户投放朋友圈广告可以有更完善的体验，微信原生页相关的接口做了统一升级。创建微信原生页(wechat_pages/add)、删除微信原生页(wechat_pages/delete)、获取微信原生页列表（wechat_pages/get）接口支持未绑定公众号的腾讯广告账号进行操作。同时，获取微信原生页列表（wechat_pages/get）接口支持新增根据product_id、page_name进行查询的功能，返回结果新增视频/图片等素材的创建来源类型。
3. 为保持优化目标在投放平台及API名称的一致性，现对优化目标名称进行统一更新。具体改动包括：
   1）optimization_goal，deep_conversion_behavior_spec下的goal：
   OPTIMIZATIONGOAL_APP_DOWNLOAD “App安装”更名为“安装”；
   OPTIMIZATIONGOAL_APP_ACTIVATE “App激活”更名为“激活”；
   OPTIMIZATIONGOAL_APP_PURCHASE “App购买”更名为“App付费次数”；
   OPTIMIZATIONGOAL_ECOMMERCE_CHECKOUT “H5购买”更名为“H5付费次数”；
   OPTIMIZATIONGOAL_LEADS “销售线索”更名为“表单预约（微信流量）”，该优化目标后续会和非微信流量的表单预约合并成一个优化目标。
   2）Action_type 标准行为类型：PURCHASE “购买”更名为“付费”。

2020-03-26

1. 为了提升客户投放的效果，平台新增微信流量投放ocpc/ocpm广告出价策略的投放能力（目前仍在灰度中），涉及接口包括：创建广告（ads/add）、更新广告（ads/update）；涉及字段：bid_strategy。
2. 为了简化ocpa投放的流程，现平台的ocpa投放能力做了整体升级，涉及接口包括：adgroups/add，adgroups/update，adgroups/get。具体升级能力如下：
   1. 对于创建的微信站点广告，对首次付费优化目标进行了调整：
      OPTIMIZATIONGOAL_APP_PURCHASE（App 购买）调整为：OPTIMIZATIONGOAL_FIRST_PURCHASE（首次付费）
      微信流量目前均按照去重后的首次付费进行优化。调整后，不会影响现有广告播放等效果。如调用广告创建接口时，使用调整前的优化目标枚举值来创建广告（例如：OPTIMIZATIONGOAL_APP_PURCHASE），系统仍然支持创建。在广告读取接口中，用调整前的优化目标枚举值创建的广告，读取的优化目标仍为调整前的优化目标枚举值，使用调整后的优化目标枚举值创建的广告，读取的优化目标为调整后的优化目标枚举值。
   2. 新增优化目标（均灰度支持）（optimization_goal）：跳转按钮点击（OPTIMIZATIONGOAL_CANVAS_CLICK）、商品收藏（OPTIMIZATIONGOAL_ECOMMERCE_ADD_TO_WISHLIST）、有效表单提交（OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_RESERVATION）、签收（OPTIMIZATIONGOAL_PAGE_RECEIPT）、加企业微信客服（OPTIMIZATIONGOAL_PAGE_SCAN_CODE）、有效在线咨询（OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT）、有效电话拨打（OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE）。
   3. 待废弃优化目标（optimization_goal）：有效在线咨询（OPTIMIZATIONGOAL_PAGE_EFFECTIVE_ONLINE_CONSULT）、有效电话拨打（OPTIMIZATIONGOAL_PAGE_EFFECTIVE_PHONE_CALL）。
   4. 新增深度优化目标（均灰度支持）（deep_conversion_behavior_spec下的goal）：销售线索（OPTIMIZATIONGOAL_LEADS）、表单预约（OPTIMIZATIONGOAL_PAGE_RESERVATION）、有效在线咨询（OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT）、有效电话拨打（OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE）。
3. 为了满足广告主更精准进行流量资源投放的诉求，现平台新增快手站点（SITE_SET_KUAISHOU），允许单独投放快手流量。
   同时，为了更好支持开发者兼容接入此前新增的“腾讯看点”（SITE_SET_KANDIAN）以及“QQ、腾讯音乐及游戏” （SITE_SET_QQ_MUSIC_GAME）两个站点，将灰度逻辑调整为灰度后仍可投放原有的“移动内部站点”（SITE_SET_MOBILE_INNER）。请联系您的运营经理申请灰度试用的白名单权限，并配合完成升级。

2020-03-24

1. 为了拓展客户的投放能力，现平台针对微信公众平台账户开放了公众号多创意投放的能力，单个广告组可关联多个创意，同时允许更新广告状态、删除广告/创意等操作。涉及接口包括：创建广告（ads/add）、更新广告（ads/update）、删除广告（ads/delete）及创意删除（adcreatives/delete）。
2. 为了便于客户更灵活地创建及管理广告，现平台放开广告及广告创意的重名限制，即同一个账户下不同广告或广告创意允许重复。涉及接口包括：创建广告（ads/add）、修改广告（ads/update）、创建广告创意（adcreatives/add）、修改广告创意（adcreatives/update）。
3. 为了便于客户对上传视频进行预览查看，获取视频文件（videos/get）接口支持视频封面图（key_frame_image_url）的查询。
4. 为了确保腾讯广告的广告主可便利地管理及使用品牌形象，平台新增品牌形象（Brand）管理模块，涉及接口包括：创建品牌形象（brand/add）、获取品牌形象列表（brand/get）。

2020-03-23

1. 为了确保全量的微信公众平台广告主均可通过API进行投放，现平台的V1.2版本功能已全量对外。V1.2版本支持微信公众账号核心的广告投放及管理能力，且通过API创建的广告可在微信公众平台查看或编辑。具体对接方式请查看【V1.2升级指引】。

2020-03-03

1. 为了完善冷启动人群包（cold_start_audience）支持的流量覆盖以及统一对外名称，平台在原基础上新增支持微信流量使用（该能力灰度开放中）、同时名称统一升级为“扩量种子人群”。 涉及接口包括：创建广告组（adgroups/add）、更新广告组（adgroups/update）。

2020-02-21

1. 为了减少多账户重复上传人群包的问题，提高人群包管理效率，平台现新增支持基于商务管家账号进行人群包互相授权的能力。涉及接口包括：添加人群授权（audience_grant_relations/add）及获取人群授权信息（audience_grant_relations/get）。

2020-02-19

1. 为了满足微信公众平台广告主的投放诉求，现平台推出V1.2版本，支持微信公众账号核心的广告投放及管理能力，且通过API创建的广告可在微信公众平台查看或编辑。同时，本次升级您可继续使用V1.1版本号进行请求，平台会自动适配成V1.2版本请求处理，无需进行改造。具体对接方式请查看【V1.2升级指引】。