接口文档SDK业务专题开发者工具

更新日志

2023-10-16

  1. 财务查询接口新增3个资金账户,FUND_TYPE_SHORT_PLAY_GIFT,FUND_TYPE_GAME_CHARGE_INDIRECT_REWARDS_GIFT,FUND_TYPE_GAME_CHARGE_DIRECT_REWARDS_GIFT
  2. fund_statements_daily/get接口将要下线,请尽快迁移到 daily_balance_report/get

    2023-09-07

  3. 新增获取创意示例商品列表能力
  4. 添加错误码1800113:「账户服务异常」,原有的350003错误码变更为1800113错误码,代表账户服务系统异常,遇到后可以通过重试解决。

    2023-08-29

  5. 支持获取广告申诉复审配额
    • 涉及接口:ad_appeal_quota/get

      2023-08-18

  6. 添加错误码12806:「服务接口超时」,原有的10000错误码会包含超时的报错,现将超时的报错与10000拆分开。

    2023-08-08

  7. 支持广告发起申诉复审
    • 涉及接口:review_ad_appeal/add
    • 涉及接口:review_ad_appeal/get

2023-05-15

  1. 代理商与子客间转账接口,服务商转账给子客,新增high_frequency_transfer参数,不传默认老逻辑
    • 涉及接口:fund_transfer/add

2023-05-10

  1. 财务接口支持新增合约信用资金账户
  • FUND_TYPE_CONTRACT_CREDIT
    • 涉及接口:funds/get
    • 涉及接口:fund_statements_detailed/get
    • 涉及接口:daily_balance_report/get

2023-04-19

  1. 腾讯广告账户报表指标升级
  2. 支持查询广告账号是否为"附近推"
  3. 广告帐号、资质接口逐步废弃微信相关字段

2023-04-11

  1. 接口支持mp账号
    • 涉及接口:daily_balance_report/get,merge_fund_type_funds/get,merge_fund_type_daily_balance_report/get,merge_fund_type_fund_statements_detailed/get,realtime_cost/get
  2. 封停和冻结账户支持调用
    • 涉及接口: funds/get,fund_statements_daily/get,daily_balance_report/get,fund_statements_detailed/get,realtime_cost/get,agency_realtime_cost/get,merge_fund_type_funds/get,merge_fund_type_daily_balance_report/get,merge_fund_type_fund_statements_detailed/get
  3. 封停和冻结的账户支持子客回划代理商,但不支持代理商向子客转账
    • 涉及接口: fund_transfer/add
  4. 部分接口将下线
    • 涉及接口:wechat_funds/get,wechat_fund_statements_detailed/get

2023-04-11

  1. 在 leads_clues/get 接口里增加 owner_id 的返回值。

2023-03-30

  1. 账号管理资金账户接口升级,支持mp账号查询
    • 涉及接口:fund_statements_detailed/get
    • 涉及接口:funds/get
  2. 财务接口支持新增资金账户,下线部分资金账户
    • FUND_TYPE_TEST_VIRTUAL,FUND_TYPE_TCC_GIFT,FUND_TYPE_GIFT_RESTRICT
      • 涉及接口:merge_fund_type_subcustomer_transfer/add
      • 涉及接口:merge_fund_type_funds/get
      • 涉及接口:merge_fund_type_daily_balance_report/get
      • 涉及接口:merge_fund_type_fund_statements_detailed/get
    • FUND_TYPE_TEST_VIRTUAL,FUND_TYPE_TCC_GIFT,FUND_TYPE_GIFT_RESTRICT,FUND_TYPE_DEBT_FIXED,FUND_TYPE_DEBT_TEMP
      • 涉及接口:funds/get
      • 涉及接口:fund_statements_detailed/get
      • 涉及接口:daily_balance_report/get
      • 涉及接口:subcustomer_transfer/add
    • FUND_TYPE_MP_CASH,FUND_TYPE_MP_BANK,FUND_TYPE_MP_GIFT将不再使用

2023-03-17

  1. 支持更新广告账户的营业执照号

2023-03-14

  1. 支持获取一个账户下的通话结果

2023-03-10

  1. 添加素材库标签应用
  2. 支持获取可设置最低的竞价广告账户日预算
  3. 支持获取中间号
  4. 支持获取通话结果
  5. 查询关键词流量

2022-11-22

  1. 原生页-基于组件创建落地页接口,新支持图文复合组件、全局侧边悬浮组件.
  2. 新增广告管理二级导航关键词
  1. 新增广告管理二级导航否定词
  2. 新增关键词搜索词报表
  3. 创意组件
  4. 微信公众号账户升级
  5. API新增支持视频号授权及管理能力,并支持通过API完成商品推广、应用推广、销售线索收集等推广目标在视频号版位的广告创建、编辑。具体对接方式请查看视频号版位 MKTAPI 对接指引

2022-09-27

  1. 广告应用分包
  2. 蹊径新增衍生API-支持生成点击特性
  3. 商品库-接口account_id字段支持传入bm_id调用
  4. 蹊径新增衍生API-支持生成虚拟人

2022-09-09

  1. 商品库-商品系列添加接口支持marketing-api调用
  2. 广告组-获取广告组接口,过滤条件中当field取值campaign_id时,枚举列表增加IN

2022-09-09

  1. 蹊径新增号码包API。

2022-07-18

  1. 原生页-基于组件创建落地页接口,支持添加商家微信组件
  2. 原生页-获取企业微信组件客服接口,支持crop_id查询

2022-07-14

  1. 原生页-基于组件创建落地页接口,支持关注公众号组件

