# 腾讯小时报表
TIP
请注意，第三方数据集成产生的数据会被纳入集群的消耗数据量
# 概要
# 接口简介
| 接口名 | 类型 | 粒度 | 归因 | 成本 | 收益 | 展示 | 点击 | 转化 |
|---|---|---|---|---|---|---|---|---|
| 小时报表 | API | 聚合数据 | ✅ | ✅ | ✅ | ✅ | ✅ |
腾讯广告的小时报表 (opens new window)报表，支持回传小时级粒度的聚合数据，包括消耗、点击、展示等指标
# 集成流程
与腾讯广告的数据集成流程如下：
- 登录 TE 后台，进入三方集成模块，新增腾讯广告小时报表集成方案，并完成相关配置，并复制授权回调地址
- 进入腾讯广告开发者平台，注册成为开发者 (opens new window)，创建应用，并获取 Client ID 和 Client Secret
- 回到 TE 后台，修改之前的腾讯广告小时报表集成方案，使用应用的 Client ID 与 Secret，并打开授权链接完成授权
- 查看 TE 系统否成功接收数据，并完成报表搭建
# 一、方案配置
在接入腾讯广告数据前，您需要先在 TE 后台创建相应的集成方案，并获取授权回调地址，您可以按照本文档完成集成方案的创建
# 1.1 临时编写授权信息
首先点击授权信息栏的「配置授权信息」按钮，在弹出的授权信息弹窗中，先随意编写授权信息，作为临时的授权信息。之后在完成腾讯广告开发平台的应用创建后，还需进行调整。
# 1.2 定时拉取
您可以在「定时拉取」模块设置 TE 系统定时拉取腾讯广告小时报表数据的策略，可以选择在每天的某时拉取一段时间的数据。由于拉取的数据也会计算再数据量中，建议您在不要定时拉取太长时间的数据
# 1.3 入库设置
您可以控制数据是否以事件的形式写入，如果关闭，则数据将不会写入事件表，因此请不要关闭该配置。
# 1.4 集成配置
最后，您可以在集成配置模块对数据拉取的细节配置进行控制。包括数据的时间聚合粒度，拉取的指标字段与维度，以及入库后的事件名等。
集成配置中的内容是一个 JSON，您可以按照以下内容进行自定义配置：
| 模块 | 名称 | 含义 |
|---|---|---|
| sink_event | event_name | 入库后的事件名，可以自定义 |
| source | metrics | 拉取数据的指标，列表类型，可以自定义 |
| group_by | 拉取数据的维度，列表类型，可以自定义 |
以下是小时报表支持的分析维度，如需调整，请将需要的维度名写入 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+hour 字段，即数据的聚合时间，作为事件的 #event_time
- 默认的事件名为 —— tencent_ads_hourly_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安装量 |