入门与指南专题介绍授权认证账号管理营销资产广告管理数据洞察人群管理数据上报辅助工具附录

V1.1更新日志

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/getwechat_daily_cost/get,用于替换原有的wechat_advertiser_detail/getdaily_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-22

  1. 为帮助广告主更为便捷获取线索管理平台的线索,现提供线索数据转发&有效状态回传能力:一方面,支持广告主获取腾讯广告和微信广告投放端来源的线索;另外一方面,跟进完成后,回传线索转化状态,其中有效状态线索可应用于广告投放优化。
    涉及的接口包括线索获取(lead_clues/get)、线索状态回传(lead_clues/update)。
  2. 为了提升广告主拉取数据报表的体验,现平台对异步任务拉取报表能力升级,新增异步报表能力,涉及接口包括(async_report_files/get, async_reports/add, async_reports/get), 异步报表接口频次控制为,每任务5分钟/1次,即5分钟内可创建1次该类型的异步任务,异步任务接口中的指标范围与实时接口指标范围一致,详细指引可参考 异步报表

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_goaldeep_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升级指引”

2020-02-18

  1. 扩量不可突破定向(expand_targeting),不可突破选项在原有年龄、性别、地域基础上新增学历(不可突破学历education仅对教育行业灰度开放使用),涉及接口包括:创建广告组(adgroups/add)更新广告组(adgroups/update)获取广告组(adgroups/get)

2020-02-17

  1. 商品库商品查询接口(product_items/get)原对外开放10个筛选条件(filtering),现仅支持1个筛选条件。

2020-02-13

  1. 为了满足广告主流量精细化运营的诉求,现白名单用户可通过新增枚举值(“SITE_SET_KANDIAN”及“SITE_SET_QQ_MUSIC_GAME”)实现单独投放或同时投放的诉求。升级内容可参考【最新通知

2020-01-16

  1. 获取 Access Token 或刷新 Access Token(oauth/token)接口返回header中Content-Type改为application/json。

2020-01-14

  1. 广告预览支持信息流与QQ、腾讯视频、腾讯新闻、优量汇等流量通过QQ号进行预览操作,涉及接口:创建广告预览( adcreative_previews/add)、获取广告预览(adcreative_previews/get )。
  2. 枫页订单数据支持微信账户广告主查询,涉及接口:获取订单数据(ecommerce_order/get)、更新订单状态(ecommerce_order/update)。
  3. 消息订阅工具新增人群包删除提醒通知,对接指引可参照【消息订阅工具】。

2020-01-08

  1. 官网在线咨询能力升级,详情可点击官网的在线咨询入口。
  2. 行为兴趣定向(behavior_or_interest)升级为行为兴趣意向定向,新增意向定向(intention)意向定向灰度中,涉及接口包括:targetings/add、targetings/update、targetings/get、adgroups/add、adgroups/update、adgroups/get、estimation/get。
  3. ocpa投放能力升级,涉及接口包括:adgroups/add,adgroups/update,adgroups/get。具体升级能力如下:
    1. 新增优化目标(optimization_goal):
      综合线索收集(OPTIMIZATIONGOAL_LEADS_COLLECT)
      首次付费(OPTIMIZATIONGOAL_FIRST_PURCHASE)
      完件(OPTIMIZATIONGOAL_APPLY)
      预授信(OPTIMIZATIONGOAL_PRE_CREDIT)
      授信(OPTIMIZATIONGOAL_CREDIT)
      提现(OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS)
      关键页面浏览(OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE)
    2. 新增深度优化目标(deep_conversion_behavior_spec下的goal):
      首次付费(OPTIMIZATIONGOAL_FIRST_PURCHASE)
      商品详情页浏览(OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE)
      授信(OPTIMIZATIONGOAL_CREDIT)
      提现(OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS)
    3. 新增优先低成本出价策略(bid_strategy):优先低成本BID_STRATEGY_PRIORITY_LOW_COST。
    4. 新增两阶段/双目标优化方式(deep_optimization_action_type):
      双目标DEEP_OPTIMIZATION_ACTION_TYPE_DOUBLE_GOAL_BID
      两阶段DEEP_OPTIMIZATION_ACTION_TYPE_TWO_STAGE_BID