2022-7-01

  1. 新增推广目标微信公众号
    • 推广目标增加枚举:微信公众号(PROMOTED_OBJECT_TYPE_WECHAT_OFFICIAL_ACCOUNT)
      • 涉及字段:promoted_object_type
      • 通过api投放的客户,仍需先在投放端中进行公众号绑定。绑定入口:ADQ投放端-工具-微信生态授权管理-公众号授权
      • 涉及接口:获取推广目标promoted_objects/get,创建广告组adgroups/add,获取广告组adgroups/get,创建广告创意adcreatives/add,获取广告创意adcreatives/get

2022-06-27

  1. 广告诊断结果获取接口更新应答字段类型
    • 涉及接口:广告诊断结果获取(ad_diagnosis/get)
    • 涉及字段:list.detail.funnel 下的 targeting_wideness_ratecompete_win_rateexposure_countctrcvrcpa
      • value,由 float 类型变更为 string
      • score,由 float 类型变更为 string
      • rank_category,由 float 类型变更为 string
      • rank_second_category,由 float 类型变更为 string
      • rank_overall,由 float 类型变更为 string

2022-06-16

  1. 原生页-基于组件创建落地页接口,支持跳转小程序组件

2022-05-26

  1. 蹊径模板创建落地页接口,支持表单id参数传入

2022-05-25

  1. 财务接口支持新增的资金账户:FUND_TYPE_MP_GAME_DEVELOPER_WORKING_FUND,FUND_TYPE_MP_GAME_DEVELOPER_GIFT,FUND_TYPE_FLOW_SOURCE_AD_FUND,FUND_TYPE_ANDROID_ORIENTED_GIFT,FUND_TYPE_LOCATION_PROMOTION_REWARDS
    • 涉及接口:fund_statements_daily/get
    • 涉及接口:daily_balance_report/get
    • 涉及接口:fund_statements_detailed/get
    • 涉及接口:funds/get
    • 涉及接口:fund_transfer/add
    • 涉及接口:subcustomer_transfer/add
    • 涉及接口:merge_fund_type_subcustomer_transfer/add
    • 涉及接口:merge_fund_type_funds/get
    • 涉及接口:merge_fund_type_daily_balance_report/get
    • 涉及接口:merge_fund_type_fund_statements_detailed/get
  2. 京东增加新的代理商ID:23849329,23385365
    • 涉及接口:fund_transfer/add

2022-05-17

  1. 代理商与子客间转账接口,子客回划新增transfer_try_best参数,不传默认老逻辑
    • 涉及接口:fund_transfer/add

2022-05-17

  1. 添加自动生成创意应用

2022-05-09

  1. 广告主日预算限额修改策略优化,增加按日消耗比例限制
    • 涉及接口:advertiser/update

2022-05-05

  1. 创建转化归因接口升级,新增快应用、企业微信转化场景
    • 涉及接口:conversions/add,conversions/get
    • 新增转化场景:CONVERSION_SCENE_QUICK_APP,CONVERSION_SCENE_WE_COM

2022-04-27

  1. 添加腾讯广告服务商子客,支持地域信息字段
    • 涉及接口:advertiser/add
  2. 更新腾讯广告广告主信息,支持地域信息字段
    • 涉及接口:advertiser/update
  3. 查询腾讯广告广告主信息,支持返回地域信息字段
    • 涉及接口:advertiser/get

2022-04-25

  1. 创建转化归因接口升级,支持微信小程序不带点击监测的转化创建
    • 涉及接口:conversions/add
  2. 创建转化归因接口升级,支持曝光归因
    • 涉及接口:conversions/add conversions/get
    • 新增字段:
      • impression_feedback_url:曝光监测链接
      • attribution_window:曝光归因窗口期
    • 更新内容:
      • claim_type:新增曝光归因 CLAIM_TYPE_IMPRESSION

2022-04-24

  1. 资质管理接口升级,支持广告资质批量删除
    • 涉及接口:qualifications/delete
  2. 资质管理接口升级,创建广告资质个数限制调整到500个
    • 涉及接口:qualifications/add

2022-04-21

  1. 账号管理资金账户接口升级,增加用户灰度校验逻辑
    • 涉及接口:fund_statements_daily/get
    • 涉及接口:daily_balance_report/get
    • 涉及接口:fund_statements_detailed/get
    • 涉及接口:funds/get
    • 涉及接口:subcustomer_transfer/add
  2. 账号管理资金账户接口,新增支持合并资金类型接口
    • 资金合并类型同商务管家子客间转账:merge_fund_type_subcustomer_transfer/add
    • 获取资金合并类资金账户信息:merge_fund_type_funds/get
    • 获取资金合并类资金账户日结明细:merge_fund_type_daily_balance_report/get
    • 获取资金合并类型资金流水:merge_fund_type_fund_statements_detailed/get

2022-04-07

  1. 创建转化归因接口升级,支持传入转化链路ID
    • 涉及接口:conversions/add conversions/get
    • 新增字段:
      • conversion_link_id:转化链路ID

2022-03-31

  1. 新增推广目标快应用(该功能灰度中)

2022-03-14

  1. 支持元素粒度审核结果预审

2022-03-01

  1. 支持按月获取账户无效线索赔付信息

2022-02-24

  1. 线索拉取接口增加返回广告/广告创意信息,替换之前有混淆概念的创意信息(creative_id和creative_name),与投放端/Marketing API 对齐。

2022-02-09

  1. 支持修改流量包内的广告位,新增修改流量包接口[union_position_packages/update]

2022-01-14

  1. 蹊径支持查询模板列表。
  2. 蹊径支持获取互动模板配置。

2021-12-15

批量操作接口操作结果应答信息中增加返回操作对象的id信息

2021-11-30

外部线索基本信息更新接口支持更新线索的门店名称

2021-11-19

  1. 线索拉取接口增加请求参数time_type
    • 涉及接口:获取线索列表(lead_clues/get)
    • 升级:
      • 增加请求参数time_type,支持选择使用线索提交时间/线索创建时间作为时间范围筛选数据

