本指南介绍了如何使用 Google Mobile Ads Unity Plugin 通过 AdMob 中介加载和展示 来自 BidMachine 的 广告（内容涵盖出价集成）。如何将 BidMachine 添加到广告单元的中介配置，以及如何将 BidMachine SDK 和适配器集成到 Unity 应用中。
支持的集成和广告格式
BidMachine 的 AdMob 中介适配器具有以下功能：
| 集成 | |
|---|---|
| 出价 | |
| 瀑布 | 1 |
| 表现形式 | |
| 开屏广告 | |
| 横幅广告 | |
| 插页式广告 | |
| 激励广告 | |
| 插页式激励广告 | |
1 瀑布集成处于 封闭式 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 文件，请立即设置。
set up an app-ads.txt file for your app.
如需为 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 中介插件 for Unity 安装到您的项目中：
openupm add com.google.ads.mobile.mediation.bidmachineOpenUPM
在 Unity 项目编辑器中，依次选择 Edit （修改）> Project Settings （项目设置）> Package Manager （软件包管理器），打开 Unity 软件包管理器设置。
在 Scoped Registries （限定范围的注册表）标签页下，将 OpenUPM 添加为限定范围的注册表，并提供以下详细信息：
- 名称：
OpenUPM - 网址：
https://package.openupm.com - 范围：
com.google
然后，依次选择 Window （窗口）> Package Manager （软件包管理器），打开 Unity Package Manager （Unity 软件包管理器），并从下拉菜单中选择 My Registries （我的注册表）。
选择 Google Mobile Ads BidMachine Mediation （Google 移动广告 BidMachine 中介）软件包，然后点击 Install （安装）。
Unity 软件包
在 Unity 项目编辑器中，依次选择 Assets （资源）> Import Package （导入软件包）> Custom
Package （自定义软件包），然后找到您下载的 GoogleMobileAdsBidMachineMediation.unitypackage
文件。确保选择所有文件，然后点击 Import （导入）。
然后，依次选择 Assets （资源）> External Dependency Manager （外部依赖项管理器）> Android
Resolver （Android 解析器）> Force Resolve （强制解析）。外部依赖项管理器库将从头开始执行依赖项解析，并将声明的依赖项复制到
Unity 应用的 Assets/Plugins/Android 目录中。
第 4 步：在 BidMachine SDK 上实现隐私设置
欧盟地区意见征求和《一般数据保护条例》(GDPR)
为了遵守 Google 的《欧盟地区用户意见征求政策》，您必须：向位于欧洲经济区 (EEA)、英国和瑞士境内的 用户披露相关信息；如果法律要求在使用 Cookie 或存储在本地的其他 ID 之前必须先征得用户同意，您必须照做；如果需要收集、分享和使用个人数据来实现广告 个性化，也必须征得用户同意。此政策反映了欧盟《电子隐私指令》和《一般数据保护条例》(GDPR) 的要求。您要负责验证用户意见是否已传播到中介链中的每个广告来源。 Google 无法自动将用户意见传递给此类广告资源网。
BidMachine 会自动读取意见征求管理平台（包括 UMP SDK）设置的 GDPR 意见征求。如需了解详情，请参阅 BidMachine 针对 Android 和 iOS 提供的 GDPR 指南。
美国州级隐私保护法律
美国各州隐私保护法律要求向用户提供选择拒绝“出售”其“个人信息”（该法律中对这些术语做出了定义）的权利，“出售”方须在首页醒目位置提供“Do Not Sell My Personal Information”（不出售我的个人信息）链接，以供这些用户选择。美国州级隐私保护法律合规性指南可让您为 Google 广告投放启用受限的数据处理，但 Google 无法将此设置应用于您的中介链中的每个广告联盟。因此，您必须确定中介链中可能参与个人信息出售的每个广告联盟，并遵循这些广告联盟的指南来确保合规性。
BidMachine 会自动读取意见征求管理平台（包括 UMP SDK）设置的 GPP 意见。如需了解详情，请参阅 BidMachine 针对 Android 和 iOS 提供的 GPP 指南。
第 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 返回了 onAdLoaded() 回调，其中包含 null 广告数据。 |
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.3.0
- 支持 BidMachine Android 适配器版本 3.7.0.0。
- 支持 BidMachine iOS 适配器版本 3.6.1.1。
- 使用 Google 移动广告 Unity 插件版本 11.1.0 构建和测试。
版本 1.2.1
- 支持 BidMachine Android 适配器版本 3.6.1.0。
- 支持 BidMachine iOS 适配器版本 3.6.1.0。
- 使用 Google 移动广告 Unity 插件版本 11.0.0 构建和测试。
版本 1.2.0
- 支持 BidMachine Android 适配器版本 3.6.1.0。
- 支持 BidMachine iOS 适配器版本 3.6.0.0。
- 使用 Google 移动广告 Unity 插件版本 11.0.0 构建和测试。
版本 1.1.0
- 支持 BidMachine Android 适配器版本 3.5.1.2。
- 支持 BidMachine iOS 适配器版本 3.6.0.0。
- 使用 Google 移动广告 Unity 插件版本 11.0.0 构建和测试。
版本 1.0.2
- 支持 BidMachine Android 适配器版本 3.5.1.2。
- 支持 BidMachine iOS 适配器版本 3.5.1.2。
- 使用 Google 移动广告 Unity 插件版本 11.0.0 构建和测试。
版本 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 构建和测试。