# 巨量引擎集成方案（WIP）
本文将介绍如何在 TE 后台接入巨量引擎数据，目前 TE 后台支持接入的是巨量引擎的多合一数据报表接口 (opens new window)，如需了解如何接入巨量引擎的其他接口数据，请参考巨量引擎数据集成解决方案 (opens new window)
TIP
请注意，第三方数据集成产生的数据会被纳入集群的消耗数据量
# 概要
# 接口简介
| 接口名 | 集成类型 | 数据粒度 | 归因数据 | 成本数据 | 收益数据 | 展示数据 | 点击数据 | 转化数据 |
|---|---|---|---|---|---|---|---|---|
| 多合一数据报表接口 | API | 聚合数据 | ✅ | ✅ | ✅ | ✅ |
多合一数据报表 (opens new window)支持各广告粒度、素材、关键词层级的广告数据，其分析维度、指标都很丰富。
# 集成流程
- 登录巨量引擎开放平台 (opens new window)，创建开发者账号与应用，并获取应用的 APP_ID 与 Secret
- 在 TE 后台的巨量引擎配置页创建集成方案，将应用的 APP_ID 与 Secret、登录用户 ID 填入集成方案中，获取回调地址，并保存配置
- 回到巨量引擎开放平台，修改之前创建的应用的回调地址，获取授权链接
- 在浏览器打开授权链接，登录您需要拉取的广告账号所属的巨量账号，完成授权
- 回到 TE 后台的巨量引擎配置页，设置定时拉取，并执行单次拉取同步数据
- 查看 TE 系统否成功接收数据，并完成报表搭建
# 一、巨量引擎创建应用
# 1.1 创建开发者账号与应用
在接入巨量引擎数据前，您需要申请巨量引擎开发者账号，并创建一个应用
首先您需要登录或注册巨量账号，点击本链接进入登录注册页 (opens new window)，如果您拥有巨量引擎账号，可选择左下角登陆，登陆对应账号；如果没有账号，则使用邮箱或手机号注册巨量引擎账号
完成登录后，您将跳转至巨量引擎开放平台 (opens new window)，点击页面右上角「开发者管理后台」按钮，进入开发者后台
如果您没有创建开发者账号，则此时需要您完成开发者信息的录入与资质审核，由于一个公司信息仅能注册认证一个开发者账户，请务必使用公司邮箱进行申请，并妥善保管该账号。具体的申请流程，可以参考官方文档 (opens new window)。开发者类型，需要选择广告主/代理商，请按实际情况选择其一，两者的差异如下：
- 广告主：只可申请与开发者账户同公司主体的纵横组织账户授权
- 代理商：只可申请与开发者账户同公司主体的代理商账户授权
- 开发者账号认证通过后，请进入开发者官网并进入「APPID管理」页面，选择创建「广告管理」类型应用
- 在回调地址请先输入：www.thinkingdata.cn。请注意，此时填入的回调地址并非有效的地址，有效地址需要在之后获取，并回到应用页进行修改。
- 权限范围中，需要选中「数据报表」权限
- 申请提交后，巨量将在一个工作日内审核完成您的应用创建（APPID）申请
# 1.2 获取 App ID、App Secret
完成应用申请后，请进入到开发者后台，从左边栏找到「应用管理」-「基础应用」，选择创建的应用，点击「编辑」进入「基本信息」页面，找到 APP_ID 和 Secret，将其复制下来。
# 1.3 获取登录用户 ID
接下来，请进入到「巨量引擎开发平台」，点击右上角"六边形标识"，点击「巨量纵横」进入后台，点击右上角「账户信息与安全」，找到登录用户 ID，将其复制下来。
# 二、TE 三方集成页面获取回调地址
创建完应用后，接下来需要您登录 TE 系统后台，在「三方集成」模块中完成巨量引擎的回调地址。下图是巨量引擎的配置界面，请打开「集成开关」开始巨量引擎的配置：
请先集成方案部分，首先点击按钮添加集成方案：
请您按照以下内容进行填写，其中 APP_ID、Secret 与登录用户 ID 都在上一节中有介绍如何获取：
| 参数名称 | 说明 | 获取位置 | 必填 |
|---|---|---|---|
| 方案名称 | 自定义的方案名称 | 是 | |
| APP_ID | 巨量引擎后台创建的应用的 APP ID | 开发者平台 APP 应用详情页 | 是 |
| Secret | 巨量引擎后台创建的应用的 Secret | 开发者平台 APP 应用详情页 | 是 |
| 广告主 ID 列表 | 巨量引擎后台用于投放广告的广告主（广告账户） | 巨量引擎商务管理平台的「推广」页面「账户」标签页 | 是 |
| 登录用户 ID | 用于登录巨量引擎后台的登录用户 ID（非登录邮箱） | API 授权界面 | 是 |
| 代理名称 | 可不填 | ||
| 平台名称 | iOS 或 Android，可不填 |
填写完成后，点击确定，会展示「回调地址」，复制并保管该地址。最后，请务必点击「保存配置」完成设置：
若此处无地址没有显示，请进入右上角菜单「项目管理」-「接入配置」-「数据上报地址」处配置公网地址。该地址即 TE SDK 中配置的数据上报地址。配置后再回到巨量引擎配置页复制回调地址。
# 三、巨量引擎完成授权
在保存配置并获取回调地址后，我们需要返回巨量引擎应用页，修改应用的回调地址，将刚刚复制的回调地址会给您提供回调地址，请在应用编辑页面的「回调地址」处中填入该地址。
填写完毕后，您可以在页面底部看到授权 URL。将其复制到浏览器中并打开。
此时将展示授权界面，选择「当前用户全量账户」，并确认「当前登录用户」拥有您需要拉取数据的广告账户。请确认红框中的登录用户 ID 与巨量引擎集成方案中的登录用户 ID 是一致的。确认完毕后，点击同意授权，即可完成授权工作。
# 四、回到 TE 后台完成最后配置
最后，请您回到 TE 三方集成页面，完成巨量引擎的其他参数的设置
# 4.1 定时拉取
您可以配置 TE 系统定时拉取的策略，可以选择在每天或者每小时拉取一段时间的数据。请注意，巨量引擎多合一数据报表仅支持拉取最多过去 30 天的数据。
# 4.2 单次拉取
除了定时拉取外，您还可以点击配置页右下角的单次拉取按钮，手动触发一次数据拉取。在拉取数据弹窗中，请您设置需要拉取的数据范围，以及哪些方案需要拉取。
# 五、数据入库规则
# 5.1 用户识别规则
由于巨量引擎多合一数据报表是聚合指标，TE 系统将会给这些数据设置一个特殊的用户 ID，使其不会与实际用户进行关联，且不影响正常分析使用。
# 5.2 事件入库规则
- 使用数据中的 stat_datetime 字段，即数据的日期，设置为聚合数据的 #event_time。目前巨量引擎拉取的是小时粒度的数据，因此 stat_datetime 也是精确到小时的时间
- 数据事件名为 -- oceanengine_show_click_convert_data
- 其余字段都将会入库
# 5.3 包含字段
巨量引擎多合一数据报表包含以下事件属性，其中部分字段 TE 系统会进行标准化处理：
| 字段名 | 含义 | 标准化字段 |
|---|---|---|
| stat_datetime | 时间 | |
| advertiser_id | 广告主 ID | te_ads_object.ad_account_id |
| campaign_name | 广告组名称 | te_ads_object.campaign_name |
| campaign_id | 广告组 ID | te_ads_object.campaign_id |
| ad_name | 广告计划名称 | te_ads_object.ad_group_name |
| ad_id | 广告计划 ID | te_ads_object.ad_group_id |
| creative_name | 创意名 | te_ads_object.ad_name |
| creative_id | 创意 ID | te_ads_object.ad_id |
| active | 激活数 | |
| active_cost | 激活成本 | |
| active_pay_cost | 首次付费成本 | |
| active_pay_rate | 首次付费率 | |
| active_rate | 激活率 | |
| active_register_cost | 注册成本 | |
| active_register_rate | 注册率 | |
| attribution_active_pay_7d_per_count | 7日人均付费次数 | |
| attribution_convert | 转化数（计费时间） | |
| attribution_convert_cost | 转化成本（计费时间） | |
| attribution_deep_convert | 深度转化数（计费时间） | |
| attribution_deep_convert_cost | 深度转化成本（计费时间） | |
| avg_click_cost | 平均点击单价 | |
| avg_show_cost | 平均千次展现费用 | |
| click | 点击数 | te_ads_object.clicks |
| click_install | 点击安装数 | te_ads_object.installs |
| convert | 转化数 | |
| convert_cost | 转化成本 | |
| convert_rate | 转化数据-转化率 | |
| cost | 总消耗 | te_ads_object.cost |
| ctr | 点击率 | |
| deep_convert | 深度转化数 | |
| deep_convert_cost | 深度转化成本 | |
| deep_convert_rate | 深度转化率 | |
| download | 下载开始 | |
| game_addiction | 关键行为数 | |
| game_addiction_cost | 关键行为成本 | |
| game_addiction_rate | 关键行为率 | |
| game_pay_cost | 付费成本 | |
| game_pay_count | 付费次数 | |
| pay_count | 首次付费次数 | |
| show | 展示数 | te_ads_object.impressions |
# 5.4 用户属性入库规则
巨量引擎多合一数据报表不会写入用户表。
# 六、后续使用
# 6.1 数据入库检查
最后，请您检查 TE 系统是否接收到了巨量引擎的数据，您可以按照以下方法进行检查：
- 在「数据管理」-「元事件」页面查看 oceanengine_show_click_convert_data 事件是否被创建。
- 您也可以在事件分析模型中查询 oceanengine_show_click_convert_data 是否有数据
# 6.2 报表建议
以下提供几个构建报表的建议：
- 在事件分析模型中，使用巨量引擎数据搭建广告投放与转化的核心指标，创建广告分析报表
- 在留存分析模型中，结合回传数据的成本与游戏内付费事件，计算各媒体渠道、广告计划等粒度的 ROI