将 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 帐号。

通过以下方式添加应用以添加到 i-mobile 信息中心:点击 SAıtos/アプ optout 管理(网站/应用管理)标签页,然后点击新 Android アプı(新版 Android 应用)

通过提供应用的名称(名称)🇧?ーケطtos网址(市场网址)注册您的应用。 然后,在填写表单的其余部分后,点击新版协议(注册)按钮。

如需创建新的广告插播位,请在 SAıtos/アプる Management(网站/应用管理)标签页下选择您的应用。

进入 该广告(以下简称“广告插播位管理”)标签页,然后点击新建广告插播位通知(新建广告插播位)按钮。

create_ad_spot

接下来,填写表单,只需提供 ņเรเรtoname(广告插播位名称)ņเรเระเ往往(广告插播位尺寸)和其他详细信息即可。然后,点击 new Todenden (注册)按钮。

new_ad_spot_form

新的广告插播位已准备就绪。要查看其集成详情,请点击 アプし゗プナ(获取应用设置) 按钮。

ad_pot_list

请记下 🇪?🇸?طططー ID(发布商 ID)🇪?🇸?🏿?ア ID(媒体 ID)adxbuyer🇪?⏎ 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 值并点击继续

输入您的发布商 ID媒体 ID广告插播位 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:21.1.0'
    implementation 'com.google.ads.mediation:imobile:2.0.23.1'
}
...

手动集成

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

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

第 4 步:需要额外的代码

i-mobile 集成不需要额外的代码。

第 5 步:测试您的实现

为了测试您的集成,i-mobile 为所有广告格式提供了测试 Spot ID媒体 ID发布商 ID。您可以在此处找到这些资源。

可选步骤

使用原生广告

广告呈现

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

字段 始终由 i-mobile 适配器包含的资源
标题
映像
主体
应用图标 1
号召性用语
Star rating
存储
价格

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.0.23.1

  • compileSdkVersiontargetSdkVersion 更新为 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

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