# 三方集成
三方集成模块提供了一系列第三方广告平台的集成能力，可以将这些平台的广告投放与广告变现数据同步到 TE 系统中来。本文将重点介绍三方集成模块下各页面的核心功能以及三方集成模块的基本概念，想要了解各平台的具体接入方式，可以查看本页面的子页面。
# 三方集成主页
三方集成的主页展示了当前支持部分的三方集成平台，目前在界面上支持配置的平台有以下五个，您可以点击以下平台名查看对应平台的集成方案：
除此之外，您还可以在 TE 工作人员的协助下，接入更多三方平台数据。目前 TE 系统已经支持接入近 30 家第三方平台的数据集成，如需了解详情，可查看合作伙伴集成-解决方案总览 (opens new window)文档。
您可以点击接入或修改配置按钮进入到集成配置页面，点击查看详情按钮可以查看该平台的接入数据情况以及错误详情。
# 配置页面
当您在三方集成主页点击接入或修改配置按钮后，将进入三方集成的配置页面。上图展示的是 AppsFlyer 与巨量引擎的配置页面，由于各平台的数据逻辑不同，各平台的配置页面也不尽相同。主要的可配置参数有：
- 集成开关：控制集成方案是否运行，如果关闭，则 TE 系统将不再拉取或接收该平台的数据
- 用户识别与关联：数据粒度为用户级别的平台才会出现，决定接收到的三方数据中哪些字段对应了 TE 系统的用户识别字段。TE 系统将根据该配置将三方数据转换为对应的 TE 用户的事件或用户数据
- 事件表入库设置：控制接收到的三方数据是否写入事件表，建议开启
- 用户属性入库规则：数据粒度为用户级别的平台才会出现，决定接收到的三方数据中哪些字段需要写入到对应的 TE 用户的用户表中，建议开启
- 定时拉取：集成类型为 API 的平台才会出现，如果开启，TE 系统将会在给定时间拉取指定时段的数据，强烈建议开启
- 数据源：集成类型为回传的平台，并且配置了数据上报地址的情况下才会出现，一般情况下，您只需要复制数据源的内容，并登录到三方平台，将其设置到回传配置中
- 集成方案：集成类型为 API 的平台才会出现，您必须创建方案并填写必要项（如拉取的 Token 等）才可以正确拉取数据
您可以点击左下角的恢复默认配置，来将上述参数重置为默认状态
另外，您还可以直接在配置页面的右上角点击查看平台对应的产品文档。页面右下角可以保存配置，或者点击取消回到主页，而集成类型为 Pull API 的平台还可以选择单次拉取。单次拉取意为立即执行一次数据拉取任务，您可以指定拉取的时间范围以及哪些集成方案需要进行拉取。
# 数据详情页
在主页点击查看详情，或者在编辑页点击详情 TAB 即可进入到数据详情页。数据详情页展示了最近转化完成的近 1000 条数据，您可以点击某条数据查看其转化前与转化后的明细。如果数据转化失败，您也可以在转化详情中查看到失败原因。您可以复制或导出当前选中的数据，或者点击下载数据批量导出所有详情页的数据。
注意
由于数据处理逻辑发生变更，因此巨量引擎与 TopOn 的数据详情页将无法展示数据详情，敬请谅解
# 数据处理逻辑
TE 系统支持了近 30 家第三方平台的数据集成，这些平台的提供的数据结构、数据含义各异。本章节将主要介绍第三方平台的数据接口分类、数据类型，以及 TE 系统提供了什么样的标准化服务来消弭平台间的差异。
# 4.1 接口分类
第三方平台用于提供的数据的功能可以被称为数据接口，可以从数据粒度与集成类型这两个维度对数据接口进行分类。
数据粒度
- 用户级别：每一条数据都是一个用户的一次曝光、点击或安装行为，TE 系统会将这些数据直接转化为 TE 的事件或用户数据
- 聚合指标：每一条数据包含了分析维度与各类指标，不包含用户信息，TE 系统会将这些数据以事件的形式记录在一个虚拟用户身上
以广告曝光来理解两种数据粒度的差异：
- 用户级别的广告曝光数据，数据中记录了用户的信息以及广告的信息，每一条数据代表了一次曝光，曝光数据的总数据量（或者说事件量）就是曝光量
- 聚合指标的只会有一条或几条数据，广告曝光量只是每一条数据中的一个指标字段，该条数据中除了广告曝光量以外，通常还会包括广告点击量、转化量、成本等其他指标，也会包含广告维度字段，比如广告计划、广告组等，每一条数据代表了最细的分析维度的指标情况，比如某个广告计划的一条广告的点击量、曝光率、总成本等
一般来说，用户级别数据可以像其他的事件一样，在各个分析模型中使用；而聚合指标数据则由于其并不是实际用户产生的行为，只能在事件模型、留存模型（主要用于计算 ROI）以及 SQL 查询中使用。
集成类型
- 回传：回传指的是第三方平台会将它们的原始数据以较实时的方式回传给 TE 系统，数据会持续流入。目前 TE 系统支持的所有回传类型集成方案，其数据粒度都是用户级别。在一些场合也会被称为 Push API
- API：API 指的是第三方平台提供的拉取数据接口，TE 系统根据配置向第三方平台发送拉取数据请求，数据只会在拉取请求通过后才会传入。目前 TE 系统支持的 API 类型集成方案，数据粒度大多数都是聚合指标，有少部分是用户级别。在一些场合也会被称为 Pull API
集成类型影响了数据的实时性，如回传数据基本是实时的，而 API 数据存在一定的延迟。另外，集成类型的配置方式也有所不同：回传数据的主要配置在第三方平台处，您在 TE 系统只需要复制回传地址即可；API 数据则需要在 TE 系统配置拉取的 Token、时间范围、拉取频率以及指标、维度等信息。
# 4.2 数据类型
尽管不同平台的数据存在差异，但是对于广告投放与变现来说，最为核心的数据可以被归类为以下六种，在三方集成主页中，您可以看到每个平台支持的数据类型：
| 数据类型 | 含义 |
|---|---|
| 归因数据 | 用户归因后的广告来源信息，归因数据只可能是用户级别的，可以在用户的安装事件与用户属性中查看到归因情况 |
| 成本数据 | 买量花费的成本，可能是聚合指标，也可以是每个用户的用户级别成本 |
| 收益数据 | 通过变现广告获得的收益情况，可能是聚合指标，也可以是每条变现广告获得的用户级别收益 |
| 展示数据 | 即买量广告或变现广告的曝光情况，可能是聚合指标，也可以是每条广告的展示数据 |
| 点击数据 | 即买量广告或变现广告的点击情况，可能是聚合指标，也可以是每条广告的点击数据 |
| 转化数据 | 非自然量用户在游戏/应用内产生转化行为的情况，绝大多数平台，转化行为指的都是用户安装，可能是聚合指标，也可以是每个用户的转化行为事件 |
# 4.3 标准化字段
为了方便市场投放人员统合分析不同平台的广告数据，TE 系统提供了字段标准化的功能。TE 系统按照预设的逻辑，将接收到的数据中的核心字段写入到一个对象字段 te_ads_object 中，从而实现跨平台核心字段统一的功能。TE 系统支持接入的绝大多数平台都能自动提供了字段标准化的能力。
| 标准化字段 | 含义 |
|---|---|
| te_ads_object.ad_account_id | 广告账号 ID |
| te_ads_object.campaign_name | 广告计划名 |
| te_ads_object.campaign_id | 广告计划 ID |
| te_ads_object.ad_group_name | 广告组名，变现广告的 Unit 名 |
| te_ads_object.ad_group_id | 广告组 ID，变现广告的 Unit ID |
| te_ads_object.ad_name | 广告名 |
| te_ads_object.ad_id | 广告 ID |
| te_ads_object.placement | 广告位置 |
| te_ads_object.media_source | 媒体渠道或变现渠道 |
| te_ads_object.app_id | 应用 ID |
| te_ads_object.app_name | 应用名 |
| te_ads_object.platform | 平台，即 Android、iOS 等 |
| te_ads_object.country | 国家地区编码 |
| te_ads_object.currency | 成本或收益的币种 |
| te_ads_object.impressions | 曝光量 |
| te_ads_object.clicks | 点击量 |
| te_ads_object.installs | 转化量（安装） |
| te_ads_object.cost | 买量成本 |
| te_ads_object.revenue | 变现收益 |