2021-10-26

获取广告组接口过滤条件支持通过广告状态筛选,查询时需要在filtering字段中把field指定为status。

2021-10-20

  1. 对于已经创建的待审创意,我们现在可以支持创意的催审。需联系运营来开通催审权限。

2021-09-27

Marketing API支持批量操作相关能力,但此前操作执行后,未直接反馈执行失败的对象id,需要客户自行处理,现为提升客户使用效率,对相关接口进行升级, 相关接口返回信息增加返回字段:fail_id_list,请求时获取该字段即可获取该次请求失败的对象id范围

  • 更新广告主日限额信息:advertiser/update_daily_budget
  • 更新推广计划状态:campaigns_update_configured_status
  • 更新推广计划日限额信息:campaigns_update_daily_budget
  • 更新广告组状态:adgroups_update_configured_status
  • 更新广告组出价:adgroups_update_bid_amount
  • 更新广告组日限额信息:adgroups_update_daily_budget
  • 更新广告组投放时间:adgroups_update_datetime
  • 更新广告状态:ads_update_configured_status

2021-09-24

  1. 线索拉取接口升级
    • 涉及接口:获取线索列表(lead_clues/get)
    • 升级:
      • 请求参数支持使用线索转化状态(leads_convert_type)过滤线索
      • 线索来源增加枚举:教培通(JIAOPEITONG)
  2. 为提升优量汇场景定向效果,我们新增支持「优量汇自动流量优选」功能,自动优选优量汇媒体流量,结合广告主投放目标与行业特性,开启后策略动态优化广告投放效果。(仅支持优量汇版位使用,且不能和优量汇行业精选流量包(mobile_union_industry)或优量汇媒体类型场景定向(mobile_union_category)同时使用)。

2021-09-16

由于业务高速发展,图片和视频数量快速增长,图片和视频ID取值将突破32位符号整数的取值范围2^31-1(2147483647)。因此,为了避免ID增长给您的系统带来越界异常,请务必排查您的系统是否正常支持,同时为了避免json在大整数处理上的限制,我们将确保大整数不超过2^53-1(9007199254740991) 。 请各位开发者及早配合完成id越界值检查,腾讯广告平台侧预估即日起,将会有下述涉及到的id字段会产生超过32位的边界值。 涉及字段:image_id,video_id

2021-09-16

  1. 为提升优量汇场景定向效果,我们计划下线优量汇媒体类型场景定向(mobile_union_category)和优量汇行业精选流量包(mobile_union_industry),即2021年10月29日后不支持广告的新建和编辑,历史存量投放中广告不影响。请您及时切换,避免影响您的广告营销投放。

  2. 移动媒体类型定向(mobile_union_category)同步下线,这里将于2021年10月29日不再不支持广告的新建和编辑,历史存量投放中广告不影响。请您及时切换,避免影响您的广告营销投放。

2021-08-25

  1. 【知数-数据源】支持API回传属性数据,目前DMP web端已上线属性数据回传的功能,暂不支持API回传属性数据。 为提升广告主批量上传属性数据的效率,降低操作成本。对于只支持API交互的广告主,使得他们可以回传属性数据, 新增以下接口

2021-08-18

  1. 为提升流量包定向效果,已经在2020年7月6日对定投流量包与屏蔽流量包进行合并,升级为行业精选流量包(mobile_union_industry),现将对定投流量包 “mobile_union”及屏蔽流量包“exclude_mobile_union”下线,于2021年8月19日开始逐步下线,2021年8月31日下线完毕,请及时更换流量包字段及枚举值,避免定投与屏蔽流量包下线后出现报错。

2021-08-03

  1. 为了拓展新链路支持场景,缩小新链路切换卡点,转化归因接口(conversions/add)支持微信小游戏及QQ小游戏推广目标。 更新内容:
  • conversion_scene字段:新增微信小游戏CONVERSION_SCENE_WECHAT_MINI_GAME及QQ小游戏CONVERSION_SCENE_QQ_MINI_GAME
  • claim_type:新增注册归因CLAIM_TYPE_REGISTER 备注:微信小游戏仅支持注册;QQ小游戏仅支持点击
  • promoted_object_id:支持微信小游戏及QQ小游戏的appid

新版转化归因小游戏类型接入详见文档:https://developers.e.qq.com/docs/guide/conversion/new_version/Mini_Game_api

2021-07-23

  1. 线索增加互动落地页来源

2021-07-09

  1. 蹊径-获取蹊径落地页模板,支持页面级deeplink。
  2. 蹊径-基于模板创建落地页,支持页面级deeplink。
  3. 蹊径-基于组件创建落地页,支持页面级deeplink。

2021-07-01

  1. 为支持客户按照不同的生命周期营销场景进行投放,接口新增营销场景字段marketing_scene。目前已支持的营销场景为新游预约、新游首发、日常投放,详细使用规则请查看营销场景使用指引

2021-06-07

  1. 广告渠道包接口升级

2021-06-07

  1. 转化归因接口升级

2021-06-02

  1. 外部线索导入接口升级

    • 涉及接口:外部线索导入(outer_clues/add)
    • 升级1:新增支持多种方式匹配线索管理平台已沉淀的线索
      • 请求增加字段:match_type、leads_id
      • 返回增加字段标记成功/失败的线索:index
    • 升级2:新增支持标记线索渠道
      • 请求增加字段:outer_leads_comefrom
  2. 外部线索回传接口新增支持多种方式匹配线索管理平台已沉淀的线索

  3. 外部线索基本信息更新接口新增支持多种方式匹配线索管理平台已沉淀的线索

2021-04-30

  1. 支持元素审核预审

