将 i-mobile 与中介集成

本指南介绍了如何使用 Google 移动广告 SDK 通过中介功能加载和展示来自 i-mobile 的广告，其中包括广告瀑布流集成。文中介绍了如何将 i-mobile 添加到广告单元的中介配置中，以及如何将 i-mobile SDK 和适配器集成到 Android 应用中。

i-mobile 的信息中心界面使用日语文本作为标签、按钮和说明。本指南中的屏幕截图尚未翻译。不过，在本指南的说明和说明中，标签和按钮在英语中进行了等效翻译（用括号表示）。

支持的集成和广告格式

AdMob i-mobile 中介适配器具有以下功能：

集成
出价
瀑布图
表现形式
横幅
插页式广告
已奖励
原生

要求

  • Android API 级别 19 或更高级别
  • 最新版 Google 移动广告 SDK

第 1 步：设置 i-mobile

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

依次点击 SAıtos/アプבManagement（网站/应用管理）标签页并点击新Android アプכ（新 Android 应用） 按钮，将您的应用添加到 i-mobile 信息中心。

提供应用的名称（名称）和 Κーケト 网址（市场网址），以注册应用。 接着，在填写表单的其余部分后，点击新的规定登上（注册）按钮。

如需创建新的广告位置，请在 SAıtos/アプ Management（网站/应用管理）标签页下选择您的应用。

进入 🇪?🇸? 管理（广告插播位管理）标签页，然后点击新建关联广告支出回报率（新广告插播位）按钮。

创建广告地点

接下来，请填写此表单，填写 🏿?เดลอีname（广告插播位名称）、🇨?安全的 (广告插播位尺寸)和其他详细信息。然后，点击 New 如需详细了解登陆（注册）按钮。

new_ad_spot_form

新的广告插播位已准备就绪。如需查看其集成详情，请点击 アプラーン订购（获取应用设置）按钮。

ad_spot_list

记下 🇨?🇦?🇨?🇦?🇦?ต 为了 ID（发布商 ID）、🇨?ア ID（媒体 ID）和 ID（Spot ID）。您稍后需要在 AdMob 界面中为中介配置 i-mobile 时需要使用这些参数。

第 2 步：为您的广告单元配置 AdMob 中介设置

现在，您需要将 i-mobile 添加到广告单元的中介配置中。为此，请先登录您的 AdMob 帐号。

接下来，请前往中介标签页。如果您有要修改的现有中介组，请点击该中介组的名称进行修改，然后直接跳至将 i-mobile 添加为广告来源。

要创建新的中介组，请选择创建中介组。

AdMob 中介标签页

输入您的广告格式和平台，然后点击继续。

为中介组命名，然后选择要定位到的地理位置。接下来，将中介组状态设置为已启用。然后，点击添加广告单元。

将此中介组与您现有的 AdMob 广告单元相关联。然后，点击完成。

您现在应该可以看到“广告单元”卡片中填充了您选择的广告单元。

将 i-mobile 添加为广告来源

在广告来源卡片中，选择添加广告联盟。

选择 i-mobile 并启用优化功能。输入 i-mobile 帐号的登录名和 API 密码，为 i-mobile 设置广告来源优化。然后，为 i-mobile 输入 eCPM 值，并点击继续。

如果您已经有了 i-mobile 的映射，只需选择它即可。 否则，请点击添加映射。

接下来，输入在上一部分中获得的映射名称、发布商 ID、媒体 ID 和Spot ID。然后，点击完成。

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

在应用级 build.gradle 文件中添加以下实现依赖项，以及最新版本的 i-mobile SDK 和适配器：

repositories {
    google()
    mavenCentral()
    maven {
      url  "https://imobile.github.io/adnw-sdk-android"
    }
}

...
dependencies {
    implementation 'com.google.android.gms:play-services-ads:22.1.0'
    implementation 'com.google.ads.mediation:imobile:2.3.1.1'
}
...

手动集成

  1. 下载最新版本的 i-mobile SDK，提取 sdk 文件夹下的 android-ad-sdk.aar，并将其添加到您的项目。

  2. 导航到 Google 的 Maven 代码库中的 i-mobile 适配器工件。选择最新版本，下载 i-mobile 适配器的 .aar 文件，并将其添加到您的项目。

第 4 步：需要其他代码

i-mobile 集成无需其他代码。

第 5 步：测试您的实现效果

为了测试您的集成，i-mobile 针对所有广告格式提供了测试电视广告 ID、媒体 ID 和发布商 ID。您可以在此处找到它们。

可选步骤

使用原生广告

广告呈现

i-mobile 适配器会为 NativeAd 填充以下 原生广告高级字段说明 。

字段 始终由 i-mobile 适配器包含的素材资源
标题
图片
正文
应用图标 1
号召性用语
星级
商店
价格

1对于原生广告，i-mobile SDK 不提供应用图标素材资源。相反，i-mobile 适配器会使用透明图片填充应用图标。

错误代码

