Integracja i-mobile z zapośredniczeniem

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

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

支持的集成和广告格式

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

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

要求

  • Android API 级别 21 或更高级别

  • 最新版 Google 移动广告 SDK

  • 看完中介服务入门指南

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

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

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

填写表单，然后点击新规定登录按钮。

要创建新的广告插播位，请在 {5}对该/企业管理（网站/应用管理）标签页下选择您的应用。

进入支持 Clickserver 管理（广告插播位管理）标签页，然后点击新规范编写 ット (New Ad Spot) 按钮。

create_ad_spot

接下来，填写以下表单：提供支持 プット名（广告插播位名称）、提供有关某个广告 的小程序 （广告 Spot 尺寸） 和其他详细信息。然后，点击 新式登榜（注册）按钮。

new_ad_spot_form

您的新广告插播位已准备就绪。如需查看其集成详情，请点击 Action to Settings Get (Get App settings) 按钮。

ad_spot_list

请记下小吃日本 ID（发布商 ID）、手机 ID（媒体 ID）和彷设有 ID (Spot ID)。您稍后在 Ad Manager 界面中为中介配置 i-mobile 时，将会用到这些参数。

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

Konfigurowanie ustawień zapośredniczenia dla jednostki reklamowej

Zaloguj się na konto Ad Managera.

Kliknij Wyświetlanie > Grupy zysku i kliknij przycisk Nowa grupa zysku.

Wpisz niepowtarzalną nazwę grupy zysku, ustaw Stan na Aktywna, wybierz Format reklamy, a jako Typ zasobów reklamowych wybierz Aplikacja mobilna. W sekcji Kierowanie > Zasoby reklamowe wybierz jednostkę reklamową w sekcjach Zasoby reklamowe i Aplikacja mobilna, do której chcesz dodać zapośredniczenie.

Następnie kliknij przycisk Dodaj partnera zysku.

Jeśli masz już partnera zysku w przypadku usługii-mobile, możesz go wybrać. W przeciwnym razie kliknij Utwórz nowego partnera zysku.

Jako Sieć reklamowa wybierz i-mobile, wpisz niepowtarzalną nazwę i włącz Zapośredniczenie.

Włącz Automatyczne zbieranie danych i wpiszLogin name and API Password

Po wybraniu Partnera zysku wybierz Zapośredniczenie mobilne SDK jako typ integracji, Android jako platformę i Aktywne jako stan. WpiszPublisher ID, Media ID and Spot ID uzyskane w poprzedniej sekcji. Następnie wpisz domyślną wartość CPM.

Gdy skończysz, u dołu strony kliknij Zapisz.

第 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.2.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 步：测试实现效果

Włącz reklamy testowe

Zarejestruj urządzenie testowe na potrzeby Ad Manager. i-mobile udostępnia testowe identyfikator Spotu, identyfikator mediów i identyfikator wydawcy na potrzeby testów. Znajdziesz je tutaj.

Weryfikacja reklam testowych

Aby sprawdzić, czy otrzymujesz reklamy testowe z witrynyi-mobile, włącz w inspektorze reklam testowanie pojedynczego źródła reklam, korzystając z i-mobile (Waterfall) źródeł reklam.

可选步骤

使用原生广告

广告呈现

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 界面中配置的 i-mobile 服务器参数缺失/无效。 Ad Manager
103 请求的广告尺寸与 i-mobile 支持的横幅尺寸不匹配。
104 i-mobile 的原生广告加载成功回调返回了一个空的原生广告列表。
0-10 i-mobile SDK 返回了错误。如需了解详情，请参阅代码。
101 界面中配置的 i-mobile 服务器参数缺失/无效。 Ad Manager
102 请求的广告尺寸与 i-mobile 支持的横幅尺寸不匹配。
103 i-mobile 无法展示广告。
104 i-mobile 返回了一个空的原生广告数组。
105 i-mobile 未能下载原生广告素材资源。
106 i-mobile 不支持使用同一 Spot ID 请求多个插页式广告。

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

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