跳到主要内容

腾讯新版投放小时报表

最近更新 2026/10/03
提示

请注意，第三方数据集成产生的数据会被纳入集群的消耗数据量

概要​

接口简介​

接口名类型粒度归因成本收益展示点击转化
新版投放小时报表API聚合数据✅✅✅✅✅

腾讯广告的新版投放小时报表，支持回传小时级粒度的聚合数据，包括消耗、点击、展示等指标

集成流程​

与腾讯广告的数据集成流程如下：

  1. 登录 AE 后台，进入三方集成模块，新增腾讯新版投放小时报表集成方案，并完成相关配置，并复制授权回调地址
  2. 进入腾讯广告开发者平台，注册成为开发者，创建应用，并获取 Client ID 和 Client Secret
  3. 回到 AE 后台，修改之前的腾讯新版投放小时报表集成方案，使用应用的 Client ID 与 Secret，并打开授权链接完成授权
  4. 查看 AE 系统是否成功接收数据，并完成报表搭建

一、方案配置​

在接入腾讯广告数据前，您需要先在 AE 后台创建相应的集成方案，并获取授权回调地址，您可以按照本文档完成集成方案的创建

1.1 临时编写授权信息​

首先点击授权信息栏的「配置授权信息」按钮，在弹出的授权信息弹窗中，先随意编写授权信息，作为临时的授权信息。之后在完成腾讯广告开发平台的应用创建后，还需进行调整。

1.2 定时拉取​

您可以在「定时拉取」模块设置 AE 系统定时拉取腾讯新版投放小时报表数据的策略，可以选择在每天的某时拉取一段时间的数据。由于拉取的数据也会计入数据量，建议不要定时拉取太长时间的数据

1.3 入库设置​

您可以控制数据是否以事件的形式写入，如果关闭，则数据将不会写入事件表，因此请不要关闭该配置。

1.4 集成配置​

最后，您可以在集成配置模块对数据拉取的细节配置进行控制。包括数据的时间聚合粒度，拉取的指标字段与维度，以及入库后的事件名等。

集成配置中的内容是一个 JSON，您可以按照以下内容进行自定义配置：

模块名称含义
sink_eventevent_name入库后的事件名，可以自定义
sourcemetrics拉取数据的字段，列表类型，可以自定义
group_by拉取数据的聚合条件，列表类型，可以自定义
transferdouble_columns拉取数据的字段（即 source.metrics）中需要被转成数值的字段，没有在该列表中的字段将转成字符串入库，列表类型，可以自定义
extra_paramslevel拉取数据的报表类型级别，可以自定义
  • 报表类型级别与聚合条件

报表类型级别与聚合条件决定了小时报表的数据粒度，比如按广告聚合数据还是以创意聚合数据。一次查询只能选择一个报表类型级别，且不同的报表类型级别支持的聚合条件不同，以下展示的是部分常用级别及其支持的聚合条件，如需调整，报表类型级别填写在 extra_params 中，聚合条件写在 source.group_by 中：

报表类型级别说明默认支持的聚合条件
REPORT_LEVEL_ADVERTISER广告主级别报表"hour"
REPORT_LEVEL_ADGROUP广告级别报表"hour", "adgroup_id"
REPORT_LEVEL_DYNAMIC_CREATIVE广告创意级别报表是"hour", "dynamic_creative_id"
  • 拉取字段

以下展示的是新版投放小时报表默认拉取的分组字段。请注意，分组字段会受到拉取维度影响，细粒度的聚合条件支持其更粗粒度的聚合条件的分组字段，比如以 "dynamic_creative_id" 作为聚合条件，可以拉取包括 "account_id"、"adgroup_id" 等粗粒度的分组字段。如需调整，请将需要的分组字段名写入 source.metrics 中：

分组字段说明
adgroup_id广告 ID
dynamic_creative_name创意名
dynamic_creative_id创意 ID
account_id广告账号 ID

以下展示的是部分小时报表支持的指标，由于该报表的指标非常多，此处仅展示部分常用指标，如需了解所有指标，请查看官网文档（注意选择您在方案中设置的 level）。如需调整，请将字段名写在 source.metrics 中：