如果适配器无法从 i-mobile 接收广告，发布商可以使用以下类下的 ResponseInfo.getAdapterResponse() 从广告响应中检查底层错误：

形式 类名称
横幅 com.google.ads.Mediation.imobile.IMobileAdapter
插页式广告 com.google.ads.Mediation.imobile.IMobileAdapter
原生 com.google.ads.Mediation.imobile.IMobileMediationAdapter

如果广告加载失败，则 i-mobile 适配器会抛出以下代码和随附的消息：

错误代码 原因
0-99 i-mobile SDK 返回错误。如需了解详情，请参阅代码。
101 i-mobile 需要 Activity 上下文才能加载广告。
102 AdMob 界面中配置的 i-mobile 服务器参数缺失/无效。
103 请求的广告尺寸与支持移动设备的横幅广告尺寸不符。
104 i-mobile 的原生广告加载成功回调返回了一个空的原生广告列表。
0-10 i-mobile SDK 返回错误。如需了解详情，请参阅代码。
101 AdMob 界面中配置的 i-mobile 服务器参数缺失/无效。
102 请求的广告尺寸与支持移动设备的横幅广告尺寸不符。
103 i-mobile 未能展示广告。
104 i-mobile 返回空的原生广告数组。
105 i-mobile 未能下载原生广告素材资源。
106 i-mobile 不支持请求使用同一 Spot ID 的多个插页式广告。

i-mobile Android 中介适配器更新日志

版本 2.3.1.1

  • 将适配器更新为使用新的 VersionInfo 类。
  • 将要求的最低 Google 移动广告 SDK 版本更新为 22.0.0。

构建和测试所需版本：

  • Google 移动广告 SDK 22.0.0 版。
  • IMobile SDK 版本 2.3.1。

版本 2.3.1.0

  • 经验证可与 i-mobile SDK v2.3.1 兼容。
  • 将要求的最低 Google 移动广告 SDK 版本更新为 21.5.0。

构建和测试所需版本：

  • Google 移动广告 SDK 21.5.0 版。
  • IMobile SDK 版本 2.3.1。

版本 2.3.0.0

  • 经验证可与 i-mobile SDK v2.3.0 兼容。
  • 要求的最低 Google 移动广告 SDK 版本已更新至 21.3.0。

构建和测试所需版本：

  • Google 移动广告 SDK 21.3.0 版。
  • IMobile SDK 版本 2.3.0。

版本 2.0.23.1

  • 将 compileSdkVersion 和 targetSdkVersion 更新为 API 31。
  • 将要求的最低 Google 移动广告 SDK 版本更新为 21.0.0。
  • 将最低的 Android API 级别更新为 19。

构建和测试所需版本：

  • Google 移动广告 SDK 21.0.0 版。
  • IMobile SDK 版本 2.0.23。

版本 2.0.23.0

  • 经验证可与 i-mobile SDK v2.0.23 兼容。
  • 将要求的最低 Google 移动广告 SDK 版本更新为 20.5.0。

构建和测试所需版本

  • Google 移动广告 SDK 20.5.0 版。
  • IMobile SDK 版本 2.0.23。

版本 2.0.22.2

  • 添加了标准化的适配器错误代码和消息。
  • 要求的最低 Google 移动广告 SDK 版本已更新至 20.1.0。

构建和测试所需版本

  • Google 移动广告 SDK 20.1.0 版。
  • IMobile SDK 版本 2.0.22。

版本 2.0.22.1

  • 将要求的最低 Google 移动广告 SDK 版本更新为 20.0.0。

构建和测试所需版本

  • Google 移动广告 SDK 20.0.0 版。
  • IMobile SDK 版本 2.0.22。

版本 2.0.22.0

  • 经验证可与 i-mobile SDK v2.0.22 兼容。
  • 更新了适配器，以支持内嵌自适应横幅广告请求。

构建和测试所需版本

  • Google 移动广告 SDK 19.1.0.
  • IMobile SDK 版本 2.0.22。

版本 2.0.21.0

  • 经验证可与 i-mobile SDK v2.0.21 兼容。
  • 将要求的最低 Google 移动广告 SDK 版本更新为 19.1.0。
  • 新增了对扩展自适应横幅广告的支持。

构建和测试所需版本

  • Google 移动广告 SDK 19.1.0.
  • IMobile SDK 版本 2.0.21。

版本 2.0.20.2

  • 新增了对灵活横幅广告尺寸的支持。
  • 将要求的最低 Google 移动广告 SDK 版本更新为 18.3.0。

构建和测试所需版本

  • Google 移动广告 SDK 18.3.0 版。
  • IMobile SDK 版本 2.0.20。

版本 2.0.20.1

  • 适配器现在会返回非零 mediaContent 宽高比。

构建和测试所需版本

  • Google 移动广告 SDK 18.2.0 版。
  • IMobile SDK 版本 2.0.20。

版本 2.0.20.0

  • 初始版本！
  • 新增了对横幅广告、插页式广告和原生广告的支持。