本指南介绍了如何使用 Google 移动广告 SDK 通过中介加载和展示来自 Moloco 的广告(内容涵盖出价集成)。如何将 Moloco 添加到广告单元的中介配置,以及如何将 Moloco SDK 和适配器集成到 Flutter 应用中。
支持的集成和广告格式
Moloco 的 AdMob 中介适配器具有以下功能:
集成 | |
---|---|
出价 | |
瀑布流 | |
格式 | |
开屏广告 | |
横幅广告 | |
插页式广告 | |
激励广告 | |
插页式激励广告 | |
原生广告 |
要求
- 最新版 Google 移动广告 SDK
- Flutter 3.7.0 或更高版本
- 如需在 Android 上部署,则要求:
- Android API 级别 23 或更高级别
- 如需在 iOS 上部署,则要求:
- iOS 部署目标版本为 12.0 或更高版本
- 已配置 Google 移动广告 SDK 的 Flutter 项目,该项目应正常运行。如需了解详情,请参阅使用入门。
- 完成中介入门指南阅读。
第 1 步:在 Moloco 界面中设置配置
登录 Moloco 发布商门户。
依次前往概览 > 应用标签页,然后点击添加应用按钮以创建新应用。

为您的应用选择操作系统和隐私设置,填写表单的其余部分,然后点击 Create(创建)。
Android

iOS

创建应用后,从 Apps(应用)标签页中选择该应用,以便查看详细信息并记下应用密钥。
Android

iOS

依次前往概览 > 广告单元标签页,从下拉菜单中选择应用,然后点击新建广告单元。

为 Auction method(竞价方式)选择 In-app bidding(应用内出价),并填写表单的其余部分。然后,点击创建。

前往 Ad Units(广告单元)标签页,找到新创建的广告单元,以便查看其详细信息。记下广告单元 ID。

第 2 步:在 AdMob 界面中设置 Moloco 需求
为广告单元配置中介设置
将 Moloco Ads 添加到 GDPR 和美国州级法规广告合作伙伴名单中
请按照欧洲法规设置和美国州级法规设置中的步骤,将 Moloco Ads 添加到 AdMob 界面内的欧洲法规和美国州级法规广告合作伙伴名单中。
第 3 步:导入 Moloco SDK 和适配器
通过 pub.dev 进行集成
在软件包的 pubspec.yaml
文件中添加以下依赖项,并确保使用的是 Moloco Ads SDK 和适配器的最新版本:
dependencies:
gma_mediation_moloco: ^
手动集成
下载适用于 Moloco 广告 SDK 的最新版 Google 移动广告中介插件,提取下载的文件,并将提取的插件文件夹(及其内容)添加到您的 Flutter 项目中。然后,通过添加以下依赖项,在 pubspec.yaml
文件中引用该插件:
dependencies:
gma_mediation_moloco:
path: path/to/local/package
第 4 步:添加必需的代码
Moloco 集成不需要其他代码。
第 5 步:测试您的实现
启用测试广告
确保针对 AdMob 注册测试设备。
验证测试广告
若要验证您是否能收到来自 Moloco Ads SDK 的测试广告,请在广告检查器中启用 single ad source testing(单个广告来源测试),并选择 Moloco (Bidding)(Moloco [出价])作为广告来源。
错误代码
如果适配器未能收到来自 Moloco 的广告,发布商可以使用 ResponseInfo
来检查广告响应中归属于以下类的底层错误:
Android
com.moloco.sdk
com.google.ads.mediation.moloco.MolocoMediationAdapter
iOS
MolocoSDK.MolocoError
GADMediationAdapterMoloco
以下是当广告加载失败时,Moloco 适配器会抛出的代码和随附的消息:
Android
错误代码 | 网域 | 原因 |
---|---|---|
101 | com.google.ads.mediation.moloco | Moloco 应用密钥缺失或无效。 |
102 | com.google.ads.mediation.moloco | Moloco 广告单元 ID 缺失或无效。 |
103 | com.google.ads.mediation.moloco | 返回的 Moloco 广告对象为 null。 |
-1 至 5000 | com.moloco.sdk | Moloco SDK 返回了错误。如需了解详情,请参阅 Moloco 的文档。 |
iOS
错误代码 | 网域 | 原因 |
---|---|---|
101 | com.google.ads.mediation.moloco | Moloco SDK 不支持在 iOS 12 及更低版本上投放广告。 |
102 | com.google.ads.mediation.moloco | Moloco 应用密钥缺失或无效。 |
103 | com.google.ads.mediation.moloco | Moloco 广告单元 ID 缺失或无效。 |
104 | com.google.ads.mediation.moloco | 广告尚无法展示。 |
105 | com.google.ads.mediation.moloco | 广告未能展示。 |
106 | com.google.ads.mediation.moloco | 呈现数据不可用,无法呈现广告。 |
-1 至 5000 | 由 Moloco SDK 发送 | Moloco SDK 返回了错误。如需了解详情,请参阅 Moloco 的文档。 |
激励广告服务器端验证
如果您验证服务器端验证 (SSV) 回调,则 Moloco 的广告来源标识符为 8267622065755668722
。
Moloco Flutter 中介适配器变更日志
版本 1.6.1(正在开发中)
版本 1.6.0(正在开发中)
版本 1.5.0
- 支持 Moloco Android 适配器版本 3.11.0.0。
- 支持 Moloco iOS 适配器版本 3.11.0.0。
- 使用 Google 移动广告 Flutter 插件 6.0.0 版构建和测试。
版本 1.4.0
- 支持 Moloco Android 适配器版本 3.10.0.0。
- 支持 Moloco iOS 适配器版本 3.10.0.0。
- 使用 Google 移动广告 Flutter 插件 6.0.0 版构建和测试。
版本 1.3.1
- 支持 Moloco Android 适配器版本 3.9.0.0。
- 支持 Moloco iOS 适配器版本 3.9.1.0。
- 使用 Google 移动广告 Flutter 插件 6.0.0 版构建和测试。
版本 1.3.0
- 支持 Moloco Android 适配器版本 3.9.0.0。
- 支持 Moloco iOS 适配器版本 3.9.0.0。
- 使用 Google 移动广告 Flutter 插件 6.0.0 版构建和测试。
版本 1.2.0
- 支持 Moloco Android 适配器版本 3.8.0.1。
- 支持 Moloco iOS 适配器版本 3.8.0.0。
- 使用 Google 移动广告 Flutter 插件 6.0.0 版构建和测试。
版本 1.1.0
- 支持 Moloco Android 适配器 3.7.0.0 版。
- 支持 Moloco iOS 适配器版本 3.6.0.0。
- 使用 Google 移动广告 Flutter 插件 5.3.1 版构建并测试。
版本 1.0.0
- 初始版本。
- 支持 Moloco Android 适配器 3.6.1.0 版。
- 支持 Moloco iOS 适配器版本 3.6.0.0。
- 使用 Google 移动广告 Flutter 插件 5.3.1 版构建并测试。