# OPPO 营销平台集成方案
TIP
请注意，第三方数据集成产生的数据会被纳入集群的消耗数据量
# 概要
# 接口简介
| 接口名 | 类型 | 粒度 | 归因 | 成本 | 收益 | 展示 | 点击 | 转化 |
|---|---|---|---|---|---|---|---|---|
| 游戏明细数据 | API | 聚合指标 | ✅ | ✅ | ✅ | ✅ | ✅ |
目前 TE 支持接入 OPPO 营销平台的游戏明细数据 (opens new window)，支持获取广告创意层级的成本、点击、展示等聚合指标数据
# 集成流程
- 登录 OPPO 营销后台，获取 API 密钥并收集所需的授权信息
- 登录 TE 后台，进入三方集成模块，新增 OPPO 集成方案，并完成相关配置
- 查看 TE 系统否成功接收数据，并完成报表搭建
# 一、获取授权信息
在接入 OPPO 营销平台的数据之前，您需要先获取拉取数据时需要的基本信息。请您使用需要拉取广告数据的 OPPO 账号登录 OPPO 营销平台，点击「工具箱」-「账号辅助」-「API 秘钥获取」，进入到「API 密钥」页面。如果您还没有申请过密钥，请点击「获取密钥」按钮生成密钥：
生成密钥后，您需要记录以下三个信息，分别为广告主 ID、API-ID 与 API-KEY。这些信息将在之后创建集成方案时被使用，请妥善保管好。
# 二、方案配置
当您从 OPPO 后台获得了授权信息后，您可以登录 TE 系统，在「三方集成」模块中完成新方案的配置。下图是 OPPO 游戏明细数据的配置界面，请您按照本章节内容完成方案的创建：
# 2.1 授权信息配置
点击「授权信息」按钮，在弹出框内填写您在上一步中获得的信息：
APP ID 和 APP Key 分别为 OPPO 后台的 API-ID 与 API-KEY，Account ID 填写广告主 ID
# 2.2 定时拉取
您可以在「定时拉取」模块设置 TE 系统定时拉取 OPPO 游戏明细数据的策略，可以选择在每天的某时拉取一段时间的数据。由于拉取的数据也会计算再数据量中，建议您在不要定时拉取太长时间的数据
# 2.3 入库设置
您可以控制数据是否以事件的形式写入，如果关闭，则数据将不会写入事件表，因此请不要关闭该配置。
# 2.4 集成配置
最后，您可以在集成配置模块对数据拉取的细节配置进行控制。包括数据的时间聚合粒度，拉取的指标字段与维度，以及入库后的事件名等。
集成配置中的内容是一个 JSON，您可以按照以下内容进行自定义配置：
| 模块 | 名称 | 含义 |
|---|---|---|
| sink_event | event_name | 入库后的事件名，可以自定义 |
| transfer | fields_whitelist | 入库的字段清单，可以自定义。由于 OPPO 游戏明细数据返回的字段较多，因此使用该字段过滤了入库的字段，如需调整入库字段，请参考下文 |
以下展示的是 OPPO 游戏明细数据返回的字段清单，其中部分字段没有入库。如需调整入库的字段，请将字段名写入 transfer.fields_whitelist 中：
| 名称 | 是否入库 | 字段名与备注 |
|---|---|---|
| fdate | 是 | 数据日期，如20210614 |
| app_id | 是 | 应用id |
| app_name | 是 | 应用名称 |
| owner_id | 是 | 广告主Id |
| owner_name | 是 | 广告主名称 |
| group_id | 是 | 广告组Id |
| group_name | 是 | 广告组名称 |
| plan_id | 是 | 计划id |
| plan_name | 是 | 计划名称 |
| ad_id | 是 | 广告id |
| ad_name | 是 | 广告名称 |
| extension_type | 是 | 推广目标 1链接推广，2应用推广，3快应用，7微信小程序推广，8直播推广 |
| global_spec_id | 是 | 统一规格id |
| extension_flow | 是 | 推广流量：0默认值无意义，1全流量场景、2自有流量、3联盟流量 |
| flow_scene | 是 | 流量场景:0默认值无意义、1全流量推广、2精选推广、3安装有礼、4开机必备、5搜索、6信息流、7Banner、8开屏、9插屏、10原生、11激励视频、12联盟不限、13展示优选 |
| total_pay | 是 | 总付费流水（分） |
| ad_new_ssoid | 是 | 注册人数 |
| ad_new_pay_ssoid | 是 | 新增付费人数 |
| ad_new_pay | 是 | 首日付费流水（单位：分） |
| down_cnt | 是 | 下载次数（搜索&分发：实扣下载；信息流合联盟：总下载） |
| expose_nums | 是 | 曝光数 |
| click_nums | 是 | 点击数 |
| click_rate | 是 | 点击率，小数 |
| down_rate | 是 | 下载率，小数 |
| register_rate | 是 | 注册率，小数 |
| register_price | 是 | 注册成本 |
| new_pay_price | 是 | 付费成本 |
| active_nums | 是 | 激活人数，通过买量下载最近180天激活的用户 |
| active_rate | 是 | 激活率，小数 |
| new_pay_rate | 是 | 付费转化率，小数 |
| ad_price | 是 | 广告实扣金额（单位：分） |
| new_user_ltv1 | 游戏付费LVT1（单位：分） | |
| new_user_ltv3 | 游戏付费LVT3（单位：分） | |
| new_user_ltv7 | 游戏付费LVT7（单位：分） | |
| new_user_ltv30 | 游戏付费LVT30（单位：分） | |
| buy_user_income0 | 是 | 首日广告收入（单位：分） |
| inter_buy_roi1 | 广告变现ROI1 | |
| inter_buy_roi3 | 广告变现ROI3 | |
| inter_buy_roi7 | 广告变现ROI7 | |
| inter_buy_roi30 | 广告变现ROI30 | |
| new_user_roi1 | 游戏付费ROI1 | |
| new_user_roi3 | 游戏付费ROI3 | |
| new_user_roi7 | 游戏付费ROI7 | |
| new_user_roi30 | 游戏付费ROI30 | |
| ecpm | 是 | |
| click_price | 是 | 点击均价（单位：分） |
| down_price | 是 | 下载成本（单位：分） |
| active_price | 是 | 激活成本（单位：分） |
| inter_buy_ltv1 | 广告变现LTV1（单位：分） | |
| inter_buy_ltv3 | 广告变现LTV3（单位：分） | |
| inter_buy_ltv7 | 广告变现LTV7（单位：分） | |
| inter_buy_ltv30 | 广告变现LTV30（单位：分） | |
| 10per_total_pay | 1-9分成付费流水（单位：分） | |
| 50per_total_pay | 5-5分成付费流水（单位：分） | |
| pay_retention1 | 次日留存数（付费） | |
| pay_retention3 | 3日留存数 | |
| pay_retention7 | 7日留存数 | |
| pay_retention14 | 14日留存数 | |
| pay_retention30 | 30日留存数 | |
| pay_retention1_rate | 次日留存率 | |
| pay_retention3_rate | 3日留存率 | |
| pay_retention7_rate | 7日留存率 | |
| pay_retention14_rate | 14日留存率 | |
| pay_retention30_rate | 30日留存率 | |
| activate_nums | 是 | 启动用户数 |
| cash_retention1 | 次日留存数（变现） | |
| cash_retention3 | 3日留存数（变现） | |
| cash_retention7 | 7日留存数（变现） | |
| cash_retention1_rate | 次日留存率（变现） | |
| cash_retention3_rate | 3日留存率（变现） | |
| cash_retention7_rate | 7日留存率（变现） | |
| buy_user_income_active | 是 | 买量广告收入（单位：分） |
| buy_user_income_active_roi | 是 | 广告变现活跃ROI |
| game_app_act_nums | 是 | 游戏关键行为量 |
| game_app_act_price | 是 | 游戏关键行为成本（单位：分） |
| pay_nums | 是 | 付费次数 |
| pay_per_price | 是 | 每次付费成本（单位：分） |
# 2.5 入库规则
- 由于游戏明细数据是聚合数据，因此我们将使用一个固定值作为其用户标识，您可以认为所有数据挂载在一个虚拟用户上
- 使用数据中的 fdate 字段，即数据聚合时间，作为事件的 #event_time
- 默认的事件名为：oppo_game_offline_data
- transfer.fields_whitelist 中的字段将全数入库
# 2.6 标准化字段
TE 系统会对以下字段进行标准化处理：
| 原始字段 | 标准化字段 | 含义 |
|---|---|---|
| owner_id | te_ads_object.ad_account_id | 广告账号 ID |
| plan_id | te_ads_object.campaign_id | 广告计划 ID |
| plan_name | te_ads_object.campaign_name | 广告计划名称 |
| group_id | te_ads_object.ad_group_id | 广告组 ID |
| group_name | te_ads_object.ad_group_name | 广告组名称 |
| ad_id | te_ads_object.ad_id | 广告 ID |
| ad_name | te_ads_object.ad_name | 广告名称 |
| app_name | te_ads_object.app_name | 应用名 |
| expose_nums | te_ads_object.impressions | 曝光量 |
| click_nums | te_ads_object.clicks | 点击量 |
| down_cnt | te_ads_object.installs | 转化数 |
| ad_price | te_ads_object.cost | 买量成本，除以 100，单位为元 |
| buy_user_income_active | te_ads_object.revenue | 变现收益，除以 100，单位为元 |