广告场景
1. 功能介绍#
TradPlus 支持在一个广告位下创建多个广告场景，用于区分不同广告场景下的展示、点击数据，可帮助开发者了解广告场景维度的展示、点击和到达广告场景时的广告 Ready 率等数据。
2. 使用场景#
如果希望通过 TradPlus 漏斗分析报表，分析广告展示是否最大化，则需要准确调用“进入广告场景”的方法。完成调用后，TradPlus 后台会自动统计两种重要指标：
用户的广告场景到达率，即到达广告场景用户数 / 启动应用用户数。
到达广告场景时的广告 Ready 率。
如果一个广告位下包含若干个广告场景，开发者想了解广告场景维度的数据（如展示、点击等），则需要在后台 -> 应用管理 -> 广告场景界面，创建广告场景。并在每次广告展示时，传入对应的广告场景 ID。
如果您的游戏是沙盒品类，可以通过广告场景功能，区分各开发者的广告数据。
3. 使用指南#
3.1 使用说明#
3.1.1 数据指标#
a. 进入广告场景：应用调用 TradPlus SDK 的进入广告场景接口。
b. 展示 ：TradPlus 记录的展示数。
c. 点击 ：TradPlus记录的广告点击数。注意：部分广告平台可能不提供点击回调。
d. 点击率 ：点击数 / 展示数。
e. 展示占比：该场景的展示数 / 该广告位总展示数。
3.2 添加广告场景#
3.2.1 前提条件#
已在【应用管理】中添加了广告位。
3.2.2 操作步骤#
1）点击【应用管理】-【广告场景】-【添加广告场景】。
2）填写广告场景信息
| 广告场景信息 | 说明 |
|---|---|
| 应用 | 选择需要添加广告场景的应用。 |
| 广告位 | 选择需要添加广告场景的广告位。 |
| 广告场景名称（必填） | 填写自定义的广告场景名称。 |
| 使用自定义广告场景ID | a. 选择否，则场景创建成功后，会自动生成广告场景ID，用于开发调用； b. 选择是，则需要填写自定义的广告场景ID。 |
| 状态 | 选择【启用】/【停用】广告场景 |
| 备注 | / |
3）确认广告场景信息填写无误后，点击【确定】，保存广告场景信息。
3.3 修改广告场景#
点击广告场景列表右侧【编辑图标】，即可进入修改页面。
3.4 调用广告场景#
在 TradPlus 后台添加广告场景后，需要在代码中进行调用，才能使用广告场景。
调用方式请参见：广告场景 | TradPlus Knowledge Center
3.5 查看、导出广告场景数据#
1）在广告场景列表页面即可查看广告场景数据。
2）点击报表右上角图标，选择【导出】，即可导出广告场景数据。
4. 最佳实践#
4.1. “进入广告场景”方法#
一般是在应用需要广告时调用进入广告场景的方法：
Android：entryAdScenario("sceneId")
iOS：entryAdScenario:@"您的广告场景ID"
如果需要区分不同广告场景的数据，需要在后台->应用管理->广告场景界面，生成广告场景ID； 如果不需要区分不同广告场景的数据，广告场景ID可以直接传空字符串。
不同广告类型的调用时机说明如下：
i. 激励视频
开发者根据应用对广告观看按钮的处理方式，选择相应的调用时机
| 广告按钮的处理方式 | 调用时机 |
|---|---|
| 应用在判断无广告时，会对广告按钮置灰或隐藏 | 在用户到达广告按钮所在界面时调用（见下图） |
| 应用不会对广告按钮置灰或隐藏，用户始终可点击广告按钮 | 在用户点击广告按钮时调用 |
ii. 插屏
在满足广告触发条件时调用“进入广告场景”方法，比如：
广告场景是在清理结束后弹出插屏广告，则在清理结束时调用；
广告场景是一局游戏结束后弹出插屏广告，则在游戏结束时调用。
iii. 原生
用户到达广告位所在界面时调用。
iv. 横幅
如果应用是在用户到达广告位之前加载广告，则在用户到达广告位所在界面时调用； 如果应用是在用户到达广告位时才加载广告，可不调用“进入广告场景”方法。
v. 开屏
可不调用。
4.2 展示广告的调用#
如果需要区分不同广告场景的展示数据，在调用showad接口时需传入sceneID。 SceneID在后台->应用管理->广告场景界面，生成广告场景ID。
5. 常见问题#
Q：广告场景与广告位有什么区别和联系？#
A：
区别：两者定义不同。
广告场景是指应用内展示广告的场景，例如如游戏结束弹出一个插屏广告，这就是一个广告场景。
广告位是 TradPlus SDK 请求广告的单位。
联系：
- 一个广告位可以对应多个广告场景。例如，一个激励视频广告位，对应“看视频得道具”、“每日签到”、“关卡复活” 3个场景。