2019-12-27

  1. 新增场景化用例工具,为了方便开发者快速了解 Marketing API的业务逻辑及接口调用方式,可在界面上编辑所需场景,一键生成代码用例。详见【场景化用例工具
  2. 官网接口代码用例能力升级,为降低对接门槛,所有接口的请求示例及返回示例中将提供C-url,Python两种开发语言的代码示例。更多语言正在开发中,敬请期待。

2019-12-31

  1. 开发者应用报表能力升级,支持更丰富的开发者监控指标及调用分析维度,详见【应用详情页
  2. 支持QQ账号的服务商、广告主所有业务角色的授权及操作,不同角色的权限范围与现有服务商系统及投放平台一致。

2019-12-27

  1. 新增场景化用例工具,为了方便开发者快速了解 Marketing API的业务逻辑及接口调用方式,可在界面上编辑所需场景,一键生成代码用例。详见【场景化用例工具
  2. 官网接口代码用例能力升级,为降低对接门槛,所有接口的请求示例及返回示例中将提供C-url,Python两种开发语言的代码示例。更多语言正在开发中,敬请期待。

2019-12-24

  1. “微信公众号类型定向”升级为”微信流量类型定向”(WECHAT_OFFICIAL_ACCOUNT_CATEGORY), 原有定向标识不变,新增更多微信流量类型,详见【最新通知】。
  2. 视频获取接口支持区分Marketing API上传的视频文件,涉及接口:videos/get,source_type,新增枚举值SOURCE_TYPE_API
  3. 支持获取微信公众平台广告主账号下的微信定向标签报表,涉及接口targeting_tag_wechat_reports/get
  4. 获取微信广告元数据的异步任务(TASK_TYPE_WECHAT_ADVERTISING_DATA),返回字段中新增文字链跳转信息(link_page_type\link_page_spec),详细字段请参见文档【异步任务

2019-12-17

  1. 消息订阅工具新增推广计划总预算触达警告、广告日预算触达警告、广告总预算触达警告、广告主日预算接近警告、推广计划日预算接近警告、推广计划总预算接近警告、广告日预算接近警告、广告总预算接近警告消息等内容,对接指引可参照【消息订阅工具】。

2019-12-13

  1. 支持微信公众平台的直客广告主查询消耗流水明细,涉及接口:wechat_fund_statements_detailed/get
  2. 下线未标准化的创意形式(id:65、555、486、148、710、709、541、185、502、488、351、585、680、866、193、611、487、551、184、471、473、285、470、612、184、285、194、388、382、400、394、449、515、586、703、433、494、495、879、361、574),创意形式标准化的对接指引可参考【官网指引】。

2019-12-5

  1. 支持客户批量创建或修改渠道包,可通过异步任务接口实现此诉求,涉及接口:async_tasks/add、async_tasks/get
  2. 支持客户通过渠道包查询接口获取渠道包的详情信息,涉及接口:android_channel_packages/get

2019-11-28

  1. 工作状态定向(working_status)定向能力升级,新增更多可选的工作状态标签,涉及接口estimation/get,targetings/add,targetings/update,targetings/get,adgroups/add,adgroups/update,adgroups/get

2019-11-26

  1. 定向能力升级,涉及接口estimation/get,targetings/add,targetings/update,targetings/get,adgroups/add,adgroups/update,adgroups/get,升级内容包括:
    1. 新增设备品牌定向(device_brand_model),支持对手机品牌进行定向或排除定向操作,可定向的手机品牌枚举值信息可通过“targeting_tags/get“接口进行获取。
    2. 操作系统定向(user_os)升级,iOS\ANDROID系统定向支持按“操作系统版本”进行定向。
  2. 支持微信公众号的SDPA广告投放全流程,涉及接口:adcreative_templates/get,adgroups/add,adgroups/update,adgroups/get,adcreatives/add,adcreatives/update,adcreatives/get

2019-11-19

  1. 新增定向翻译信息(targeting_translation),便于解析订单已选择定向的情况。涉及接口:adgroups/get、targetings/get
  2. 支持微信身份广告主获取广告带来的新增公众号关注信息,涉及接口wechat_ad_followers/get
  3. 消息订阅工具新增ocpa赔付账单消息及落地页风控审核结果通知消息等内容,对接指引可参照【消息订阅工具】。
  4. 部分异步任务类型创建时间间隔,由15分钟/次缩减为5分钟/2次,即5分钟内可创建2次该类型的异步任务,放开的异步任务类型范围如下:微信公众平台广告主的朋友圈广告广告组小时报表(TASK_TYPE_WECHAT_MOMENTS_ADGROUP_HOURLY_REPORT)、微信公众平台广告主的广告组小时报表(TASK_TYPE_WECHAT_ADGROUP_HOURLY_REPORT),微信公众平台广告主的广告组天报表(TASK_TYPE_WECHAT_ADGROUP_DAILY_REPORT),微信公众平台广告主的门店小时报表(TASK_TYPE_WECHAT_POI_HOURLY_REPORT)、获取微信广告元数据(TASK_TYPE_WECHAT_ADVERTISING_DATA);其他类型的异步任务创建时间间隔由15分钟/次缩减为5分钟/次。

