menu
Is this helpful?

# Mintegral 集成方案

TIP

请注意,第三方数据集成产生的数据会被纳入集群的消耗数据量

# 概要

# 接口简介

接口名 类型 粒度 归因 成本 收益 展示 点击 转化
广告投放报表 进阶版 API 聚合指标 ✅ ✅ ✅ ✅

目前 TE 系统支持接入 Mintegral 的投放数据,可以通过广告投放报表 (opens new window)回传点击、展示、安装、成本等聚合指标数据

# 集成流程

与Mintegral 投放数据的集成流程如下:

  1. 登录广告主平台,获取 Access Key 与 API Key
  2. 登录 TE 后台,进入三方集成模块,新增 Mintegral 集成方案,完成相关配置
  3. 查看 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 数据拉取的时间粒度,可以选择:
  • 天:day

  • 小时:hour

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 支出总和