本指南介绍了如何使用 Google Mobile Ads SDK for React Native 通过中介加载和展示来自 i-mobile 的广告，其中涵盖了瀑布流集成。其中介绍了如何将 i-mobile 添加到广告单元的中介配置，以及如何将 i-mobile SDK 和适配器集成到 React Native 原生应用中。
i-mobile 的信息中心界面使用日语文本作为标签、按钮和说明。本指南中的屏幕截图未翻译。不过，在本指南的说明和说明中，标签和按钮会翻译成英文，并在括号中注明。
支持的集成和广告格式
i-mobile 的 AdMob 中介适配器具有以下功能：
| 集成 | |
|---|---|
| 出价 | |
| 瀑布流 | |
| 格式 | |
| 开屏广告 | |
| 横幅广告 | |
| 插页式广告 | |
| 已获得奖励 | |
| 插页式激励广告 | |
| 原生 | |
前提条件
在继续操作之前，请验证以下事项：
- 最新 Google Mobile Ads SDK for React Native 版本。
- React Native 框架 0.85.0 版或更高版本。
- 如需在 Android 上部署，则要求：
- Android API 级别 24 或更高级别。
- 如需在 iOS 上部署，则要求：
- iOS 部署目标版本为 13.0 或更高版本。
- 已配置 Google Mobile Ads SDK for React Native 的 React Native 项目，该项目应正常运行。如需了解详情，请参阅设置 Google Mobile Ads SDK for React Native。
- 确保您已从
gma-sdk-react-native文件夹中下载并解压缩adapters文件夹。如果您没有adapters文件夹，请按照安装 Google Mobile Ads SDK for React Native 中的第 1、2 和 3 步操作。
- 确保您已从
- 设置 AdMob 中介。
第 1 步：在 i-mobile 界面中设置配置
点击サイト／アプリ管理（网站/应用管理）标签页和应用平台对应的按钮，将您的应用添加到 i-mobile 信息中心。
Android
iOS
填写表单，然后点击新規登録（注册）按钮。
Android
iOS
如需创建新的广告位，请在サイト／アプリ管理（网站/应用管理）标签页下选择您的应用。
Android
iOS
前往 广告插播位管理 (Ad Spot Management) 标签页，然后点击 新建广告插播位 (New Ad Spot) 按钮。
接下来，填写表单，提供広告スポット名（广告插播位名称）、広告スポットサイズ（广告插播位尺寸）和其他详细信息。然后，点击新規登録（注册）按钮。
您的新广告插播位已准备就绪。如需查看其集成详情，请点击アプリ設定取得（获取应用设置）按钮。
记下パブリッシャー ID（发布商 ID）、メディア ID（媒体 ID）和スポット ID（广告位 ID）。稍后在 AdMob 界面中配置 i-mobile 以进行中介时，您需要用到这些参数。
Android
iOS
更新 app-ads.txt
应用授权卖方 (app-ads.txt) 是一项 IAB Tech Lab 计划，有助于确保只通过您认定的授权渠道销售您的应用广告资源。为避免损失大量广告收入，您需要实施 app-ads.txt 文件。
如果您尚未为您的应用设置 app-ads.txt 文件，请先进行设置。
如需为 i-mobile 实现 app-ads.txt，请参阅其常见问题解答。
第 2 步：在 AdMob 界面中设置 i-mobile 需求
为广告单元配置中介设置
第 3 步：导入 i-mobile SDK 和适配器
在项目的根目录中，安装适用于 i-mobile 的 Google Mobile Ads SDK for React Native 中介适配器。请完成以下操作：
将 Google Mobile Ads SDK for React Native 适配器 tar 文件从
gma-sdk-react-native/adapters/imobile/目录复制到项目的local_packages/目录中。如果您没有adapters文件夹，请参阅前提条件。mkdir -p local_packages cp EXTRACT_DIR/gma-sdk-react-native/adapters/imobile/gma-mediation-imobile-0.1.0.tgz local_packages/将 EXTRACT_DIR 替换为解压缩归档文件的目录的路径。
使用您首选的软件包管理器安装适配器软件包：
npm
npm install ./local_packages/gma-mediation-imobile-0.1.0.tgz纱线
yarn add ./local_packages/gma-mediation-imobile-0.1.0.tgz如果您要针对 Android 进行构建，请将以下代码库添加到项目
android目录中的build.gradle文件：repositories { google() mavenCentral() maven { url = uri("https://imobile.github.io/adnw-sdk-android") } }
第 4 步：其他必需的代码
Android
i-mobile 集成不需要其他代码。
iOS
SKAdNetwork 集成
按照 i-mobile 的文档中的说明，将 SKAdNetwork 标识符添加到项目的 Info.plist 文件中。
第 5 步：测试您的实现
启用测试广告
确保针对 AdMob 注册测试设备。 i-mobile 提供了测试用广告位 ID、媒体 ID 和发布商 ID，您可以在此处找到这些 ID。
验证测试广告
若要验证您是否能收到来自 i-mobile 的测试广告，请在广告检查器中启用单个广告来源测试，并选择 i-mobile（瀑布流）作为广告来源。
错误代码
如果适配器未能收到来自 i-mobile 的广告，发布商可以使用 ResponseInfo 来检查广告响应中归属于以下类的底层错误：
Android
| 格式 | 类名称 |
|---|---|
| 横幅 | com.google.ads.mediation.imobile.IMobileAdapter |
| 插页式广告 | com.google.ads.mediation.imobile.IMobileAdapter |
| 原生 | com.google.ads.mediation.imobile.IMobileMediationAdapter |
iOS
| 格式 | 类名称 |
|---|---|
| 横幅 | IMobileAdapter |
| 插页式广告 | IMobileAdapter |
| 原生 | GADMediationAdapterIMobile |
以下是当广告加载失败时，i-mobile 适配器会抛出的代码和随附的消息：
Android
| 错误代码 | 原因 |
|---|---|
| 0-99 | i-mobile SDK 返回了错误。如需了解详情，请参阅代码。 |
| 101 | i-mobile 需要 Activity 上下文才能加载广告。 |
| 102 | 在 AdMob 界面中配置的 i-mobile 服务器参数缺失或无效。 |
| 103 | 请求的广告尺寸与 i-mobile 支持的横幅广告尺寸不符。 |
| 104 | i-mobile 的原生广告加载成功回调返回了空的原生广告列表。 |
iOS
| 错误代码 | 原因 |
|---|---|
| 0-10 | i-mobile SDK 返回了错误。如需了解详情，请参阅代码。 |
| 101 | 在 AdMob 界面中配置的 i-mobile 服务器参数缺失或无效。 |
| 102 | 请求的广告尺寸与 i-mobile 支持的横幅广告尺寸不符。 |
| 103 | i-mobile 未能展示广告。 |
| 104 | i-mobile 返回了空的原生广告数组。 |
| 105 | i-mobile 未能下载原生广告素材资源。 |
| 106 | i-mobile 不支持使用同一广告位 ID 请求多个插页式广告。 |
版本 0.1.0
- 初始版本。