menu
Is this helpful?

# 腾讯日报表

TIP

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

# 概要

# 接口简介

接口名 类型 粒度 归因 成本 收益 展示 点击 转化
日报表 API 聚合数据

腾讯广告的日报表 (opens new window)支持回传聚合数据,包括消耗、点击、展示等指标

# 集成流程

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

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

# 一、方案配置

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

# 1.1 临时编写授权信息

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

# 1.2 定时拉取

您可以在「定时拉取」模块设置 TE 系统定时拉取腾讯广告日报表数据的策略,可以选择在每天的某时拉取一段时间的数据。由于拉取的数据也会计算再数据量中,建议您在不要定时拉取太长时间的数据

# 1.3 入库设置

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

# 1.4 集成配置

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

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

模块 名称 含义
sink_event event_name 入库后的事件名,可以自定义
source metrics 拉取数据的字段,列表类型,可以自定义
group_by 拉取数据的聚合条件,列表类型,可以自定义
extra_params level 拉取数据的报表类型级别,可以自定义
- 报表类型级别与聚合条件

报表类型级别与聚合条件决定了日报表的数据粒度,比如按广告组聚合数据还是以素材聚合数据。一次查询只能选择一个报表类型级别,且不同的报表类型级别支持的聚合条件不同,以下展示的是部分常用级别及其支持的聚合条件,详情可以查看官网文档 (opens new window)。默认的报表类型级别与聚合条件分别为 REPORT_LEVEL_AD 和 "date","ad_id","site_set",如需调整,报表类型级别填写在 extra_params 中,聚合条件写在 source.group_by 中:

报表类型级别 说明 默认 支持的聚合条件
REPORT_LEVEL_ADVERTISER 广告主级别报表 "date"
REPORT_LEVEL_CAMPAIGN 推广计划级别报表 "date", "campaign_id"
REPORT_LEVEL_ADGROUP 广告组级别报表 "date", "adgroup_id", "site_set"
REPORT_LEVEL_AD 广告级别报表 "date", "ad_id", "site_set"
REPORT_LEVEL_MATERIAL_VIDEO 视频素材报表 "date", "material_id", "site_set"
REPORT_LEVEL_MATERIAL_IMAGE 图片素材报表 "date", "material_id", "site_set"
- 拉取字段

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

分组字段 说明
campaign_name 广告计划名
campaign_id 广告计划 ID
adgroup_name 广告组名
adgroup_id 广告组 ID
ad_name 广告名
ad_id 广告 ID
account_id 广告账号 ID

以下展示的是部分日报表支持的指标,由于该报表的指标非常多,此处仅展示部分常用指标,如需了解所有指标,请查看官网文档 (opens new window)。如需调整,请将字段名写在 source.metrics 中:

字段 说明
view_count 曝光量
download_count APP下载完成量
activated_count APP激活总量
activated_rate APP下载激活率
thousand_display_price 千次展现均价
valid_click_count 点击量
ctr 点击率
cpc 点击均价
cost 花费
key_page_view_cost 关键页面访问成本
coupon_click_count (游戏)礼包兑换按钮点击
coupon_issue_count (游戏)礼包(券)发放量
coupon_get_count (游戏)礼包(券)领取量
download_rate APP下载率
download_cost APP下载成本
install_count APP安装量
install_cost APP安装成本
click_activated_rate APP点击激活率
activated_cost APP激活成本
app_register_count 注册量(APP)
register_by_display_count 注册量(曝光归因)
app_register_cost 注册成本(APP)
app_order_cost 下单成本(APP)
app_checkout_count 付费行为量(APP)
app_checkout_by_display_count 付费行为量(曝光归因)
app_checkout_cost 付费行为成本(APP)
app_ad_paying_users 广告变现人数(APP)
ad_pur_val_app 广告变现金额(APP)
game_create_role_count 游戏内创建角色量
game_authorize_count 游戏授权量
game_tutorial_finish_count 游戏完成新手教程量
app_checkout_rate 点击付费行为率(APP)
app_activated_checkout_rate 激活付费行为率(APP)
app_register_rate 注册率(APP)
install_rate APP安装率
first_pay_count 首次付费行为人数
first_pay_rate 首次激活付费率
wechat_app_register_uv 微信小游戏注册人数
no_interest_count 不感兴趣点击次数
mini_game_register_users 小游戏注册人数
mini_game_register_cost 小游戏注册成本
mini_game_register_rate 小游戏注册率
mini_game_ad_monetization_users 小游戏广告变现人数
mini_game_paying_count 小游戏付费次数
mini_game_paying_amount 小游戏付费金额
mini_game_first_paying_users 小游戏首次付费人数
mini_game_create_role_users 游戏内创建角色人数
mini_game_create_role_cost 游戏内创建角色成本
mini_game_key_page_viewers 小游戏关键页面访问人数
mini_game_key_page_view_cost 小游戏关键页面访问成本
mini_game_ad_monetization_amount 小游戏广告变现金额
key_page_view_rate 关键页面访问率
activate_register_rate 激活注册率
key_behavior_conversions_count 关键行为转化量
key_behavior_conversions_cost 关键行为转化成本
key_behavior_conversions_rate 关键行为转化率
mini_game_ad_monetization_cost 小游戏广告变现成本
mini_game_bf_uv 小游戏回流人数
mini_game_bf_cost 小游戏回流成本
mini_game_bf_income_uv 小游戏回流广告变现人数
mini_game_bf_income_amount 小游戏回流广告变现金额
mini_game_bf_income_d1_uv 小游戏首日回流广告变现人数
mini_game_bf_income_d1_amount 小游戏首日回流广告变现金额
mini_game_bf_income_d1_cost 小游戏首日回流广告变现成本

# 1.5 获取授权回调地址

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

接着,点击「保存」按钮完成方案的保存,至此您暂时完成了 TE 后台的配置工作,接下来请在腾讯广告后台完成相关配置。

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

接下来,您需要登录腾讯广告开发者后台,使用其他 QQ 号注册成为开发者 (opens new window)

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

接着,在「创建应用」页面,完成应用的创建:

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

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

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

# 三、回到 TE 后台,完成授权工作

创建了腾讯应用后,请回到 TE 后台,进入到之前的创建的腾讯集成方案,点击「授权信息」:

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

接着点击右上角的「保存并授权」,再次进入到授权信息弹窗。此时点击「前往授权」,将打开腾讯平台的授权页面

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

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

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

# 四、数据入库

# 4.1 入库规则

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

# 4.2 标准化字段

腾讯日报表数据中的部分字段,TE 系统会进行标准化处理:

字段 标准化 说明
campaign_name te_ads_object.campaign_name 广告计划名
campaign_id te_ads_object.campaign_id 广告计划 ID
adgroup_name te_ads_object.ad_group_name 广告组名
adgroup_id te_ads_object.ad_group_id 广告组 ID
ad_name te_ads_object.ad_name 广告名
ad_id te_ads_object.ad_id 广告 ID
account_id te_ads_object.account_id 广告账号 ID
view_count te_ads_object.impressions 曝光量
valid_click_count te_ads_object.clicks 点击量
cost te_ads_object.cost 花费
install_count te_ads_object.installs APP安装量