# 三方集成
三方集成模块提供了一系列第三方广告平台的集成能力，可以将这些平台的广告投放与广告变现数据同步到 TE 系统中来。本文将重点介绍三方集成模块下各页面的核心功能以及三方集成模块的基本概念，想要了解各平台的具体接入方式，可以查看本页面的子页面。
# 一、三方集成主页
三方集成的主页展示了当前已接入的集成方案及其基本信息，包括集成方案的名称，集成的平台与接口信息，现在的集成状态，方案创建人以及最后修改时间等。
需注意，新版本增加了三方集成配置的上限数，每个项目能同时存在的三方集成配置数不能超过该上限。如果达到了上限，您可以通过删除不需要的方案来释放配置数。
您可以点击右上角「创建方案」可以进入方案选择页，选择当前已支持的数据接口进行接入。也可以点击卡片内的编辑按钮进入到方案编辑页，对集成方案的配置进行修改：
# 二、方案选择页
方案选择页展示了当前支持的所有集成方式的基本信息，您可以选择您需要的接入方式，点击卡片即可进入该集成方式的编辑页面。
方案选择页也提供了搜索功能，您可以通过平台名称搜索需要接入数据的平台。
# 三、配置页面
当您在三方集成主页点击编辑按钮，或者在方案选择页点击了集成方式卡片后，都将进入三方集成的配置页面。上图展示的是 Adjust 实时回传方案的配置页面。由于各平台的数据逻辑不同，各平台的配置页面也不尽相同。
配置页面会展示所选方案的基本信息，您可以从中了解该方案能支持的数据类型。另外，您也可以点击「对接文档」链接来访问该方案的集成方案文档。
此外，您可以在配置页面调整数据集成的规则。如上图所示，您可以修改三方数据入库时所选的用户识别字段，事件是否入库，以及用户属性是否入库。如果希望进行更深入的调整，可以在「集成配置」栏中调整 JSON，从而控制拉取数据的具体配置。想要了解各平台的配置方式，可以查看相应平台接口的集成方案文档。
# 四、数据处理逻辑
TE 系统现已支持超过 40 种第三方平台数据集成方案，不同方案提供的数据，在结构与含义都各不相同。本章节将主要介绍第三方平台的数据接口分类、数据类型，以及 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 | 变现收益 |
# 五、历史方案迁移问题
在 4.2 版本之前，TE 系统支持的大多数三方集成方案都是由 TE 工作人员进行配置的，这些配置可以被称为历史方案。在 4.2 版本发布后，我们会自动创建历史方案的新配置副本，并可以在「三方集成」模块查看到。对于回传类型的方案，我们将直接完成所有迁移工作，而 API 类型的方案，我们只会迁移部分配置参数，该方案本身仍不可用，且状态标识为「方案迁移」。
为了不影响数据正常入库，我们采用如下做法：
- 升级至 4.2 后，API 类型的方案继续使用历史方案进行数据拉取，「三方集成」模块中处于「方案迁移」状态的方案实际未执行。回传类型的方案直接使用「三方集成」模块中的新方案，且状态为「已接入」，即处于正常接入状态
- 如果没有特殊需要，对于之前已存的方案，我们建议您继续使用历史方案
- 如需上线「方案迁移」状态的新方案，请联系 TE 工作人员进行操作