本指南介绍了如何使用 Google Mobile Ads Flutter Plugin 通过 AdMob 中介加载和展示来自 BidMachine 的展示广告（内容涵盖出价集成）。本指南还介绍了如何将 BidMachine 添加到广告单元的中介配置中，以及如何将 BidMachine SDK 和适配器集成到 Flutter 应用中。
支持的集成和广告格式
BidMachine 的 AdMob 中介适配器具有以下功能：
| 集成 | |
|---|---|
| 出价 | 1 |
| 瀑布 | |
| 格式 | |
| 开屏广告 | |
| 横幅广告 | |
| 插页式广告 | |
| 激励广告 | |
| 插页式激励广告 | |
| 原生 | 2 |
1 出价集成功能目前处于封闭式 Beta 版阶段，请与您的客户经理联系以申请访问权限。
2 原生广告格式处于 Alpha 阶段。所有其他受支持的广告格式均处于 Beta 版阶段。请与您的客户经理联系，申请访问权限。
要求
- “Google Mobile Ads Flutter Plugin”的最新视频
- Flutter 3.7.0 或更高版本
- 如需在 Android 上部署，则要求：
- Android API 级别 23 或更高级别
- 如需在 iOS 上部署，则要求：
- iOS 部署目标版本为 13.0 或更高版本
- 已配置 Google Mobile Ads Flutter Plugin 的正常运行的 Flutter 项目。如需了解详情，请参阅使用入门。
- 完成中介入门指南阅读。
第 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 和适配器
通过 pub.dev 进行集成
在软件包的 pubspec.yaml 文件中添加以下依赖项，并确保使用的是 BidMachine SDK 和适配器的最新版本：
dependencies:
gma_mediation_bidmachine: ^1.3.0
手动集成
下载适用于 BidMachine 的最新版 Google 移动广告中介插件，提取下载的文件，并将提取的插件文件夹（及其内容）添加到您的 Flutter 项目中。然后，通过添加以下依赖项，在 pubspec.yaml 文件中引用该插件：
dependencies:
gma_mediation_bidmachine:
path: path/to/local/package
第 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 Flutter 中介适配器变更日志
版本 1.3.1（正在开发中）
版本 1.3.0
- 支持 BidMachine Android 适配器版本 3.5.0.0。
- 支持 BidMachine iOS 适配器版本 3.5.0.0。
- 使用 Google 移动广告 Flutter 插件 6.0.0 版构建和测试。
版本 1.2.0
- 支持 BidMachine Android 适配器版本 3.5.0.0。
- 支持 BidMachine iOS 适配器版本 3.4.0.2。
- 使用 Google 移动广告 Flutter 插件 6.0.0 版构建和测试。
版本 1.1.0
- 支持 BidMachine Android 适配器版本 3.4.0.0。
- 支持 BidMachine iOS 适配器版本 3.4.0.1。
- 使用 Google 移动广告 Flutter 插件 6.0.0 版构建和测试。
版本 1.0.0
- 初始版本。
- 支持 BidMachine Android 适配器版本 3.3.0.0。
- 支持 BidMachine iOS 适配器版本 3.4.0.0。
- 使用 Google 移动广告 Flutter 插件 6.0.0 版构建和测试。