2021-04-21

  1. 渠道包查询能力升级
  • 新增接口获取推广渠道包(app_android_channel_packages/get),可支持拉取所有安卓类型的渠道包,包括应用宝渠道包、广告渠道包等;
  • 原获取推广目标接口[promoted_objects/get]为了提升性能,将于5月20号限制渠道包详细信息列表(channel_package_spec)参数只返回99个渠道包,请在5月20号前切换使用新接口获取推广渠道包(app_android_channel_packages/get)进行查询。

2021-04-13

  1. 支持更新客资的归因信息
  2. 外部线索导入接口升级
    • 涉及接口:外部线索导入(outer_clues/add)
    • 升级:
      • 线索类型增加枚举:加微信关注(LEADS_TYPE_PROMOTION_FOLLOW)
      • 请求增加字段:memo、campaign_id、adgroup_id、wehat_agency_id
      • 增加返回结构:success_lead_id_list
  3. 外部线索基本信息修改接口升级

2021-04-12

  1. 蹊径-获取蹊径落地页模板,支持返回剪贴板。
  2. 蹊径-基于模板创建落地页,支持剪贴板。

2021-03-31

  1. 蹊径支持创建互动落地页。
  2. 蹊径查询落地页接口升级。
    • 涉及接口:xijing_page_list/get
    • 新增参数:query_type,可选参数,用于指定落地页查询的范围

2021-03-29

  1. 优量汇流量包创建接口[union_position_packages/add] 推广目标类型(promoted_object_type)参数改为选填

2021-03-18

  1. 蹊径-基于组件创建落地页,支持剪贴板。

2021-03-17

  1. 支持更新客资的基础信息
  1. 获取线索列表接口升级
  • 涉及接口:获取线索列表(lead_clues/get)
  • 升级:
    • 线索类型增加枚举:加企业微信客服(LEADS_TYPE_PAGE_SCAN_CODE)
    • 增加返回字段:leads_user_wechat_appid
  1. 外部线索导入接口升级
  • 涉及接口:外部线索导入(outer_clues/add)
  • 升级:
    • 线索类型增加枚举:加企业微信客服(LEADS_TYPE_PAGE_SCAN_CODE)
    • 线索导入联系信息必须填写:leads_user_id、leads_tel、leads_qq、leads_wechat至少填写一个
  1. 外部线索回传接口升级
  • 涉及接口:获取线索列表(outer_clues/update)
  • 升级:
    • 参数调整:参数operator_account_id修改为account_id,去除outer_leads_conversion_status_list数组中的参数account_id

2021-03-16

  1. 微信原生页支持企业微信组件
  • 详见接口:创建微信落地页
  • 变动内容: 请求参数新增page_elements_spec_list/button_spec/wecom_spec节点
  1. 新增获取企业微信客户组接口

2021-03-05

  1. 批量异步请求任务相关接口新增批量修改广告组一键起量状态。

2021-03-03

  1. 优量汇流量包创建接口[union_position_packages/add] 支持的最大广告位id(union_position_id_list)个数由 500 提升至 2000

2021-01-29

  1. android_channel_packages/get、android_union_channel_packages/get 接口支持按照渠道包 id (channel_package_id) 和 渠道包名称 (package_name) 进行过滤。
  2. 应用宝渠道包-获取应用宝渠道包接口,返回字段新增package_download_url。

2021-01-28

  1. 修改 Marketing Api 创意工具 “获取订单视频列表"
    • 涉及接口:获取订单视频列表[creative_customization_video/get]
    • 涉及字段:新增 'video_image_url', 'preview_url'

2021-01-28

  1. 新增获取广告标签接口

2021-01-27

  1. 新增生成视频封面图接口
  2. 创建智能调整任务接口升级

2021-01-26

  1. 新增外部线索导入接口和外部线索回传接口
  1. 获取线索列表接口升级
  • 涉及接口:获取线索列表(lead_clues/get)
  • 涉及字段:outer_leads_id、leads_user_id、leads_user_type、outer_leads_convert_type、outer_leads_ineffect_reason
  1. 线索类型增加枚举:在线咨询(LEADS_TYPE_ONLINE_CONSULT)、普通电话(LEADS_TYPE_MAKE_PHONE_CALL)
  1. 线索来源枚举CHEXUNDA改为XUNDA

2021-01-25

  1. 批量异步请求任务相关接口新增以下能力(暂不支持微信公众平台广告主账号):
    • 推广计划:批量修改推广计划客户设置的状态、日预算、
    • 广告组:批量修改广告组深度优化价值的期望 ROI、客户设置的状态、日预算
    • 广告:批量修改广告客户设置的状态
    • 广告创意:修改广告创意应用直达页 URL

2021-01-18

  1. 蹊径-查询落地页列表接口,查询参数支持app_type和app_id,返回字段新增playable_type,reject_reason,publish_url, publish_app_id, unpublish_app_id

2021-01-07

  1. 为提高定向包投放效率,单个定向包支持分享至同商务管家(BM)账户、同公司主体账户;(功能灰度开放使用)
    • 涉及接口: targetings_share/add(定向包分享单个账户);
    • 涉及接口: batch_async_requests/add-targetings_share_spec(创建批量异步任务)接口支持定向包批量分享,最大支持定向包分享100个账户;
    • 涉及接口: targetings_share/get(获取定向包分享记录);
    • 涉及接口: targetings/get 获取其他账号分享给我的定向包信息。

2020-12-28

  1. 蹊径-查询落地页列表接口,返回字段新增page_owner_id

2020-12-22

  1. 广告状态展示逻辑升级,对齐投放端广告状态展示及计算逻辑
    • 涉及接口:获取广告组adgroups/get
    • 涉及字段:status

      2020-12-01

  2. Marketing Api 创意工具 新增“获取广告主订单列表”和“获取订单视频列表"
    • 涉及接口:获取广告主订单列表[creative_customization_order/get]
    • 涉及接口:获取订单视频列表[creative_customization_video/get]

      2020-11-18

  3. Marketing Api 创意工具 新增“视频加字幕”和“创意工具通用接口”以及"智能调整"
    • 涉及接口:创建视频加字幕任务[videomaker_subtitles/add]
    • 涉及接口:创意工具通用接口[videomaker_tasks/get]
    • 涉及接口:创建智能调整任务[videomaker_autoadjustments/add]

