本指南介绍了如何使用 Google 移动广告 SDK 通过中介加载和展示 Mintegral 提供的广告，其中涵盖广告瀑布流和出价集成。其中介绍了如何将 Mintegral 添加到广告单元的中介配置中，以及如何将 Mintegral SDK 和适配器集成到 Flutter 应用中。
支持的集成和广告格式
Mintegral 的 AdMob 中介适配器具有以下功能：
| 集成 | ||
|---|---|---|
| 出价 | 1 | |
| 瀑布 | 2 | |
| 表现形式 | ||
| 打开应用 | 1 2 | |
| 横幅 | ||
| 插页式广告 | ||
| 已奖励 | ||
| 插页式激励广告 | ||
| 原生 | 1 3 | |
1 此格式的出价集成功能目前处于封闭式 Beta 版测试阶段。
2 此格式的瀑布流集成目前为封闭式 Beta 版。
3 此格式的瀑布流集成目前为公开 Beta 版。
要求
- 最新版 Google 移动广告 SDK
- Flutter 3.7.0 或更高版本
- 在 Android 上部署
- Android API 级别 21 或更高级别
- 在 iOS 上部署
- iOS 部署目标为 12.0 或更高版本
- 使用 Google 移动广告 SDK 配置的有效 Flutter 项目。如需了解详情，请参阅开始使用。
- 看完中介服务入门指南
第 1 步：在 Mintegral 界面中设置配置
查找应用密钥
前往应用设置标签页，然后记下应用密钥。
添加新应用
在应用设置标签页中，点击添加应用按钮。
选择平台，然后填写表单的其余部分。然后，点击保存。
Android
iOS
记下您应用的应用 ID。
Android
iOS
创建广告展示位置
创建应用后，转到展示位置和单元标签页，然后点击添加展示位置按钮（如下所示），即可创建广告展示位置。
Android
iOS
输入展示位置名称和广告格式。
出价
选择标头出价作为出价类型。填写表单的其余部分，然后点击保存。
瀑布
选择传统作为出价类型。填写表单的其余部分，然后点击保存。
创建广告展示位置后，请记下展示位置 ID。
Android
iOS
点击 1 个广告单元下拉菜单，并记下 AD Unit ID（广告单元 ID）。
Android
iOS
找到您的 Mintegral Reporting API 密钥
出价
出价集成不需要执行此步骤。
瀑布
您需要使用 Mintegral Reporting API 密钥来设置AdMob 广告单元 ID。前往帐号 > API 工具。记下您的 Skey 和 Secret。
第 2 步：在界面中设置 Mintegral 需求 AdMob
为广告单元配置中介设置
将 Mintegral 添加到 GDPR 和美国州级法规广告合作伙伴列表
按照 GDPR 设置 和 美国州级法规设置 中的步骤，将 Mintegral 添加到 AdMob 界面中的 GDPR 和美国州级法规广告合作伙伴列表中。
第 3 步：导入 Mintegral SDK 和适配器
通过 pub.dev 进行集成
在软件包的 pubspec.yaml 文件中，添加以下依赖项以及最新版本的Mintegral SDK 和适配器：
dependencies:
gma_mediation_mintegral: ^1.0.0
手动集成
为 Mintegral 下载最新版本的 Google 移动广告中介插件，提取下载的文件，然后将提取的插件文件夹（及其内容）添加到您的 Flutter 项目中。然后，通过添加以下依赖项，在 pubspec.yaml 文件中引用该插件：
dependencies:
gma_mediation_mintegral:
path: path/to/local/package
第 4 步：添加所需的代码
Android
Mintegral 集成不需要其他代码。
iOS
SKAdNetwork 集成
按照 Mintegral 文档，将 SKAdNetwork 标识符添加到项目的 Info.plist 文件中。
第 5 步：测试实现效果
启用测试广告
请务必为 AdMob。
要获取适用于横幅广告、插页式广告、激励广告和原生广告格式的 Mintegral 测试广告，Mintegral 建议您使用 “Mintegral Test ID”页面。
验证测试广告
如需验证您收到的是来自Mintegral的测试广告，请使用相应广告来源在广告检查器中启用单一广告来源测试。 Mintegral (Bidding) and Mintegral (Waterfall)
错误代码
如果适配器未能接收来自 Mintegral 的广告，发布商可以使用以下类下的 ResponseInfo 检查广告响应中的底层错误：
Android
com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter
iOS
GADMediationAdapterMintegral
当广告加载失败时，Mintegral 适配器会抛出以下代码和随附的消息：
Android
| 错误代码 | 网域 | 原因 |
|---|---|---|
| 101 | com.google.ads.mediation.mintegral | 服务器参数无效（例如，缺少应用 ID 或展示位置 ID）。 |
| 102 | com.google.ads.mediation.mintegral | 请求的广告尺寸与 Mintegral 支持的横幅广告尺寸不匹配。 |
| 103 | com.google.ads.mediation.mintegral | 出价响应缺失或无效。 |
| 104 | com.google.ads.mediation.mintegral | Mintegral SDK 返回了“未填充”错误。 |
iOS
| 错误代码 | 网域 | 原因 |
|---|---|---|
| 101 | com.google.mediation.mintegral | 服务器参数无效（例如，缺少应用 ID 或展示位置 ID）。 |
| 102 | com.google.mediation.mintegral | Mintegral SDK 返回了“未填充”错误。 |
| 103 | com.google.mediation.mintegral | Mintegral SDK 未能展示广告。 |
| 104 | com.google.mediation.mintegral | 请求的广告尺寸与 Mintegral 支持的横幅广告尺寸不匹配。 |
Mintegral Flutter 中介适配器更新日志
1.0.0
- 初始版本。
- 已验证与 Mintegral Android 适配器版本 16.7.21.0 的兼容性。
- 已验证与 Mintegral iOS 适配器版本 7.6.3.0 的兼容性。
- 使用 Google 移动广告 Flutter 插件 5.1.0 版进行构建和测试。