本指南介绍了如何使用 Google 移动广告 SDK 通过中介加载和展示来自 maio 的广告,其中涵盖了瀑布流集成。本文介绍了如何将 maio 添加到广告单元的中介配置中,以及如何将 maio SDK 和适配器集成到 Flutter 应用中。
maio 的信息中心界面使用日文文本作为标签、按钮和说明,本指南中的屏幕截图尚未翻译。 不过,在本文的说明和操作指南中,标签和按钮均以其英文等效名称表示。例如,“网址 スキーム”就是“网址 方案”。
支持的集成和广告格式
maio 的中介适配器具有以下功能:
集成 | |
---|---|
出价 | |
瀑布 | |
表现形式 | |
横幅 | |
插页式广告 | |
激励广告 | |
原生 |
要求
- 最新的 Google 移动广告 SDK
- Flutter 3.7.0 或更高版本
- 如需在 Android 上部署,请执行以下操作
- Android API 级别 23 或更高级别
- 如需在 iOS 上部署,请执行以下操作
- iOS 部署目标版本为 12.0 或更高版本
- 已配置 Google 移动广告 SDK 的正常运行的 Flutter 项目。 如需了解详情,请参阅使用入门。
- 完成中介入门指南
第 1 步:在 maio 界面中设置配置
首先,注册或登录您的 maio 账号。点击左侧边栏中的应用管理按钮,然后点击新应用。
选择与您偏好的广告类型对应的标签页。
插页式广告
输入应用的名称,选择平台,然后提供应用网址。选择视频插页式广告作为广告类型,然后点击更新。
Android
iOS
激励广告
输入应用的名称,选择平台,然后提供应用网址。选择视频奖励广告作为广告类型,然后点击更新。
Android
iOS
在应用管理页面中,记下媒体 ID。您需要在下一部分中设置 AdMob 广告单元。
Android
iOS
在地区管理页面中,记下地区 ID。您还需要使用它在下一部分中设置 AdMob 广告单元。
Android
iOS
第 2 步:在 AdMob 界面中设置 maio 需求
为广告单元配置中介设置
第 3 步:导入 maio SDK 和适配器
通过 pub.dev 进行集成
在软件包的 pubspec.yaml
文件中添加以下依赖项,其中包含最新版本的 maio SDK 和适配器:
dependencies:
gma_mediation_maio: ^
手动集成
下载最新版 Google 移动广告中介插件(适用于 maio),解压缩下载的文件,然后将解压缩的插件文件夹(及其内容)添加到您的 Flutter 项目中。然后,通过添加以下依赖项,在 pubspec.yaml
文件中引用该插件:
dependencies:
gma_mediation_maio:
path: path/to/local/package
第 4 步:添加必需的代码
Android
无需为 maio 集成添加其他代码。
iOS
SKAdNetwork 集成
按照 maio 的文档将 SKAdNetwork 标识符添加到项目的 Info.plist
文件中。
第 5 步:测试您的实现
启用测试广告
请务必为 AdMob 注册测试设备。
如果发布商使用的是 Google 移动广告 SDK 7.26.0 版或更高版本,则在发出请求时,系统会自动在注册为测试设备的手机和平板电脑上接收来自 maio 的测试广告。
验证测试广告
如需验证您是否从 maio 收到测试广告,请使用 maio(瀑布流)广告来源在广告检查器中启用单一广告来源测试。
错误代码
如果适配器未能从 maio 接收到广告,发布商可以使用以下类中的 ResponseInfo
检查广告响应中的底层错误:
Android
格式 | 类名称 |
---|---|
插页式广告 | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
激励广告 | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
iOS
格式 | 类名称 |
---|---|
插页式广告 | GADMMaioInterstitialAdapter |
激励广告 | GADMMaioRewardedAdapter |
以下是当广告加载失败时,Maio 适配器抛出的代码和随附的消息:
Android
错误代码 | 原因 |
---|---|
0-10 | maio 返回了特定于 SDK 的错误。如需了解详情,请参阅代码和 maio 的文档。 |
101 | Maio 没有可投放的广告。 |
102 | 服务器参数无效(例如,缺少展示位置 ID)。 |
103 | 用于加载广告的上下文不是 `Activity` 实例。 |
iOS
错误代码 | 原因 |
---|---|
0-10 | maio 返回了特定于 SDK 的错误。如需了解详情,请参阅 maio 的代码。 |
101 | maio 目前还没有可投放的广告。 |
102 | 服务器参数无效(例如,缺少展示位置 ID)。 |
103 | maio 适配器不支持所请求的广告格式。 |
104 | 此网络配置已加载广告。 |
maio Flutter 中介适配器变更日志
版本 1.0.3(正在进行)
版本 1.0.2
- 支持 maio Android 适配器版本 2.0.4.0。
- 支持 maio iOS 适配器版本 2.1.6.1。
- 使用 Google 移动广告 Flutter 插件 6.0.0 版构建和测试。
版本 1.0.1
- 支持 maio Android 适配器版本 2.0.3.1。
- 支持 maio iOS 适配器版本 2.1.6.1。
- 使用 Google 移动广告 Flutter 插件 6.0.0 版构建和测试。
版本 1.0.0
- 初始版本。
- 支持 maio Android 适配器版本 2.0.3.0。
- 支持 maio iOS 适配器版本 2.1.6.0。
- 使用 Google 移动广告 Flutter 插件 5.3.1 版构建和测试。