将 i-mobile 与中介集成

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

i-mobile 的控制台界面使用日语文本作为标签、按钮和说明。本指南中的屏幕截图未经翻译。不过，本指南的说明和说明中，标签和按钮均已翻译，并在括号中注明了英语对等字词。

支持的集成和广告格式

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

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

要求

  • Android API 级别 21 或更高级别

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

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

点击 サイト／アプリ管理 (Site/Application Management) 标签页和应用所属平台对应的按钮，将您的应用添加到 i-mobile 信息中心。

填写表单，然后点击 新規登録 (Sign up) 按钮。

如需创建新的广告展示位置，请在 サイト／アプリ管理 (Site/Application Management) 标签页下选择您的应用。

前往 広告スポット管理 (Ad Spot Management) 标签页，然后点击 新規広告スポット (New Ad Spot) 按钮。

create_ad_spot

接下来，填写表单，提供広告スポット名 (Ad Spot name)、広告スポットサイズ (Ad Spot size) 和其他详细信息。然后，点击 新規登録 (Sign up) 按钮。

new_ad_spot_form

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

ad_spot_list

记下 パブリッシャー ID (Publisher ID)、メディア ID (Media ID) 和 スポット ID (Spot ID)。稍后，当您在 Ad Manager 界面中将 i-mobile 配置为中介时，需要使用这些参数。

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

为广告单元配置中介设置

登录您的 Ad Manager 账号。

依次前往投放 > 收益组，然后点击新建收益组按钮。

为收益组输入唯一的名称，将状态设为有效，选择广告格式，并将广告资源类型设为移动应用。在定位 > 广告资源部分下，选择您要为其添加中介的广告资源和移动应用下的广告单元。

接下来，点击添加收益合作伙伴按钮。

如果您已经有 i-mobile 的收益合作伙伴，可以选择该合作伙伴。否则，请选择创建新的收益合作伙伴。

选择 i-mobile 作为广告联盟，输入唯一的名称，然后启用中介。

启用自动数据收集，然后输入登录名称和 API 密码

选择收益合作伙伴后，选择移动 SDK 中介作为集成类型，选择 Android 作为平台，并选择有效作为状态。输入您在上一部分中获取的发布商 ID、媒体 ID 和广告插播 ID。然后，输入默认每千次展示定价值。

完成后，点击页面底部的保存。

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

在项目级 settings.gradle.kts 文件中，添加以下代码库：

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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.0")
}

手动集成

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

  2. 前往 Google 的 Maven 制品库，找到 i-mobile 适配器工件。选择最新版本，下载 i-mobile 适配器的 .aar 文件，然后将其添加到您的项目中。

第 4 步：添加所需代码

无需额外代码即可实现 i-mobile 集成。

第 5 步：测试您的实现

启用测试广告

请务必为 Ad Manager 注册测试设备。 i-mobile 提供测试广告展示位置 ID、媒体 ID 和发布商 ID，您可以在此处找到它们。

验证测试广告

如需验证您是否在接收来自 i-mobile 的测试广告，请在广告检查器中使用 i-mobile（广告瀑布流）广告来源启用单一广告来源测试。

可选步骤

使用原生广告

广告呈现

i-mobile 适配器会为 NativeAd 填充以下字段。

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

1 对于原生广告，i-mobile SDK 不提供应用图标素材资源。而是使用透明图片填充应用图标。

错误代码

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

格式 类名称
横幅 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 Ad Manager 界面中配置的 i-mobile 服务器参数缺失/无效。
103 请求的广告尺寸与 i-mobile 支持的横幅广告尺寸不符。
104 i-mobile 的原生广告加载成功回调返回了空的原生广告列表。

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

版本 2.3.2.0

  • 已验证与 i-mobile SDK v2.3.2 的兼容性。

构建和测试所需版本：

  • Google 移动广告 SDK 23.1.0 版。
  • IMobile SDK 版本 2.3.2。

版本 2.3.1.2

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

构建和测试所需版本：

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

版本 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

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