字段说明
view_count曝光量
view_user_count曝光人数
valid_click_count点击量
click_user_count点击人数
ctr点击率
cpc点击均价
cost花费
conversion_count目标转化量
conversion_rate目标转化率
conversion_cost目标转化成本
download_countAPP下载完成量
activated_countAPP激活总量
activated_rateAPP下载激活率
activated_costAPP激活成本
thousand_display_price千次展现均价
download_rateAPP下载率
download_costAPP下载成本
install_countAPP安装量
install_rateAPP安装率
install_costAPP安装成本
click_activated_rateAPP点击激活率

1.5 获取授权回调地址​

在完成上述配置后，请点击右上角的保存并授权获取授权信息。请复制第一步中的授权回调地址，并妥善保管。之后点击「暂不授权」关闭该弹窗：

点击「保存并授权」时方案就已经保存，不需要再单独保存，至此您暂时完成了 AE 后台的配置工作，接下来请在腾讯广告后台完成相关配置。

二、注册成为开发者并创建应用​

接下来，您需要登录腾讯广告开发者后台，使用其他 QQ 号注册成为开发者。

注册成为开发者后，在应用程序管理看板，点击「创建新应用」。

接着，在「创建应用」页面，完成应用的创建：

  • 应用类型选择「第三方应用」
  • 应用图表、应用名称、应用介绍可以自定义
  • 回调地址请输入您在 AE 系统中获取的授权信息地址

请在「权限选择」中至少选择广告洞察（Ads Insight）的权限

创建应用后，接下来请获取应用的 client id 与 client_secret，并记录下来

三、回到 AE 后台，完成授权工作​

创建了腾讯应用后，请回到 AE 后台，进入到之前的创建的腾讯集成方案，点击「授权信息」下的「配置授权信息」按钮：

接下来，请将您在腾讯应用的 Client ID 与 Client Secret 填入相应位置，Login ID 中填入您准备在授权时登录的 QQ 号或者微信号，Account ID List 处可以填写需要拉取的广告账号的 ID，多个 ID 之间用 “,” 号分割；如果不填写，则会拉取所有已授权的广告账号的数据。完成编辑后点击保存按钮：

接着点击右上角的「保存并授权」，再次进入到授权信息弹窗。此时点击「前往授权」，将打开腾讯平台的授权页面。方案已保存但还没有完成授权时，方案页顶部会显示「当前方案尚未完成授权，数据无法接入，请前往授权」提示条，点击其中的「去授权」也能打开授权信息弹窗

在授权页面，您需要登录您的广告账号，并至少选择「广告洞察」数据权限，点击同意授权按钮即可完成授权

注意，如果登录并授权的是 【QQ直客帐号】，则仅会获得当前客户推广帐号的数据权限。如果登录并授权的是 【QQ商务管家帐号】，则可以获取所有管家账号下的推广账户的数据权限。

当您完成了授权之后，请在「授权信息」中点击左下角的「我已完成以上两步操作」后点击右下角的「完成授权」结束配置。至此，您完成了腾讯平台的数据集成。

四、数据入库​

4.1 入库规则​

  • 使用数据中的 start_date+hour 字段，即数据的聚合时间，作为事件的 #event_time
  • 默认的事件名为 —— tencent_ads_hourly_report_v3
  • 其他字段将全数入库

4.2 标准化字段​

腾讯新版投放小时报表数据中的部分字段，AE 系统会进行标准化处理：

原字段标准化说明
adgroup_idte_ads_object.ad_group_id广告组 ID
dynamic_creative_namete_ads_object.ad_name广告名
dynamic_creative_idte_ads_object.ad_id广告 ID
account_idte_ads_object.account_id广告账号 ID
view_countte_ads_object.impressions曝光量
valid_click_countte_ads_object.clicks点击量
costte_ads_object.cost花费
install_countte_ads_object.installsAPP安装量
这篇文档对你有帮助吗？
本页内容