腾讯广告

尊敬的腾讯广告Marketing API开发者：

您好！

为了给所有广告主提供高效完善的统一报表体验，整合升级报表指标能力，腾讯广告投放平台将与8月28日起，全面升级新指标体系（背景及投放平台升级站内信可参考：
https://doc.weixin.qq.com/doc/w3_AMAA_AZiACIl7Bdr2nIRr6xea88rx?scode=AJEAIQdfAAogxCGJpKAMAA_AZiACI

同时，腾讯广告API部分报表接口目前也已经开放“新指标体系”供开发者提前开发与接入，详情如下：

1. 新增“获取腾讯广告平台广告账户升级状态”接口（adq_reports_upgrade_status/get）（该接口已上线）

（1） 接口链接：
https://developers.e.qq.com/docs/api/tools/adq_reports_upgrade_status/adq_reports_upgrade_status_get?version=1.1&_preview=1
（2） 接口使用说明：
该接口供开发者获取“账户是否在腾讯广告平台升级新指标体系”的信息。对于API开发者来说，优化师在投放端操作账户时看到的指标体系，应该与开发者查询指标体系保持一致。因此新增该字段，用来让API开发者知道账户是否在投放端已经升级新指标体系。
当返回“UPGRADED”，则代表该账户在腾讯广告投放平台已经升级为“新指标体系”。如果开发者还未改造完毕，请尽快改造；如果已经改造完毕，请按照下文的方式，请求“新指标体系”进行数据查询，以达到投放端与API数据体系一致的效果。

2. 创建异步任务接口（async_reports/add）（该接口已发布下述变更）

（1） 应答字段新增筛选项：
可筛选“新指标体系”、“旧指标体系”，查看新老指标体系的字段详情
（2） 新增“adq_accounts_upgrade_enabled”字段，供开发者选择调用新指标或旧指标：
当携带“true”请求API，则只能请求新指标体系中的指标；当携带“false”请求API或不携带该字段请求API，则只能请求旧指标体系中的指标
（3） “level”字段部分枚举值下线：REPORT_LEVEL_REGION_RECENTLY_IN、REPORT_LEVEL_REGION_VISITED_IN、REPORT_LEVEL_REGION_LIVE_IN、REPORT_LEVEL_REGION_TRAVEL_IN、REPORT_LEVEL_CITY_RECENTLY_IN、REPORT_LEVEL_CITY_VISITED_IN、REPORT_LEVEL_CITY_LIVE_IN、REPORT_LEVEL_CITY_TRAVEL_IN
（4） “level”字段新增：REPORT_LEVEL_REGION、REPORT_LEVEL_CITY

3. 获取定向标签报表接口（targeting_tag_reports/get）（该接口预计8月底发布变更）

（1） 应答字段新增筛选项：
可筛选“新指标体系”、“旧指标体系”，查看新老指标体系的字段详情
（2） 新增“adq_accounts_upgrade_enabled”字段，供开发者选择调用新指标或旧指标：
当携带“true”请求API，则只能请求新指标体系中的指标；当携带“false”请求API或不携带该字段请求API，则只能请求旧指标体系中的指标
（3） “type”字段部分枚举值下线：REGION_RECENTLY_IN、REGION_VISITED_IN、REGION_LIVE_IN、REGION_TRAVEL_IN、CITY_RECENTLY_IN、CITY_VISITED_IN、CITY_LIVE_IN、CITY_TRAVEL_IN、PROVINCE、AGE_GENDER、INTEREST

4. 获取日报表接口（daily_reports/get）、获取小时报表接口（hourly_reports/get）（该接口预计8月底发布变更）

（1） 应答字段新增筛选项：
可筛选“新指标体系”、“旧指标体系”，查看新老指标体系的字段详情
（2） 新增“adq_accounts_upgrade_enabled”字段，供开发者选择调用新指标或旧指标：
当携带“true”请求API，则只能请求新指标体系中的指标；当携带“false”请求API或不携带该字段请求API，则只能请求旧指标体系中的指标
（3） “level”字段部分枚举值下线：REPORT_LEVEL_UNION_POSITION、REPORT_LEVEL_EXPAND_TARGETING_ADGROUP

5. 获取落地页报表接口（report/landing_page）（该接口预计8月底发布变更）

（1） 应答字段新增筛选项：
可筛选“新指标体系”、“旧指标体系”，查看新老指标体系的字段详情
（2） 新增“adq_accounts_upgrade_enabled”字段，供开发者选择调用新指标或旧指标：
当携带“true”请求API，则只能请求新指标体系中的指标；当携带“false”请求API或不携带该字段请求API，则只能请求旧指标体系中的指标

目前，报表相关的接口文档正在按照上述变更发布中，请您即刻开始结合接口变更与“新指标体系”进行改造，避免账户在投放平台升级新指标体系后，API接口依然无法跟进使用。

感谢您的支持与理解！如有问题，请随时与您的运营接口同学联系，谢谢！

腾讯广告