2020-11-17

  1. 获取广告组接口、获取推广目标接口已支持获取微信小游戏id

2020-11-16

  1. 支持获取同主体/同商务管家的账户信息
  2. 蹊径-查询落地页列表接口,支持查询【授权落地页】
  3. 微信落地页新增组件类型:上划WEBVIEW组件(SWIPE_WEBVIEW)、WEBVIEW组件(WEBVIEW)

2020-11-04

  1. 批量异步请求任务相关接口新增批量修改推广计划投放速度模式、删除推广计划、删除广告组、删除广告能力(以上新增能力暂不支持微信公众平台广告主账号)

2020-10-22

  1. 批量异步请求任务相关接口新增批量修改广告组安卓应用渠道包 id能力。

2020-10-20

  1. 为便于广告主精准定向新版iOS操作系统(iOS14版本),我们user_os定向新增支持了 IOS_VERSION_14 枚举值。
    • 涉及接口:广告组adgroups/add、 adgroups/update、adgroups/get
    • 涉及接口:定向接口targetings/add、targetings/update、targetings/get
    • 涉及接口:预估覆盖人数estimation/get

2020-10-19

  1. 为便于广告主高效修改广告,新增批量修改出价策略、深度优化目标出价、定向包、优量汇流量包能力。

2020-10-14

  1. Marketing Api 提供全新的微信附近推功能。

2020-09-29

  1. 为便于广告主投放广告时,可通过API获取广告文案,提供获取文案列表接口。
  1. 整合文案工具一级导航栏,将图片处理与广告素材预审切换到文案工具一级导航栏中。
  1. 为满足广告主的投放诉求,API增加图片&视频的修改标题接口。
  • 涉及接口:[图片标题修改接口(images/update)](/docs/api/business_assets/image/images_update) [视频标题修改接口(videos/add)](/docs/api/business_assets/video/videos_update)
  • 涉及字段:description

2020-09-28

  1. 为便于广告主轻松理解广告蹊径文档概念,对部分接口字段表现及说明调整,
  • 涉及接口: xijing_page/add,xijing_template/get,xijing_page_by_components/add

2020-09-16

  1. Marketing Api 提供获取行业信息接口。

2020-09-15

  1. 线索类型增加枚举:落地页点击(LEADS_TYPE_LANDING_PAGE_CLICK)

2020-09-14

  1. 为满足广告主的投放诉求,微信小游戏推广目标(PROMOTED_OBJECT_TYPE_MINI_GAME_WECHAT)相关接口兼容升级,同时支持小游戏appid和小游戏原始id
  • 涉及接口:创建广告组(adgroups/add),创建广告创意(adcreatives/add)
  • 涉及字段:promoted_object_id

2020-09-07

  1. 为了满足广告主通过外显好友关系链及转化数据,辅助用户决策,提升转化效果的诉求,现平台新增了微信应用下载数据量和行动按钮转化数据在创意形式下展示的能力,同时微信的数据展示能力与投放端完全对齐 。

2020-09-03

  1. 蹊径-基于组件创建落地页,新增支持试玩组件。

2020-09-01

  1. 为便于广告主更新通过url创建的广告渠道包,营销资产 - 广告渠道包新增更新url广告渠道包接口。

2020-08-27

  1. 为丰富朋友圈落地页形态、提升落地页转化效果。腾讯广告针对安卓推广目标下(PROMOTED_OBJECT_TYPE_APP_ANDROID)支持简版原生页、文字链支持跳转自定义。

2020-08-26

  1. 为便于广告主投放附加创意-表单广告时,可通过API进行管理附加创意组件的创建与获取,提供表单组件创建leads_form/add 表单组件详情获取leads_form/get ,表单组件列表获取leads_form_list/get接口batch_async_requests/add

2020-08-25

  1. 在创意创建,更新,获取接口上增加一个字段标识原生页头部素材和创意素材之间的替换关系

2020-08-11

  1. 为便于广告主回传线索数据,线索回传接口增加支持回传线索评分。
  • 涉及接口:回传有效线索(lead_clues/update)
  • 涉及字段:leads_convert_type改为非必填,leads_ineffect_reason枚举值修复拼写错误,增加请求参数leads_intention_score
  1. 为满足部分广告主需求,获取线索列表接口增加返回线索标签。

2020-08-11

  1. 为便于广告主更好的分析商品广告投放效果,对商品报表能力进行升级。新商品报表自发布之日起开始产生数据,原商品报表接口将会逐步废弃 product_catalogs_reports/get,建议迁移至新的报表数据中进行查看(该功能灰度开放,具有dpa投放能力的广告主可以使用)。 使用方式如下
  • 涉及接口:daily_reports/get, async_reports/add
  • 涉及层级:REPORT_LEVEL_PRODUCT_CATELOG
  • 查看规则:
    • filtering:必填,必须指定商品库id(product_catalog_id),每次只能获取指定商品库的报表信息
    • group_by:非必填,不指定时默认获取商品库,在整账号下的数据详情
      • 按商品信息层级聚合:单选,支持按如下层级聚合,商品id(product_outer_id ) ,商品系列(product_set_id ),品牌id(brand_id ),店铺id(shop_id ),一级类目id(first_category_id ), 二级类目id(second_category_id ),三级类目id(third_category_id ),如获取商品系列的整账户表现,可指定group by product_set_id
      • 按数据层级聚合:单选,支持按如下数据层级聚合,账户(不指定时默认为账户),计划(campaign_id),广告组(adgroup_id),广告(ad_id),例如希望获取计划层级的商品库报表,可指定group by campaign id
      • 按商品信息层级(单选)x数据层级(单选)聚合进行,例如希望获取商品*计划粒度的报表数据,可指定groupby product_outer_id campaign id
    • 商品报表仅支持查看指定商品库下,单日花费最高的10000条商品的效果数据
  1. 获取落地页列表接口支持商品库id(product_catalog_id)和 推广目标id(promoted_object_id)作为过滤条件
    • 当且仅当推广目标为PROMOTED_OBJECT_TYPE_ECOMMERCE时,才可选择根据promoted_object_id和product_catalog_id进行过滤
    • 涉及接口: pages/get