2019-11-15

  1. 新增商品库报表能力,可支持通过天/小时维度查询商品库商品的详细数据。涉及接口product_catalogs_reports/get
  2. 针对微信公众平台的服务商客户,升级账号管理、数据查询等能力,具体包括支持查询微信服务商基本信息(wechat_agency/get)、支持查询微信服务商子客基本信息(wechat_advertiser_detail/get)、支持查询微信服务商转账充值等资金明细情况(wechat_fund_statements_detailed/get)、支持查询账户日消耗情况(daily_cost/get)。
  3. 微信账户的服务商及广告主可查询更多资金账户类型的余额情况,涉及接口wechat_funds/get

2019-11-14

  1. 图片及视频查询接口支持通过上传方式区分不同资源,涉及接口为images/get、videos/get ,涉及字段为新增过滤条件字段 source_type
  2. 支持自行创建或修改创意的分类(category)及标签(label)信息,涉及接口为adcreatives/add,adcreatives/update

2019-10-25

  1. 微信公众平台广告主身份获取微信投放端广告数据(task_type=TASK_TYPE_WECHAT_ADVERTISING_DATA)功能已全量,涉及接口 async_tasks/add
  2. 支持数据源自动绑定功能,广告主无需选择归因的数据源,系统将自动绑定,该功能灰度开放,如有接入需求,请联系对接运营同学
  3. Adgroup层级增加“additional_user_action_sets”字段,网服、电商、金融行业的广告主,可填写补充的app用户行为数据源,该功能灰度开放,如有接入需求,请联系对接运营同学
  4. 账户层级日预算每天每账号修改次数,从5次提升至10次,涉及接口advertiser/update
  5. 创意更新接口(adcreatives/update)增加修改创意、原创意继续在线播放的开关按钮(online_enabled、revised_adcreative_spec),可确保修改后的创意在审核通过前,原创意继续在线播放,有效提升创意修改的使用体验。涉及接口adcreatives/update、adcreatives/get
  6. 支持使用定向包(targeting_id)场景下,使用自动扩量能力,涉及接口:adgroups/add, adgroups/update
  7. 创意相关接口支持附加创意组件信息(component_id),可在创建广告创意时,选择添加电话(ELEMENT_TYPE_PHONE)、表单(ELEMENT_TYPE_FORM)或咨询(ELEMENT_TYPE_CONSULT)组件帮助您更高效率的收集线索,您可以通过 adcreative_templates/get 接口的 adcreative_attributes 字段查询该规格支持的组件情况。涉及接口:adcreatives/get, adcreative/add, adcreatives/update,  adcreative_templates/get

2019-9-30

  1. 非微信流量的ocpa广告现支持深度目标优化能力,该能力灰度开放中,如有接入需求,请联系对接运营同学。此功能优化涉及的接口是adgroups/add,adgroups/update,新增字段为deep_conversion_spec
  2. 获取日报表(daily_reports/get)、获取小时报表(hourly_reports/get)接口新增1个指标:时间口径(time_line)。

2019-9-26

  1. 广告投放支持使用枫页落地页,您可通过落地页拉取接口pages/get查询可使用的枫页落地页列表信息,在创建创意时使用枫页落地页进行投放。
  2. 图片信息拉取接口images/get新增图片源文件信息(source_signature)字段,深化图片素材的分析粒度。
  3. 消息订阅工具新增视频转码成功/视频转码失败消息,可实时获取视频转码的进展消息,详见【消息订阅工具

2019-9-17

  1. 新增创意形式详情信息查询接口adcreative_template_detail/get,支持查询创意形式跨站点的投放能力。

