# Mintegral 集成方案
TIP
请注意,第三方数据集成产生的数据会被纳入集群的消耗数据量
# 概要
# 接口简介
接口名 | 类型 | 粒度 | 归因 | 成本 | 收益 | 展示 | 点击 | 转化 |
---|---|---|---|---|---|---|---|---|
广告投放报表 进阶版 | API | 聚合指标 | ✅ | ✅ | ✅ | ✅ |
目前 TE 系统支持接入 Mintegral 的投放数据,可以通过广告投放报表 (opens new window)回传点击、展示、安装、成本等聚合指标数据
# 集成流程
与Mintegral 投放数据的集成流程如下:
- 登录广告主平台,获取 Access Key 与 API Key
- 登录 TE 后台,进入三方集成模块,新增 Mintegral 集成方案,完成相关配置
- 查看 TE 系统否成功接收数据,并完成报表搭建
# 一、获取授权信息
在进行数据接入前,您需要登录广告主平台后,点击导航栏的「账号管理」-「基本信息」,获取您的 Access Key 与 API Key。
# 二、方案配置
当您从 Mintegral 后台获得了授权信息后,您可以登录 TE 系统,在「三方集成」模块中完成新方案的配置。下图是 Mintegral 的配置界面,请您按照本章节内容完成方案的创建:
# 2.1 授权信息配置
点击「授权信息」按钮,在弹出框内填写您在上一步中获得的信息:
# 2.2 定时拉取
您可以在「定时拉取」模块设置 TE 系统定时拉取 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 | 广告单元名称 ID | 是 | |
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 | 广告单元名称 ID | |
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 数据中的部分字段,TE 系统会进行标准化处理:
原字段 | 标准化字段 | 备注 |
---|---|---|
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 | 广告单元名称 ID |
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 | 支出总和 |