Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

将 i-mobile 与中介集成

请选择平台： Android iOS Unity Flutter Android（旧版）

本指南介绍了如何使用 Google Mobile Ads Unity Plugin 通过中介加载和展示来自 i-mobile 的广告，其中涵盖了瀑布流集成。其中介绍了如何将 i-mobile 添加到广告单元的中介配置，以及如何将 i-mobile SDK 和适配器集成到 Unity 应用中。

i-mobile 的信息中心界面使用日语文本作为标签、按钮和说明。本指南中的屏幕截图未翻译。不过，在本指南的说明和说明中，标签和按钮会翻译成英文，并在括号中注明。

支持的集成和广告格式

i-mobile 的 Ad Manager 中介适配器具有以下功能：

集成
出价
瀑布流
格式
开屏广告
横幅广告
插页式广告
已获得奖励
插页式激励广告
原生

前提条件

在继续操作之前，请验证以下事项：

最新 Google Mobile Ads Unity Plugin 版本。
Unity 编辑器版本 5.6 或更高版本。
如需在 Android 上部署，则要求：
- Android API 级别 24 或更高级别。
如需在 iOS 上部署，则要求：
- iOS 部署目标版本为 13.0 或更高版本。
一个配置了 Google Mobile Ads Unity Plugin 的有效 Unity 项目。如需了解详情，请参阅设置 Google Mobile Ads Unity Plugin。

设置中介。

第 1 步：在 i-mobile 界面中设置配置

注册或登录您的 i-mobile 账号。

点击サイト／アプリ管理（网站/应用管理）标签页和应用平台对应的按钮，将您的应用添加到 i-mobile 信息中心。

Android

iOS

填写表单，然后点击新規登録（注册）按钮。

Android

iOS

如需创建新的广告位，请在サイト／アプリ管理（网站/应用管理）标签页下选择您的应用。

Android

iOS

前往 广告插播位管理 (Ad Spot Management) 标签页，然后点击 新建广告插播位 (New Ad Spot) 按钮。

create_ad_spot

接下来，填写表单，提供広告スポット名（广告插播位名称）、広告スポットサイズ（广告插播位尺寸）和其他详细信息。然后，点击 新規登録（注册）按钮。

new_ad_spot_form

您的新广告插播位已准备就绪。如需查看其集成详细信息，请点击アプリ設定取得 (Get App settings) 按钮。

ad_spot_list

记下パブリッシャー ID（发布商 ID）、メディア ID（媒体 ID）和スポット ID（广告资源 ID）。稍后在 Ad Manager 界面中配置 i-mobile 以进行中介时，您需要用到这些参数。

Android

iOS

更新 app-ads.txt

应用授权卖方 (app-ads.txt) 是一项 IAB Tech Lab 计划，有助于确保只通过您认定的授权渠道销售您的应用广告资源。为避免损失大量广告收入，您需要实施 app-ads.txt 文件。如果您尚未创建 app-ads.txt 文件，请为 Ad Manager 创建一个 app-ads.txt 文件。

如需为 i-mobile 实现 app-ads.txt，请参阅其常见问题解答。

第 2 步：在 Ad Manager 界面中设置 i-mobile 需求

为广告单元配置中介设置

Android

如需查看相关说明，请参阅 Android 指南中的第 2 步。

iOS

如需查看相关说明，请参阅 iOS 指南中的第 2 步。

第 3 步：导入 i-mobile SDK 和适配器

OpenUPM-CLI

如果您已安装 OpenUPM-CLI，则可以运行以下命令，将适用于 Unity 的 Google 移动广告 i-mobile 中介插件安装到您的项目中（从项目的根目录运行）：

openupm add com.google.ads.mobile.mediation.imobile

OpenUPM

在 Unity 项目编辑器中，依次选择 Edit（修改）> Project Settings（项目设置）> Package Manager（资源包管理器），打开 Unity 资源包管理器设置。

在限定范围的注册表标签页下，添加 OpenUPM 作为限定范围的注册表，并提供以下详细信息：

名称：OpenUPM
URL：https://package.openupm.com
范围：com.google

OpenUPM 详情

然后，依次前往 Window > Package Manager，打开 Unity Package Manager，并从下拉菜单中选择 My Registries。

Unity 注册表

选择 Google Mobile Ads IMobile Mediation 软件包，然后点击 Install。

从 OpenUPM 安装

Unity 软件包

从更改日志中的下载链接下载适用于 i-mobile 的最新版 Google 移动广告中介插件，然后从 ZIP 文件中提取 GoogleMobileAdsIMobileMediation.unitypackage。

在 Unity 项目编辑器中，依次选择 Assets > Import Package > Custom Package，然后找到您下载的 GoogleMobileAdsIMobileMediation.unitypackage 文件。确保已选择所有文件，然后点击导入。

从 Unity 导入

然后，依次选择 Assets > External Dependency Manager > Android Resolver > Force Resolve。外部依赖项管理器库将从头开始执行依赖项解析，并将声明的依赖项复制到 Unity 应用的 Assets/Plugins/Android 目录中。

强制解决

第 4 步：其他必需的代码

Android

i-mobile 集成不需要其他代码。

iOS

SKAdNetwork 集成

按照 i-mobile 的文档中的说明，将 SKAdNetwork 标识符添加到项目的 Info.plist 文件中。

第 5 步：测试您的实现

启用测试广告

确保针对 Ad Manager 注册测试设备。 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	在 Ad Manager 界面中配置的 i-mobile 服务器参数缺失或无效。
103	请求的广告尺寸与 i-mobile 支持的横幅广告尺寸不符。
104	i-mobile 的原生广告加载成功回调返回了空的原生广告列表。

iOS

错误代码	原因
0-10	i-mobile SDK 返回了错误。如需了解详情，请参阅代码。
101	在 Ad Manager 界面中配置的 i-mobile 服务器参数缺失或无效。
102	请求的广告尺寸与 i-mobile 支持的横幅广告尺寸不符。
103	i-mobile 未能展示广告。
104	i-mobile 返回了空的原生广告数组。
105	i-mobile 未能下载原生广告素材资源。
106	i-mobile 不支持使用同一广告位 ID 请求多个插页式广告。