本指南介绍了如何使用 Google Mobile Ads Unity Plugin 通过 AdMob 中介加载和展示来自 BidMachine 的展示广告（内容涵盖出价集成）。本指南还介绍了如何将 BidMachine 添加到广告单元的中介配置中，以及如何将 BidMachine SDK 和适配器集成到 Unity 应用中。
支持的集成和广告格式
BidMachine 的 AdMob 中介适配器具有以下功能：
| 集成 | |
|---|---|
| 出价 | 1 |
| 瀑布 | |
| 格式 | |
| 开屏广告 | |
| 横幅广告 | |
| 插页式广告 | |
| 激励广告 | |
| 插页式激励广告 | |
1 出价集成功能目前处于封闭式 Beta 版阶段，请与您的客户经理联系以申请访问权限。
2 原生广告格式处于 Alpha 阶段。所有其他受支持的广告格式均处于 Beta 版阶段。请与您的客户经理联系，申请访问权限。
要求
- “Google Mobile Ads Unity Plugin”的最新视频
- Unity 2019.4 或更高版本
- 如需在 Android 上部署，则要求：
- Android API 级别 23 或更高级别
- 如需在 iOS 上部署，则要求：
- iOS 部署目标版本为 13.0 或更高版本
- 已配置 Google Mobile Ads Unity Plugin 的有效 Unity 项目。如需了解详情，请参阅使用入门。
- 完成中介入门指南阅读。
第 1 步：在 BidMachine 界面中设置配置
登录您的 BidMachine 账号信息中心。
创建新的展示位置
前往来源标签页，然后在来源表格下选择修改按钮。
系统会显示您拥有的所有展示位置的列表。如需创建新的展示位置，请点击对话框中的添加展示位置按钮。
填写表单并点击保存。
Android
iOS
最后，记下展示位置 ID。
Android
iOS
更新 app-ads.txt
应用授权卖方 (app-ads.txt) 是一项 IAB Tech Lab 计划，有助于确保只通过您认定的授权渠道销售您的应用广告资源。为避免损失大量广告收入，您需要实施 app-ads.txt 文件。
如果您尚未完成此项设置，请为您的应用设置 app-ads.txt 文件。
如需为 BidMachine 实现 app-ads.txt，请从信息中心前往 app-ads.txt 标签页。然后，复制该列表并将其附加到网站的 app-ads.txt 文件中。
第 2 步：在 AdMob 界面中设置 BidMachine 需求
为广告单元配置中介设置
将 BidMachine 添加到 GDPR 和美国州级法规广告合作伙伴名单中
请按照欧洲法规设置和美国州级法规设置中的步骤，将 BidMachine 添加到 AdMob 界面内的欧洲法规和美国州级法规广告合作伙伴名单中。
第 3 步：导入 BidMachine SDK 和适配器
OpenUPM-CLI
如果您已安装 OpenUPM-CLI，则可以运行以下命令，将 Google 移动广告 BidMachine 中介插件（适用于 Unity）安装到您的项目中：
openupm add com.google.ads.mobile.mediation.bidmachineOpenUPM
在 Unity 项目编辑器中，依次选择 Edit（修改）> Project Settings（项目设置）> Package Manager（资源包管理器），打开 Unity 资源包管理器设置。
在限定范围的注册表标签页下，添加 OpenUPM 作为限定范围的注册表，并提供以下详细信息：
- 名称：
OpenUPM - URL：
https://package.openupm.com - 范围：
com.google
然后，依次前往 Window > Package Manager，打开 Unity Package Manager，并从下拉菜单中选择 My Registries。
选择 Google Mobile Ads BidMachine Mediation 软件包，然后点击 Install。
Unity 软件包
从更改日志中的下载链接下载最新版本的 Google 移动广告 BidMachine 中介插件，然后从 ZIP 文件中提取 GoogleMobileAdsBidMachineMediation.unitypackage。
在 Unity 项目编辑器中，依次选择 Assets > Import Package > Custom Package，然后找到您下载的 GoogleMobileAdsBidMachineMediation.unitypackage 文件。确保已选择所有文件，然后点击导入。
然后，依次选择 Assets > External Dependency Manager > Android Resolver > Force Resolve。外部依赖项管理器库将从头开始执行依赖项解析，并将声明的依赖项复制到 Unity 应用的 Assets/Plugins/Android 目录中。
第 4 步：在 BidMachine SDK 上实现隐私设置
欧盟地区意见征求和《一般数据保护条例》(GDPR)
为了遵守 Google 的《欧盟地区用户意见征求政策》，您必须向欧洲经济区 (EEA)、英国和瑞士的用户披露某些信息，并征得他们同意，才能在法律要求的情况下使用 Cookie 或其他本地存储空间，以及收集、分享和使用个人数据以实现广告个性化。此政策反映了欧盟《电子隐私指令》和《一般数据保护条例》(GDPR) 的要求。您要负责验证用户意见是否已传播到中介链中的每个广告来源。Google 无法自动将用户意见传递给此类广告资源网。
BidMachine 会自动读取由意见征求管理平台（包括 UMP SDK）设置的 GDPR 同意情况。如需了解详情，请参阅 BidMachine 针对 Android 和 iOS 发布的 GDPR 指南。
美国州级隐私保护法律
美国各州隐私保护法律要求向用户提供选择拒绝“出售”其“个人信息”（该法律中对这些术语做出了定义）的权利，“出售”方须在首页醒目位置提供“Do Not Sell My Personal Information”（不出售我的个人信息）链接，以供这些用户选择。美国州级隐私保护法律合规性指南可让您为 Google 广告投放启用受限的数据处理，但 Google 无法将此设置应用于您的中介链中的每个广告联盟。因此，您必须确定中介链中可能参与个人信息出售的每个广告联盟，并遵循这些广告联盟的指南来确保合规性。
BidMachine 会自动读取意见征求管理平台（包括 UMP SDK）设置的 GPP 意见征求。如需了解详情，请参阅 BidMachine 的 GPP 指南（Android 和 iOS）。
第 5 步：添加必需的代码
Android
无需为 BidMachine 集成添加其他代码。
iOS
SKAdNetwork 集成
按照 BidMachine 的 SKAdNetwork 支持文档中的说明，将 SKAdNetwork 标识符添加到项目的 Info.plist 文件中。
第 6 步：测试您的实现
启用测试广告
确保针对 AdMob 注册测试设备。
按照 BidMachine 文档中针对 Android 和 iOS 的说明操作，以启用 BidMachine 的测试模式。
验证测试广告
若要验证您是否能收到来自 BidMachine 的测试广告，请在广告检查器中启用 single ad source testing（单个广告来源测试），并选择 BidMachine (Bidding)（BidMachine [出价]）作为广告来源。
错误代码
如果适配器未能收到来自 BidMachine 的广告，发布商可以使用 ResponseInfo 来检查广告响应中归属于以下类的底层错误：
Android
io.bidmachine
com.google.ads.mediation.bidmachine
iOS
GADMediationAdapterBidMachine
以下是当广告加载失败时，BidMachine 适配器会抛出的代码和随附的消息：
Android
| 错误代码 | 网域 | 原因 |
|---|---|---|
| 100 | com.google.ads.mediation.bidmachine | 收到的展示位置 ID 无效或为空。 |
| 101 | com.google.ads.mediation.bidmachine | 信号收集期间出错：未找到信号数据配置。 |
| 102 | com.google.ads.mediation.bidmachine | 在信号收集期间收到了无效的广告格式。 |
| 103 | com.google.ads.mediation.bidmachine | 请求的广告尺寸无法映射到 bidmachine.BannerSize |
| 104 | com.google.ads.mediation.bidmachine | 已加载的 BidMachine 广告请求已过期。 |
| 105 | com.google.ads.mediation.bidmachine | 无法显示全屏广告。 |
| 106 | com.google.ads.mediation.bidmachine | BidMachine SDK 返回了包含 null 广告数据的 onAdLoaded() 回调。 |
iOS
| 错误代码 | 网域 | 原因 |
|---|---|---|
| 101 | com.google.mediation.bidmachine | 服务器配置缺少必需的发布商 ID。 |
| 102 | com.google.mediation.bidmachine | 出价信号收集请求失败，因为 RTB 参数不包含广告格式或指定格式不受支持。 |
| 103 | com.google.mediation.bidmachine | 加载广告的广告配置无效。 |
| 104 | com.google.mediation.bidmachine | BidMachine SDK 向横幅广告的 BidMachineAdProtocol didLoadAd 委托方法返回了非横幅广告。绝不应发生。 |
| 105 | com.google.mediation.bidmachine | 全屏广告尚未准备好展示。 |
| 106 | com.google.mediation.bidmachine | Bid Machine SDK 向原生广告的 BidMachineAdProtocol didLoadAd 委托方法返回了非原生广告。绝不应发生。 |
| 107 | com.google.mediation.bidmachine | 未能加载某个原生广告图片来源。 |
BidMachine Unity 中介插件变更日志
版本 1.0.1
- 初始版本！
- 支持 BidMachine Android 适配器版本 3.5.1.1。
- 支持 BidMAchine iOS 适配器版本 3.5.1.0。
- 使用 Google 移动广告 Unity 插件 10.7.0 版构建并测试。
版本 1.0.0
- 初始版本！
- 支持 BidMachine Android 适配器版本 3.5.1.0。
- 支持 BidMAchine iOS 适配器版本 3.5.1.0。
- 使用 Google 移动广告 Unity 插件 10.6.0 版构建并测试。