manuallatest产品手册 / Mintegral 集成方案
Mintegral 集成方案
提示
请注意，第三方数据集成产生的数据会被纳入集群的消耗数据量
概要
接口简介
| 接口名 | 类型 | 粒度 | 归因 | 成本 | 收益 | 展示 | 点击 | 转化 |
|---|---|---|---|---|---|---|---|---|
| 广告投放报表 进阶版 | API | 聚合指标 | ✅ | ✅ | ✅ | ✅ |
目前 AE 系统支持接入 Mintegral 的投放数据，可以通过广告投放报表回传点击、展示、安装、成本等聚合指标数据
集成流程
与Mintegral 投放数据的集成流程如下：
- 登录广告主平台，获取 Access Key 与 API Key
- 登录 AE 后台，进入三方集成模块，新增 Mintegral 集成方案，完成相关配置
- 查看 AE 系统是否成功接收数据，并完成报表搭建
一、获取授权信息
在进行数据接入前，您需要登录广告主平台后，点击导航栏的「账号管理」-「基本信息」，获取您的 Access Key 与 API Key。
二、方案配置
当您从 Mintegral 后台获得了授权信息后，您可以登录 AE 系统，在「三方集成」模块中完成新方案的配置。下图是 Mintegral 的配置界面，请您按照本章节内容完成方案的创建：
2.1 授权信息配置
点击「授权信息」下的「配置授权信息」按钮，在弹出框内填写您在上一步中获得的信息：
2.2 定时拉取
您可以在「定时拉取」模块设置 AE 系统定时拉取 Mintegral 数据的策略，可以选择在每天的某时拉取一段时间的数据。由于拉取的数据也会计入数据量，建议不要定时拉取太长时间的数据
2.3 入库设置
您可以控制数据是否以事件的形式写入，如果关闭，则数据将不会写入事件表，因此请不要关闭该配置。
2.4 集成配置
最后，您可以在集成配置模块对数据拉取的细节配置进行控制。包括数据的时间聚合粒度，拉取的指标字段与维度，以及入库后的事件名等。
集成配置中的内容是一个 JSON，您可以按照以下内容进行自定义配置：
| 模块 | 名称 | 含义 |
|---|---|---|
| sink_event | event_name | 入库后的事件名，可以自定义，字符串类型。 |
| source | time_granularity | 数据拉取的时间粒度，可以选择：
|
| group_by | 数据中的分组维度，列表类型，可以自定义 | |
| transfer | double_columns | 数据中的指标，列表类型，其中的字段会在数据接收时以数值类型入库，其余字段以字符串（或时间）入库。不建议调整 |
- 分析粒度
以下展示的是广告投放报表支持的分析维度以及默认拉取的维度。需要注意，部分字段在小时粒度是不支持的。如需修改，请将维度名写在 source.group_by 中：
| 维度 | 分组字段 | 描述与备注 | 是否默认 |
|---|---|---|---|
Offer | Offer ID | 广告单元 ID | 是 |
| Offer Name | 广告单元名称 | 是 | |
| Offer UUID | 系统自动生成的广告单元名称 | 是 | |
| Campaign | Campaign ID | 广告（计划）ID | 是 |
| Creative | Creative ID | 素材 ID，不支持小时粒度，与 Sub 维度不兼容 | 是 |
| Creative Name | 素材名，不支持小时粒度，与 Sub 维度不兼容 | 是 | |
| AdType | Ad Type | 广告类型 | 是 |
| Location | Location | 广告投放的国家 | 是 |
| Currency | 货币 | 是 | |
| Sub | Sub ID | 与 Creative 维度不兼容 |
2.5 数据入库规则
- 使用数据中的 date 或 timestamp（小时） 字段，即数据的聚合时间，作为事件的 #event_time
- 数据事件名为：mintegral_performance_report
- 其他字段将全数入库
以下展示的是广告投放报表支持的维度与指标字段，维度字段需要选用相应的分析粒度才会包含在数据中：
| 字段 | 说明 | 备注 |
|---|---|---|
| offer_id | 广告单元 ID | |
| offer_name | 广告单元名称 | |
| offer_uuid | 系统自动生成的广告单元名称 | |
| campaign_id | 广告（计划）ID | |
| campaign_name | 广告名称 | 由 campaign_id 引入 |
| creative_id | 素材 ID | 小时级报表不可用 |
| creative_name | 素材名 | 小时级报表不可用 |
| product_name | 产品的名称 | 由 campaign_id 引入 |
| package_name | 产品的包名 | 由 campaign_id 引入 |
| platform | 应用平台 | 由 campaign_id 引入 |
| sub_id | Sub ID | |
| ad_type | 广告类型 | |
| click | 点击总数 | |
| conversion | 转化数 | |
| cpc | CPC | |
| ctr | CTR | |
| currency | 货币，默认值为 USD | |
| cvr | CVR | |
| ecpm | eCPM | |
| impression | 展示总和 | |
| location | 广告投放的国家 | |
| spend | 支出总和 |
2.6 标准化字段
Mintegral 数据中的部分字段，AE 系统会进行标准化处理：
| 原字段 | 标准化字段 | 备注 |
|---|---|---|
| campaign_id | te_ads_object.campaign_id | 广告（计划）ID |
| campaign_name | te_ads_object.campaign_name | 广告名称 |
| offer_id | te_ads_object.ad_group_id | 广告单元 ID |
| offer_name | te_ads_object.ad_group_name | 广告单元名称 |
| creative_id | te_ads_object.ad_id | 素材 ID |
| creative_name | te_ads_object.ad_name | 素材名 |
| product_name | te_ads_object.app_name | 产品的名称 |
| package_name | te_ads_object.app_id | 产品的包名 |
| platform | te_ads_object.platform | 应用平台 |
| click | te_ads_object.clicks | 点击总数 |
| conversion | te_ads_object.installs | 转化数 |
| currency | te_ads_object.currency | 货币，默认值为 USD |
| impression | te_ads_object.impressions | 展示总和 |
| location | te_ads_object.country | 广告投放的国家 |
| spend | te_ads_object.cost | 支出总和 |
这篇文档对你有帮助吗？