2020-08-07

  1. 提供蹊径落地页查询接口

2020-08-05

  1. API新增bid_mode字段,方便广告主更容易的理解出价方式。
    • 涉及接口:adgroups/add、adgroups/update、adgroups/get、adcreative_template_detail/get、adcreative_templates/get

2020-08-03

  1. 增加小店推商品列表接口,用来给微信小程序获取广告商品。
  2. 新增预估能力-出价曝光预估接口。
  • 涉及接口: bid_simulation/get

2020-07-23

  1. 为便于广告主更多维度的分析广告投放效果,API异步报表接口新增创意形式级别报表(REPORT_LEVEL_CREATIVE_TEMPLATE)。

2020-07-23

  1. marketing-api新增获取商品类目接口,该接口根据广告主id和商品库id来获取商家类目。
    • 涉及接口:product_categories_list/get

2020-07-22

为了广告主更方便地查询商务管家帐号下的广告主信息,增加account_type返回字段,表示该广告主是腾讯广告账户或者微信MP广告账户。需要在查询时,fields字段中增加account_type。

2020-07-17

  1. 为便于广告主更好的分析跨流量投放效果,API新增分流量版位报表分析能力, 涉及接口:daily_reports/get, async_reports/add
  • 使用方式:
    • group by参数设置以site set为聚合项
    • 在返回字段fields中指定site set为返回字段
    • 支持报表层级:广告主(REPORT_LEVEL_ADVERTISER),广告计划(REPORT_LEVEL_CAMPAIGN),广告组(REPORT_LEVEL_ADGROUP),广告(REPORT_LEVEL_AD),推广目标(REPORT_LEVEL_PROMOTED_OBJECT),视频素材(REPORT_LEVEL_MATERIAL_VIDEO),图片素材(REPORT_LEVEL_MATERIAL_IMAGE)
  • 无历史数据回溯,上线后开始产生数据

2020-07-15

  1. 为了支持微信朋友圈卡片广告应用直达能力,对于450、452、588、589创意形式的应用直达能力进行更新:选择 12-Android应用 商品类型时,填写 deep_link_url同时可以补充 deeplink_ios_appid ,以支持Android和iOS用户都可以应用直达 ,若不补充 deeplink_ios_appid ,则只支持Android用户实现应用直达; 选择 19-iOS应用 商品类型时,填写 deep_link_url同时可以补充 deeplink_anroid_appid ,以支持Android和iOS用户都可以应用直达 ,若不补充 deeplink_anroid_appid ,则只支持iOS用户实现应用直达。

2020-07-13

1.微信广告上线按钮文案功能

  • 涉及版位:SITE_SET_WECHAT、SITE_SET_MOMENTS
  • 涉及规格:538、484、841、616、701、559、560、927、929、 263、310、311、641、644、647、642、645、648、643、646、649、618
  • 涉及字段:link_name_type
  • 涉及接口:创建创意adcreatives/add, 更新创意adcreatives/update, 获取创意adcreatives/get

2020-07-09

  1. 为了提升广告主对素材的分析能力,腾讯广告上线视频素材、图片素材报表功能。
    • 涉及接口:daily_reports/get
    • 涉及字段:level = REPORT_LEVEL_MATERIAL_VIDEO(视频素材报表), REPORT_LEVEL_MATERIAL_IMAGE(图片素材报表)
  2. 为了提升广告主对人群包的分析能力,腾讯广告上线人群包效果报表功能,该报表更新频率为每天更新一次,次日可查看前一日报表数据(该功能灰度开放,如有接入需求,请联系对接运营)
    • 涉及接口:targeting_tag_reports/get
    • 涉及字段: type=CUSTOM_AUDIENCE(人群包报表) level可选ADVERTISER, CAMPAIGN, ADGROUP, AD, PROMOTED_OBJECT

2020-07-06

  1. 为提升流量包定向效果,对定投流量包与屏蔽流量包进行合并,升级为行业精选流量包(mobile_union_industry),包含重度游戏广告主定制、轻度游戏广告主定制、阅读行业广告主定制、教育广告主定制、中小广告主定制5类行业流量包,欢迎使用
  2. 将于7月31号对定投流量包 “mobile_union”及屏蔽流量包“exclude_mobile_union”下线,请在7月31号前更换流量包字段及枚举值,避免定投与屏蔽流量包下线后出现报错。

2020-07-01

  1. 试玩拓展,以落地页形态支持更多流量与行业,支持更多玩法,本次对试玩素材进行了改造升级,试玩更名为互动推广页;同时创意模块增加视频播放结束页(video_end_page)以支持更多的试玩页:

2020-06-30

  1. 为保证用户投放效果及体验一致,新增文案换行输入能力,现支持263、310、311 、618 、641 、 642、 643 、644、645、646、 647、 648、 649创意形式的文案元素(title)支持换行能力, 使用“\n”表示换行,占0.5个等宽字符,建议行数不超过6行。