2019-9-10

  1. 获取微信公众平台广告主信息接口wechat_advertiser/get支持分页拉取数据,优化当前的接口调用效率。
  2. 获取日报表(daily_reports/get)、获取小时报表(hourly_reports/get)接口
    1. 新增2个指标:平台产品领取卡券率(platform_coupon_get_rate)及平台产品卡券点击量(platform_coupon_click)。

2019-9-9

  1. 自动扩量、不可突破定向设置方式优化,涉及接口adgroups/add, adgroups/update, adgroups/get,新增字段
    1. expand_enabled:支持通过该字段设置是否使用ocpa/cpc自动扩量能力
    2. expand_targeting:支持通过该字段设置不可突破定向内容
    3. 原有ocpa_expand_enabledocpa_expand_targetingcpc_expand_enabledcpc_expand_targeting的使用方式即将废弃
  2. 离线任务新增支持异步任务类型(task_type=TASK_TYPE_CLICK_FORWARDED_DATA_SPEC),该能力灰度开放中,如有接入需求,请联系对接运营同学
  3. 获取日报表(daily_reports/get)、获取小时报表(hourly_reports/get)、获取定向标签报表(targeting_tag_reports/get)接口
    1. 新增7个指标:游戏创建角色数量(game_create_role_count)、游戏授权量(game_authorize_count)、游戏完成新手教程量(game_tutorial_finish_count)、智能电话直拨次数(intelligent_phone_call_direct_count)、外显表单预约次数(external_form_reservation_count)、表单预约总量(=普通表单预约+外显表单预约)(total_reservation_count)、电话直拨量-转化指标(网页类)-成交前行为(page_phone_call_direct_count
    2. 一个指标即将废弃:电话直拨量(即将废弃)-转化指标(网页类)-成交前行为 (web_phone_call_direct_count
  4. images/get、videos/get 接口新增返回字段 source_type, 用以区分上传的资源来源,如“妙思”、“小视界”、“本地上传”等

2019-9-5

  1. 不再支持创建公众号类型的推广计划(campaign_type= CAMPAIGN_TYPE_WECHAT_OFFICIAL_ACCOUNTS),历史广告可以正常读取。
  2. 离线任务新增支持异步任务类型,详细指标见文档
    1. 支持微信门店小时报表查询(task_type= TASK_TYPE_WECHAT_POI_HOURLY_REPORT
    2. 微信广告组小时报表task_type=TASK_TYPE_WECHAT_ADGROUP_HOURLY_REPORT)新增40新指标
    3. 支持微信公众平台广告主账号身份获取微信投放端广告数据(task_type=TASK_TYPE_WECHAT_ADVERTISING_DATA),该能力灰度开放中,如有接入需求,请联系对接运营同事
  3. 支持商务管家账号(BM)授权,并操作商务管家账号下认领的相关账号信息
    1. 新增获取商务管家代理的广告主列表接口(business_manager_relations/get),支持获取商务管家账号下可操作的广告主信息
    2. 暂不支持操作商务管家账号下的微信公众平台广告主账号
  4. 人群相关接口支持使用微信公众平台广告主身份操作,进行人群数据上传,上传后的人群数据可在dmp平台、微信投放端进行拉取、管理。涉及接口:
    custom_audiences/add, custom_audiences/get, custom_audiences/delete,custom_audiences/update, custom_audience_files/add, custom_audience_files/get
  5. 广告主开户时 Introduction_url字段由选填变为必填,已发布。涉及接口 advertiser/add, advertiser/update

2019-7-29

  1. 开发者官网新增消息订阅工具,支持开发者自定义订阅所需要的消息类型,实时获取消息动态,详见【消息订阅工具

2019-7-19

  1. 广告组、广告创意、人数预估接口支持传入多站点(site_set)以支持投放标准化新规格,详见【规格标准化功能指引
  2. 场景定向新增广告展示场景定向(display_scene),详见【广告组 (Adgroup)】相关接口说明。
  3. 支持微信公众平台广告主查询财务信息,详见【资金账户(Fund)】相关接口说明。
  4. 支持微信公众平台广告主查询广告主信息,详见【广告帐号 (Advertiser)】相关接口说明。

2019-7-1

  1. 微信朋友圈广告支持设置广告计划层级日预算(daily_budget),具体设置规则,详见【推广计划 (Campaign)】相关接口。
  2. 微信朋友圈广告的广告组层级日预算(daily_budget),每日修改幅度由100元下调至50元,详见【广告组 (Adgroup)】相关接口。

2019-6-17

  1. 支持微信公众平台的广告主及服务商授权鉴权,详见【授权认证
  2. 支持微信公众平台广告主和服务商拉取微信广告平台投放的广告报表,详见【离线任务】相关接口。
  3. 新增微信广告线索数据拉取接口,详见【表单线索】相关接口。
  4. 支持微信公众平台广告主调用行为数据上报接口

2019-5-24

  1. 新增对比拆分实验相关接口,包括创建对比拆分实验(split_tests/add)、更新对比拆分实验(split_tests/update)、获取对比拆分实验结果(split_tests/get)、删除对比拆分实验(split_tests/delete)功能,满足广告主创建A/B test实验广告、更快获取有效的策略测试结论的需求。
  2. API不再支持拉取2年前已删除物料数据(如adgroup, campaign)信息
  3. 广告主开户行业分类切换及资质信息升级已发布
  4. 支持微信优雅大图广告(规格id:998),该规格灰度开放,如有接入需求,请联系对接渠道运营同事。

2019-5-20

  1. 支持微信视屏贴片广告(规格id: 616,617,1515 ),小程序插屏广告规格(规格id: 701),规格灰度开放,如有接入需求,请联系对接渠道运营同事。
  2. 支持微信激励视频广告(规格id: 559,560 ):
    1. 投放该规格需设置adgroup上激励视频开关(is_rewarded_video_ad),开关一经设置不可修改
    2. 当该字段取值为TRUE时,仅可选择私有定向;地理位置定向必填,且所选地域必须属于同一城市级别;出价需大于等于所选城市所在级别的最低出价;不同城市的城市级别定义与朋友圈一致,分为核心(50元/千次曝光)、重点(40元/千次曝光)、其他城市(30元/千次曝光)。

2019-5-10

  1. 预估接口(estimation/get)升级,新增支持预估日曝光,预估日覆盖,ocpa返回建议等指标。

2019-4-26

  1. 天报表(daily_reports/get)新增优量汇广告位报表(REPORT_LEVEL_UNION_POSITION),可获取指定应用在优量汇广告位的报表数据情况
  2. oCPA广告商品详情页浏览推广目标(OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE)已全量,涉及接口adgroups/add, adgroups/update

2019-4-19

  1. 场景定向(scene_spec)中开放流量包定投(union_position_package)、流量包屏蔽(exclude_union_position_package)功能。
  2. 开放优量汇流量包相关接口,包括创建优量汇流量包(union_position_packages/add)、获取优量汇流量包(union_position_packages/get)、删除优量汇流量包(union_position_packages/delete
  3. 落地页功能升级:
    1. 对于Marketing API尚不支持投放的落地页类型,统一使用枚举值page_type_unsupported进行返回, 且不支持通过API修改该落地页信息;
    2. 补全投放应用下载推广目标时(PROMOTED_OBJECT_TYPE_APP_ANDROID,PROMOTED_OBJECT_TYPE_APP_IOS),部分创意规格不支持使用PAGE_TYPE_TSA_APP落地页的限制,修复前可能导致API创建的广告在投放端无法还原的问题,此限制可通过adcreatives_templates/get接口进行获取

2019-4-1

  1. 朋友圈基础卡片样式(规格id:450)元素调整:标题(title)改为选填,描述(description)改为必填(修改前虽展示为选填,但校验逻辑为必填);
  2. 广告组日预算(daily_budget)从仅开放给朋友圈广告设置修改为所有广告均可设置。非朋友圈广告设置功能为灰度开放,如有接入需求,请联系技术支持或者对接渠道运营同事;
  3. 创建异步任务接口(async_tasks/add)新增微信朋友圈广告组小时报表任务(TASK_TYPE_WECHAT_ADGROUP_HOURLY_REPORT),可用于获取朋友圈广告特有指标,支持近30天的朋友圈报表数据的获取。新增任务灰度开放,如有接入需求,请联系技术支持或者对接渠道运营同事;
  4. 支持投放销售线索推广目标(PROMOTED_OBJECT_TYPE_LEAD_AD),可用于微信流量,功能灰度开放,如有接入需求,请线下联系技术支持人员或对接渠道运营。

2019-3-22

  1. 移动联盟(优量汇)场景定向(mobile_union)开放激励媒体选项(MOBILE_UNION_REWARDED_MEDIA);
  2. 场景定向(scene_spec)中开放优量汇流量场景屏蔽(exclude_mobile_union),可选值与移动联盟(优量汇)场景定向(mobile_union)一致;
  3. oCPA自动扩量功能支持微信流量,涉及字段:ocpa_expand_enabled、ocpa_expand_targeting
  4. 朋友圈广告的投放时间限制调整为:需大于等于 6 小时,小于等于 30 个自然日,且每天至少投放6小时,以及每天投放的时段需保持一致
  5. 修复长期投放广告无法修改开始投放日期的问题;
  6. button_text元素下线 “立即抢购” 选项,涉及规格:65,382,388,394,400,449,详情请见【最新动态】;
  7. 人群洞察接口(custom_audience_insights/get)新增用户行为(BEHAVIOR)和用户兴趣(INTEREST)的洞察维度;
  8. Marketing UI 定向组件支持custom_audience、excluded_custom_audience、financial_situation、consumption_type、wechat_official_account_category、mobile_union_category、wechat_ad_behavior定向;

2019-3-14

  1. 移动联盟(优量汇)场景定向(mobile_union)新增枚举值:MOBILE_UNION_REWARDED_VIDEO(激励视频)、MOBILE_UNION_QA_COMMUNITY(问答社区)、MOBILE_UNION_SHORT_VIDEO(短视频);
  2. 付费用户定向(paid_user)下线,详情请见【最新动态】;
  3. campaign_type 为 CAMPAIGN_TYPE_WECHAT_OFFICIAL_ACCOUNTS 的广告支持使用定向包(targeting_id);
  4. 新增客户系统状态枚举值:CUSTOMER_STATUS_FROZEN_TEMPORARILY(临时冻结),原冻结状态CUSTOMER_STATUS_FROZEN更名为封停。

2019-3-8

  1. 支持推广计划类型为CAMPAIGN_TYPE_NORMAL时,微信非朋友圈流量广告的投放(由于投放管理平台e.qq.com投放的微信流量广告均为campaign_type = CAMPAIGN_TYPE_NORMAL,如需通过eqq投放端来编辑API创建的广告,请使用CAMPAIGN_TYPE_NORMAL);
  2. daily_reports/get、hourly_reports/get、targeting_tag_reports/get接口开放指标字段新增 90 多个,具体指标请参见接口文档【广告数据洞察】相关接口;
  3. targeting_tag_reports/get接口开放市级地域报表(type = CITY);
  4. pages/get接口支持根据安卓应用id或iOS应用id(promoted_object_id)进行过滤;
  5. 微信公众号类型定向(wechat_official_account_category)的可选标签与投放管理平台进行对齐,具体取值可通过targeting_tags/get接口进行获取;
  6. 支持获取应用宝推广-换量应用(PROMOTED_OBJECT_TYPE_EXCHANGE_APP_ANDROID_MYAPP)、本地门店(PROMOTED_OBJECT_TYPE_LOCAL_ADS)广告的推广目标信息,涉及接口promoted_objects/get
  7. promoted_objects/get接口过滤条件中的values字段,屏蔽不支持枚举值,仅开放PROMOTED_OBJECT_TYPE_APP_ANDROID, PROMOTED_OBJECT_TYPE_APP_IOS, PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP, PROMOTED_OBJECT_TYPE_APP_ANDROID_UNION, PROMOTED_OBJECT_TYPE_QQ_BROWSER_MINI_PROGRAM, PROMOTED_OBJECT_TYPE_LOCAL_ADS, PROMOTED_OBJECT_TYPE_EXCHANGE_APP_ANDROID_MYAPP

2019-2-27

  1. 创建异步任务接口(async_tasks/add)支持直客广告主、子客广告主获取广告小时报表数据(TASK_TYPE_AD_HOURLY_REPORT);
  2. 新增消费类型定向(consumption_type),非朋友圈广告支持使用;
  3. adgroups/get、targetings/get接口新增字段is_include_unsupported_targeting,表示广告是否包含api不支持定向(解决由于存在不支持定向,导致拉取adgroup以及targeting报错的情况);
  4. 一个推广帐号下未删除的推广计划个数上限由2000个上调至15000个。

2019-2-18

  1. 投放朋友圈广告时,支持使用行为兴趣定向(behavior_or_interest),涉及接口 adgroups/add,adgroups/update,adgroups/get,targetings/add,targetings/update,targetings/get,estimation/get
  2. 投放非朋友圈广告时,新增资产状态定向(financial_situation)可供广告主使用,涉及接口 adgroups/add,adgroups/update,adgroups/get,targetings/add,targetings/update,targetings/get,estimation/get

2019-2-14

  1. 人数预估接口(estimation/get)支持获取oCPA广告的出价建议功能。

2019-1-30

  1. 白名单广告主可使用精准归因功能,仅需填写广告组(adgroup)层级的用户行为数据源字段(user_action_sets),原广告(ad)层级的必填字段——是否开启转化归因(conversion_tracking_enabled)将下线,不再支持关闭转化归因功能。同时,全量广告主均可使用全网归因功能,当广告组(adgroup)层级的user_action_sets字段未填写时即默认全网归因。涉及接口 adgroup/add,adgroup/update,adgroup/get,ads/add,ads/update,ads/get
  2. 婚恋状态定向( relationship_status)新增枚举值,涉及接口 adgroups/add,adgroups/update,adgroups/get,targetings/add,targetings/update,targetings/get,estimation/get

2019-1-28

  1. 投放微信流量应用下载类广告(Android应用、iOS应用),新增支持规格:117

2019-1-18

  1. 投放朋友圈广告时,定向条件中自定义地理位置列表(custom_locations)的数组最大长度由400调整为100,涉及接口adgroups/add,adgroups/update

2019-1-11

  1. 资质删除接口(qualifications/delete)支持删除已审核通过的行业资质(INDUSTRY_QUALIFICATION), 该操作会导致帐号进入待审核状态,进而导致广告下线,请谨慎操作;
  2. 对CPC广告,支持设置自动扩量(新增选填字段cpc_expand_enabled,cpc_expand_targeting);
  3. 对oCPA广告,自动扩量功能全量开放;
  4. 支持投放微信流量应用下载类广告(Android应用、iOS应用),开放规格包括:133、484、567、608

2019-1-9

  1. 新增资质接口(qualifications/add)中business_scope_id 由必填改为选填;
  2. 广告资质的最大个数限制(不包含已删除)由100提升为200;
  3. campaigns/get 接口支持搜索广告类型(CAMPAIGN_TYPE_SEARCH)的推广计划的获取;
  4. pages/get 接口支持同时获取旧版和新版的蹊径安卓、IOS、网页落地页;

2018-12-28

  1. 下线规格(规格id: 610,548,443,445,456 );

2018-12-21

  1. 新增微信公众号规格(规格id: 677 ),规格灰度开放,如有接入需求,请联系对接渠道运营同事;
  2. 地理位置定向 location_types 数组最长限制由2提升至4,最多支持4种地理位置全选,涉及接口 targetings/add, targetings/update, adgroups/add, adgroups/update, estimation/get
  3. 灰度开放以“商品详情页浏览”为优化目标的oCPA广告能力,如有接入需求,请联系对接渠道运营同事;

2018-12-14

  1. 修复 promoted_objects/get 接口渠道包拉取失败问题;
  2. 修复 adcreative/update 接口修改落地页类型时,落地页链接(page_url)未清空问题;

2018-12-05

  1. 对推广目标非应用宝推广的广告,开放CPA出价方式,具体支持规格可通过(adcreative_templates/get)接口进行查询;
  2. 腾讯视频(488 规格)新增广告主头像信息,且为必填字段;
  3. 新增腾讯视频竖版视频规格(规格id:680),规格灰度开放,如有接入需求,请联系对接渠道运营同事;

2018-11-29

  1. campaigns/get、adgroups/get、ads/get、adcreatives/get、targetings/get、promoted_objects/get、videos/get、images/get 接口支持按照创建时间( created_time)以及最后更新时间(last_modified_time)进行过滤;
  2. 创意规格获取接口(adcreative_templates/get)返回字段text_restriction结构中新增text_pattern字段,用于同步text类型元素的正则表达式规则;
  3. 支持通过资质模块(qualification)管理帐号下所有资质信息,原帐号模块(advertiser)下线资质相关字段(industry_qualification_image_id_list、ad_qualification_image_id_list),资质模块具体说明可参见【资质管理】;
  4. 下线商业兴趣定向(business_interest)、关键词定向(keyword)、APP 行为定向(app_behavior),详情请见【最新动态】;
  5. 下线优量汇规格(115、207、208、212)、应用宝规格(261、262),详情请见【最新动态】;

2018-11-22

  1. 获取定向信息接口(targetings/get)支持读取地域定向(region),该定向仅支持读;
  2. CPA出价对应的 billing_event 枚举值调整为 BILLINGEVENT_APP_DOWNLOAD
  3. 朋友圈常规样式支持文案换行,涉及规格id:263、310、311、618、641、642、643、644、645、646、647、648、649
  4. 朋友圈规格示意图更新,涉及规格id:263、310、311、450、452、588、589、618
  5. 异步任务接口(async_tasks/add)新增任务类型TASK_TYPE_BATCH_REQUEST,目前仅支持批量操作product_items/update,该功能灰度开放,如有接入需求,请联系对接渠道运营同事;

2018-11-14

  1. 绑定公众号接口(authorization/wechat_bind)支持传入微信公众号,扫码时进行公众号一致性校验;
  2. 广告预览接口(adcreative_previews/add)错误信息返回不满足条件的受众id;

2018-10-30

  1. 更新广告主信息接口(advertiser/update)对已审核通过的广告帐号禁止修改公司名称(corporation_name)、营业执照(certification_image_id)、法人身份证(individual_qualification)字段;
  2. advertiser/addadvertiser/update接口的行业资质(industry_qualification_image_id_list)、广告资质(ad_qualification_image_id_list)支持的最大个数由15调整为256
  3. 居住社区价格定向(resident_community_price)的可选值优化;
  4. 开放微信oCPA广告投放能力,详情请见【oCPA广告】;
  5. 新增朋友圈多图规格(规格id:641~649),分别为,如有接入需求,可通过【创意规格查询工具】进行了解;
  6. 新增QQ购物画报规格(规格id:603),规格灰度开放,如有接入需求,请联系对接渠道运营同事;

2018-10-23

  1. 地理位置定向行政区划编码更新,详情请见【最新动态】;
  2. 绑定公众号接口(authorization/wechat_bind)开放公众号与广告帐号的绑定限制,支持一个公众号被多个广告帐号绑定;
  3. 一个广告帐号下未删除推广计划、广告组、广告、广告创意数量分别调整为15000、20000、100000、50000;一个推广目标id关联的广告组数量以及一个定向id关联的广告组数量调整为20000;
  4. 支持推广目标为QQ消息(PROMOTED_OBJECT_TYPE_QQ_MESSAGE)的广告使用oCPA能力;
  5. 广告创意接口开放multi_share_optimization_enabled属性字段;
  6. 新增QQ购物视频规格(规格id:433、435),规格灰度开放,如有接入需求,请联系对接渠道运营同事;

2018-10-11

  1. 行为兴趣定向(behavior_or_interest)全量开放;
  2. 朋友圈广告支持同时使用简易原生页和小程序落地页全量开放。

2018-09-26

  1. campaigns/get、adgroups/get、ads/get、adcreatives/get、targetings/get接口支持获取已删除对象信息,即当根据对象id进行查询时,即使对象id已经删除,仍可查询该对象信息;
  2. campaigns/get、adgroups/get、ads/get、adcreatives/get、targetings/get接口返回list结构中新增字段 is_deleted,用于标注查询对象是否被删除;
  3. capabilities/get接口返回字段改为 wechat_ecommerce_product_spec、wechat_link_ad_spec结构,分别表示朋友圈电商推广能力,微信网页推广投放能力的查询结果;
  4. 支持投放电商推广(PROMOTED_OBJECT_TYPE_ECOMMERCE)广告时,使用tracking功能;
  5. 移动联盟(优量汇)原生视频规格(规格id:351)图片尺寸、视频最小尺寸、视频时长调整,详情请见【最新动态】;
  6. 新增QQ购物画报图文规格(规格id:624),规格灰度开放,如有接入需求,请联系对接渠道运营同事;
  7. 沙箱与API调试工具提供沙箱帐号在线申请入口,并展示沙箱帐号信息。

2018-09-20

  1. 创意规格查询接口(adcreative_templates/get)返回内容新增支持的落地页信息(support_page_spec)字段,并变更了部分支持的规格、站点、推广目标;
  2. 所有接口响应头新增字段(X-RateLimit-Remaining)用于返回本次请求后的接口剩余的频次比例信息;
  3. 下线腾讯网频道内容页文字链规格(规格id:202);
  4. 创意规格查询工具支持查询Marketing API V1.1版本支持的规格信息。

2018-09-13

  1. V1.1 版本发布。