미디에이션과 i-mobile 통합

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

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

支持的集成和广告格式

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

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

要求

  • Android API 级别 21 或更高级别

  • 最新版 Google 移动广告 SDK

  • 完成中介流程 入门指南

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

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

광고 단위에 대한 미디에이션 설정 구성

i-mobile 를 광고 단위의 미디에이션 구성에 추가해야 합니다.

먼저 AdMob 계정에 로그인합니다. 그런 다음 미디에이션 탭으로 이동합니다. 수정할 기존 미디에이션 그룹이 있는 경우 해당 미디에이션 그룹의 이름을 클릭하여 수정한 후 i-mobile 광고 소스로 추가로 건너뜁니다.

새 미디에이션 그룹을 만들려면 미디에이션 그룹 만들기를 선택합니다.

광고 형식과 플랫폼을 입력하고 계속을 클릭합니다.

미디에이션 그룹에 이름을 지정하고 타겟팅할 위치를 선택합니다. 미디에이션 그룹 상태를 사용으로 설정한 다음 광고 단위 추가를 클릭합니다.

이 미디에이션 그룹을 하나 이상의 기존AdMob 광고 단위와 연결합니다. 그런 다음 완료를 클릭합니다.

이제 광고 단위 카드가 선택한 광고 단위로 채워진 것을 볼 수 있습니다.

광고 소스로 i-mobile 추가

광고 소스 섹션의 폭포식 구조 카드에서 광고 소스 추가를 선택합니다. 그런 다음 i-mobile을 선택합니다.

i-mobile를 선택하고 최적화 스위치를 사용 설정합니다. 이전 섹션에서 가져온 Login name and API Password을 입력하여i-mobile에 대해 광고 소스 최적화를 설정합니다. 그런 다음i-mobile 에 eCPM 값을 입력하고 계속을 클릭합니다.

이미 i-mobile에 대한 매핑이 있는 경우 해당 매핑을 선택할 수 있습니다. 그렇지 않으면 매핑 추가를 클릭합니다.

그런 다음 이전 섹션에서 얻은 Publisher ID, Media ID and Spot 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.3.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.0")
}

手动集成

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

  2. 转到 i-mobile 适配器工件 。选择最新版本，下载 i-mobile 适配器的 .aar 文件，并将其添加到您的项目。

第 4 步：添加所需的代码

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

第 5 步：测试实现效果

테스트 광고 사용 설정

AdMob i-mobile은 테스트용 테스트 Spot ID, 미디어 ID, 게시자 ID를 제공하며 여기에서 확인할 수 있습니다.

테스트 광고 확인

i-mobile에서 테스트 광고를 수신하고 있는지 확인하려면 광고 검사기에서 i-mobile (Waterfall) 광고 소스를 사용하여 단일 광고 소스 테스트를 사용 설정하세요.

可选步骤

使用原生广告

广告呈现

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

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

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

错误代码

如果适配器无法接收来自 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 在 AdMob 界面中配置的 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

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