百度营销数据集成方案
请注意，第三方数据集成产生的数据会被纳入集群的消耗数据量
概要
接口简介
| 接口名 | 类型 | 粒度 | 归因 | 成本 | 收益 | 展示 | 点击 | 转化 |
|---|---|---|---|---|---|---|---|---|
| 数据报告（搜索推广账户报告） | API | 聚合指标 | ✅ | ✅ | ✅ | ✅ |
目前 AE 系统支持接入百度营销数据的「数据报告」（搜索推广账户报告），可以获取推广账号下的消耗、点击、展示、转化等指标
集成流程
- 登录 AE 后台，进入三方集成模块，新增百度营销数据集成方案，并完成相关配置，并复制授权回调地址
- 在百度营销后台，认证成为开发者，创建应用并获得 AppID 和 secretKey
- 回到 AE 后台，修改之前的百度营销数据集成方案，使用应用的 AppID、secretKey 和要拉取数据的推广账户名称（User Name），并打开授权链接完成授权
- 查看 AE 系统是否成功接收数据，并完成报表搭建
一、方案配置
接入百度数据平台前，需要先在 AE 后台创建相应的集成方案，并获取授权回调地址，您可以按照本文档完成集成方案的创建
1.1 临时编写授权信息
首先点击授权信息栏的「配置授权信息」按钮，在弹出的授权信息弹窗中，先随意编写授权信息，作为临时的授权信息。之后在完成百度数据平台的应用创建后，还需进行调整。
1.2 定时拉取
您可以在「定时拉取」模块设置 AE 系统定时拉取百度营销数据的策略，可以选择在每天的某时拉取一段时间的数据。由于拉取的数据也会计入数据量，建议不要定时拉取太长时间的数据
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 中。另外，百度营销支持了一系列转化指标，由于转化指标较多，未能在本列表中展示，如需了解，请查看官方文档，并将需要接入的指标的名称填写在 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 | 激活人数 | 完成激活行为（首次下载安装并打开应用）的用户数 | 是 |
1.5 获取授权回调地址
在完成上述配置后，请点击右上角的保存并授权获取授权信息。请复制第一步中的授权回调地址，并妥善保管。之后点击「暂不授权」关闭该弹窗：
点击「保存并授权」时方案就已经保存，不需要再单独保存，至此您暂时完成了 AE 后台的配置工作，接下来请在百度营销后台完成相关配置。
二、注册百度营销开发者，并获取授权信息
2.1 注册成为开发者
开发者权限需先完成注册成为开发者进行申请
2.2 创建应用并获得 AppID、secretKey
申请开发者权限并审核通过后，请您创建一个应用，按照界面提示，完成相关信息录入。回调地址处，请填写在 AE 系统中获取到的回调地址。
完成配置后，请点击「提交审核」，百度 API 同学审核通过后，您可以获取应用的 appId 与 secretKey 字段，开发者可通过应用授权 TAB 栏进行查看
三、回到 AE 后台，完成授权工作
完成百度营销数据后台的配置后，回到 AE 后台，进入到之前的创建的百度营销数据集成方案，点击授权信息栏的「配置授权信息」按钮：
接下来，请将您在百度营销数据后台获取到的 appId 与 secretKey 填入相应位置，并在「User Name」中填写要拉取数据的百度营销推广账户名称。完成编辑后点击保存按钮：
接着点击右上角的「保存并授权」，再次进入到授权信息弹窗。此时点击「前往授权」，将打开百度营销数据平台的授权页面。方案已保存但还没有完成授权时，方案页顶部会显示「当前方案尚未完成授权，数据无法接入，请前往授权」提示条，点击其中的「去授权」也能打开授权信息弹窗
请您登录您需要拉取数据的百度营销数据账号，并在下列页面中完成授权：
当您完成了授权之后，请在「授权信息」中点击左下角的「我已完成以上两步操作」后点击右下角的「完成授权」结束配置。至此，您完成了百度营销平台的数据集成。
四、数据入库
4.1 入库规则
- 由于搜索推广账号报告是聚合数据，因此我们将使用一个固定值作为其用户标识，您可以认为所有数据挂载在一个虚拟用户上
- 使用数据中的 date 字段，即数据的聚合时间，作为事件的 #event_time
- 数据事件名为：baidu_search_account_report
- 其他字段将全数入库
4.2 标准化字段
AE 系统会对以下字段进行标准化处理：
| 原始字段 | 标准化字段 | 含义 |
|---|---|---|
| impression | te_ads_object.impressions | 曝光量 |
| click | te_ads_object.clicks | 点击量 |
| cost | te_ads_object.cost | 投放成本 |