2020-06-29

  1. 为提升渠道包管理效率,增加使用url新增渠道包接口,同时adgroups/get接口增加对应广告状态(system_status),渠道包审核不通过信息(android_channel_package_audit_message)字段,方便广告主查看。
  • 涉及接口: android_union_channel_packages/add, adgroups/get

2020-06-23

  1. 为支持更快捷的批量获取报表数据,异步报表接口现新增支持获取广告主(REPORT_LEVEL_ADVERTISER),广告计划(REPORT_LEVEL_CAMPAIGN),广告组(REPORT_LEVEL_ADGROUP),广告(REPORT_LEVEL_AD)等各层级的天级,小时级报表

  2. 为提升朋友圈广告投放效率,朋友圈版位广告支持使用定向包,仅当campaign_type=CAMPAIGN_TYPE_NORMAL时可以使用。

  • 涉及账号:腾讯广告账号
  • 涉及接口:adgroups/add、adgroups/update、adgroups/get
  • 涉及字段:targeting_id

2020-06-16

  1. 对齐线索获取(lead_clues/get)接口字段,与线索管理平台(http://leads.qq.com)拉取/推送接口保持一致,降低广告主理解成本

2020-05-28

  1. 新增创建转化id接口。
  • 涉及接口: conversions/add

2020-05-28

  1. 为提升游戏消费能力定向的使用效率、丰富定向底层数据能力,我们新增了 游戏消费能力(game_consumption_level)定向,同时计划2020年07月22日下线旧游戏用户消费能力 (gamer_consumption_ability)定向,game_consumption_level和gamer_consumption_ability不可以同时使用。请开发者们按全新字段游戏消费能力(game_consumption_level)进行接入使用。
  • 涉及接口: adgroups/add、adgroups/update、adgroups/get、targetings/add、targetings/update、targetings/get、estimation/get
  • 涉及字段: 游戏消费能力(game_consumption_level)

2020-05-27

  1. 为了使广告主能够清楚了解到试玩素材的审核拒绝原因,方便广告主进行修改,playable_pages/get接口返回字段增加audit_msg(审核原因);同时返回试玩素材的playable_page_direction(试玩素材展示方向),方便广告主查看。

2020-05-25

  1. 为更好支持广告主投放枫页电商的能力,新增电商推广推广目标支持使用枫页商品库,获取商品目录信息product_catalogs/get同时支持枫页商品库拉取。

2020-05-21

  1. 为了更好支持未绑定公众号的腾讯广告账号投放微信朋友圈广告,平台新增朋友圈头像昵称跳转页相关能力,涉及到朋友圈头像昵称跳转页创建profiles/add 、删除profiles/delete 、获取profiles/get

2020-05-20

  1. 为提升广告主使用设备品牌型号定向(device_brand_model)的完整性,我们针对微信公众账号支持了排除设备品牌型号、同时支持朋友圈版位使用该定向完整能力。
  • 涉及接口: 创建广告组adgroups/add、更新广告组adgroups/update、获取广告组adgroups/get
  • 涉及字段: 设备品牌型号定向device_brand_model、设备品牌型号定向included_list、排除设备品牌型号列表excluded_list

2020-05-19

  1. 为提升行为兴趣定向关键词批量检查能力,现平台针对targeting_tags/get进行了优化升级。定向标签查询方式(query_mode)新增批量检查关键词(TARGETING_TAG_QUERY_MODE_VERIFY_QUERY_LIST),query_spec新增批量检查关键词列表(query_list)当且仅当query_mode为TARGETING_TAG_QUERY_MODE_VERIFY_KEYWORD_LIST 时可填且必填,批量检查关键词最大支持250个。
  2. TASK_TYPE_BATCH_REQUEST下线,如有使用诉求,推荐切换至近期上线的实时批量接口batch_requests/add; TASK_TYPE_CLICK_FORWARDED_DATA任务下线,涉及接口:异步任务async_tasks/add ;涉及字段:异步任务相关字段(task_type/task_spec)。

2020-05-15

  1. 微信小游戏推广目标支持小游戏监控参数能力,涉及接口: 创建广告创意adcreatives/add、更新广告创意adcreatives/update ;涉及字段:小游戏监控参数(page_spec/mini_game_spec/mini_game_tracking_parameter)。

2020-05-14

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

  1. 为支持批量上传广告渠道包,新增异步批量上传渠道包功能,提升渠道包上传效率。 涉及接口:创建异步任务(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)

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/addadcreative_previews/get
  2. 为了解决SDPA创意合成过程中报错不明确的问题,平台对报错逻辑进行了细化,业务请求和响应无改动,仅新增了部分错误码并对报错文案进行了细化。涉及接口:dynamic_ad_videos/add,dynamic_ad_images/add。
  3. 创建广告创意(adcreatives/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/gethourly_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/addadgroups/updateadgroups/gettargeting_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/addadgroups/updateadgroups/get。具体升级能力如下:
  3. 对于创建的微信站点广告,对首次付费优化目标进行了调整: OPTIMIZATIONGOAL_APP_PURCHASE(App 购买)调整为:OPTIMIZATIONGOAL_FIRST_PURCHASE(首次付费)微信流量目前均按照去重后的首次付费进行优化。调整后,不会影响现有广告播放等效果。如调用广告创建接口时,使用调整前的优化目标枚举值来创建广告(例如:OPTIMIZATIONGOAL_APP_PURCHASE),系统仍然支持创建。在广告读取接口中,用调整前的优化目标枚举值创建的广告,读取的优化目标仍为调整前的优化目标枚举值,使用调整后的优化目标枚举值创建的广告,读取的优化目标为调整后的优化目标枚举值。
  4. 新增优化目标(均灰度支持)(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)。
  5. 待废弃优化目标(optimization_goal):有效在线咨询(OPTIMIZATIONGOAL_PAGE_EFFECTIVE_ONLINE_CONSULT)、有效电话拨打(OPTIMIZATIONGOAL_PAGE_EFFECTIVE_PHONE_CALL)。
  6. 新增深度优化目标(均灰度支持)(deep_conversion_behavior_spec下的goal):销售线索(OPTIMIZATIONGOAL_LEADS)、表单预约(OPTIMIZATIONGOAL_PAGE_RESERVATION)、有效在线咨询(OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_CONSULT)、有效电话拨打(OPTIMIZATIONGOAL_CONFIRM_EFFECTIVE_LEADS_PHONE)。
  7. 为了满足广告主更精准进行流量资源投放的诉求,现平台新增快手站点(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](/docs/api/adsmanagement/adgroups/adgroups_add)更新广告组[adgroups/update](/docs/api/adsmanagement/adgroups/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](/docs/api/adsmanagement/adgroups/adgroups_add)更新广告组[adgroups/update](/docs/api/adsmanagement/adgroups/adgroups_update)获取广告组[adgroups/get](/docs/api/adsmanagement/adgroups/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/addtargetings/updatetargetings/getadgroups/addadgroups/updateadgroups/getestimation/get
  3. ocpa投放能力升级,涉及接口包括:adgroups/addadgroups/updateadgroups/get。具体升级能力如下:
  4. 新增优化目标(optimization_goal): 综合线索收集(OPTIMIZATIONGOAL_LEADS_COLLECT) 首次付费(OPTIMIZATIONGOAL_FIRST_PURCHASE) 完件(OPTIMIZATIONGOAL_APPLY) 预授信(OPTIMIZATIONGOAL_PRE_CREDIT) 授信(OPTIMIZATIONGOAL_CREDIT) 提现(OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS) 关键页面浏览(OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE)
  5. 新增深度优化目标(deep_conversion_behavior_spec下的goal): 首次付费(OPTIMIZATIONGOAL_FIRST_PURCHASE) 商品详情页浏览(OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE) 授信(OPTIMIZATIONGOAL_CREDIT) 提现(OPTIMIZATIONGOAL_WITHDRAW_DEPOSITS)
  6. 新增优先低成本出价策略(bid_strategy):优先低成本BID_STRATEGY_PRIORITY_LOW_COST。
  7. 新增两阶段/双目标优化方式(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,升级内容包括:
  2. 新增设备品牌定向(device_brand_model),支持对手机品牌进行定向或排除定向操作,可定向的手机品牌枚举值信息可通过“targeting_tags/get接口进行获取。
  3. 操作系统定向(user_os)升级,iOS\ANDROID系统定向支持按“操作系统版本”进行定向。
  4. 支持微信公众号的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/updateadcreatives/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, adcreatives/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)接口
  3. 新增2个指标:平台产品领取卡券率(platform_coupon_get_rate)及平台产品卡券点击量(platform_coupon_click)。

2019-9-9

  1. 自动扩量、不可突破定向设置方式优化,涉及接口adgroups/add, adgroups/update, adgroups/get,新增字段
  2. expand_enabled:支持通过该字段设置是否使用ocpa/cpc自动扩量能力
  3. expand_targeting:支持通过该字段设置不可突破定向内容
  4. 原有ocpa_expand_enabled、ocpa_expand_targeting、cpc_expand_enabled、cpc_expand_targeting的使用方式即将废弃
  5. 离线任务新增支持异步任务类型(task_type=TASK_TYPE_CLICK_FORWARDED_DATA_SPEC),该能力灰度开放中,如有接入需求,请联系对接运营同学
  6. 获取日报表(daily_reports/get)、获取小时报表(hourly_reports/get)、获取定向标签报表(targeting_tag_reports/get)接口
  7. 新增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)
  8. 一个指标即将废弃:电话直拨量(即将废弃)-转化指标(网页类)-成交前行为 (web_phone_call_direct_count)
  9. images/get、videos/get 接口新增返回字段 source_type, 用以区分上传的资源来源,如“妙思”、“小视界”、“本地上传”等

2019-9-5

  1. 不再支持创建公众号类型的推广计划(campaign_type= CAMPAIGN_TYPE_WECHAT_OFFICIAL_ACCOUNTS),历史广告可以正常读取。
  2. 离线任务新增支持异步任务类型,详细指标见文档
  3. 支持微信门店小时报表查询(task_type= TASK_TYPE_WECHAT_POI_HOURLY_REPORT)
  4. 微信广告组小时报表task_type=TASK_TYPE_WECHAT_ADGROUP_HOURLY_REPORT)新增40新指标
  5. 支持微信公众平台广告主账号身份获取微信投放端广告数据(task_type=TASK_TYPE_WECHAT_ADVERTISING_DATA),该能力灰度开放中,如有接入需求,请联系对接运营同事
  6. 支持商务管家账号(BM)授权,并操作商务管家账号下认领的相关账号信息
  7. 新增获取商务管家代理的广告主列表接口(business_manager_relations/get),支持获取商务管家账号下可操作的广告主信息
  8. 暂不支持操作商务管家账号下的微信公众平台广告主账号
  9. 人群相关接口支持使用微信公众平台广告主身份操作,进行人群数据上传,上传后的人群数据可在dmp平台、微信投放端进行拉取、管理。涉及接口: custom_audiences/add, custom_audiences/get, custom_audiences/delete,custom_audiences/update, custom_audience_files/add, custom_audience_files/get
  10. 广告主开户时 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 ):
  3. 投放该规格需设置adgroup上激励视频开关(is_rewarded_video_ad),开关一经设置不可修改
  4. 当该字段取值为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. 落地页功能升级:
  4. 对于Marketing API尚不支持投放的落地页类型,统一使用枚举值page_type_unsupported进行返回, 且不支持通过API修改该落地页信息;
  5. 补全投放应用下载推广目标时(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_typeCAMPAIGN_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/gethourly_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/add、advertiser/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 版本发布。