# 百度营销数据集成方案

TIP

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

# 概要

# 接口简介

接口名	类型	粒度	归因	成本	收益	展示	点击	转化
搜索推广账户报告	API	聚合指标		✅		✅	✅	✅

目前 TE 系统支持接入百度营销数据的搜索推广账户报告 (opens new window)，可以获取推广账号下的消耗、点击、展示、转化等指标

# 集成流程

登录 TE 后台，进入三方集成模块，新增百度营销数据集成方案，并完成相关配置，并复制授权回调地址
在百度营销后台，认证成为开发者，创建应用并获得 AppID 和 secretKey
回到 TE 后台，修改之前的百度营销数据集成方案，使用应用的 AppID 和 secretKey，并打开授权链接完成授权
查看 TE 系统否成功接收数据，并完成报表搭建

# 一、方案配置

接入百度数据平台前，需要先在 TE 后台创建相应的集成方案，并获取授权回调地址，您可以按照本文档完成集成方案的创建

# 1.1 临时编写授权信息

首先点击授权信息栏的「配置授权信息」按钮，在弹出的授权信息弹窗中，先随意编写授权信息，作为临时的授权信息。之后在完成百度数据平台的应用创建后，还需进行调整。

# 1.2 定时拉取

您可以在「定时拉取」模块设置 TE 系统定时拉取百度营销数据的策略，可以选择在每天的某时拉取一段时间的数据。由于拉取的数据也会计算再数据量中，建议您在不要定时拉取太长时间的数据

# 1.3 入库设置

您可以控制数据是否以事件的形式写入，如果关闭，则数据将不会写入事件表，因此请不要关闭该配置。

# 1.4 集成配置

最后，您可以在集成配置模块对数据拉取的细节配置进行控制。包括数据的时间聚合粒度，拉取的指标字段与维度，以及入库后的事件名等。

集成配置中的内容是一个 JSON，您可以按照以下内容进行自定义配置：

模块	名称	含义
sink_event	event_name	入库后的事件名，可以自定义
source	time_granularity	数据的时间聚合粒度，即拉取的数据以天还是小时进行聚合可选值: DAY、HOUR
	group_by	数据中的分组维度，列表类型，可以自定义
	metrics	对应接口的指标字段，列表类型，可以自定义

- 分组维度

以下是百度营销搜索推广账户报告支持的分组维度，如需调整，可以将需要的分组维度的维度名写入 source.group_by 中

维度名	入库字段名	说明	备注	是否默认拉取
date	#event_time	日期	不同时间单位对应的日期格式： DAY: 2021-03-31 HOUR: 2021-03-31 23:00	是
userName	username	账户		是
businessPointId	businesspointid	推广业务ID		是
businessPointName	businesspointname	推广业务		是
wBudget	wbudget	预算		是
budgetEfficiency	budgetefficiency	预算利用率		是
device	device	推广设备	枚举值： 0:计算机 1:移动设备	是
marketingTargetEnum	marketingtargetenum	营销目标	枚举值： 0:网站链接 1:应用推广 2:门店推广 3:推广营销活动 4:电商店铺推广 5:商品目录	是
targetingType	targetingtype	购买方式	枚举值： 0:关键词 6:网址定向	是
provinceName	provincename	省	该指标不支持小时
provinceCityName	provincecityname	城市	该指标不支持小时

- 指标字段

以下是百度营销搜索推广账户报告支持的指标字段，如需调整，可以将需要的分组维度的维度名写入 source.metrics 中。另外，百度营销支持了一系列转化指标，由于转化指标较多，未能在本列表中展示，如需了解，请查看官方文档 (opens new window)，并将需要接入的指标的名称填写在 source.metrics 中

名称	入库字段名	说明	备注	是否默认拉取
impression	impression	展现		是
click	click	点击		是
cost	cost	消费		是
ctr	ctr	点击率		是
cpc	cpc	平均点击价格		是
topPageViews	toppageviews	上方位展现		是
topPClicks	toppclicks	上方位点击		是
topPay	toppay	上方位消费		是
topPvWinA	toppvwina	上方展现胜出率	【上方展现胜出率】与【推广业务】互斥并该指标不能与provinceCityName,cityName同时请求！上方展现胜出率=账户上方展现／账户符合投放条件的搜索次数
topPvWinP	toppvwinp	上方展现胜出率（精确)	【上方展现胜出率（精确）】与【推广业务】互斥并该指标不能与provinceCityName,cityName同时请求！上方展现胜出率（精确）=账户精确触发的上方展现／账户符合投放条件&符合精确触发的搜索次数
topFirstPageViews	topfirstpageviews	上方位首位展现		是
topFirstPvWinA	topfirstpvwina	上方首位胜出率	【上方首位胜出率】与【推广业务】互斥
topFirstPvWinP	topfirstpvwinp	上方首位胜出率（精确)	【上方首位胜出率（精确)】与【推广业务】互斥
ocpcConversionsDetail4	ocpcconversionsdetail4	激活人数	完成激活行为（首次下载安装并打开应用）的用户数	是