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