미디에이션과 i-mobile 통합

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

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

支持的集成和广告格式

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

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

要求

  • iOS 部署目标为 12.0 或更高版本
  • 最新版 Google 移动广告 SDK

  • 看完中介服务入门指南

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

i-mobile 계정에 가입하거나 로그인합니다.

サイト/アプに管 (사이트/애플리케이션 관리) 탭과 앱 플랫폼 버튼을 클릭하여 i-mobile 대시보드에 앱을 추가합니다.

양식을 작성하고 新規設 (Sign up) 버튼을 클릭하세요.

새 광고 스팟을 만들려면 サイト/アプ管 (사이트/애플리케이션 관리) 탭에서 앱을 선택합니다.

広告ット管ン (광고 스팟 관리) 탭으로 이동하여 新規広告スス動ット (신규 광고 지점) 버튼을 클릭합니다.

create_ad_spot

그런 다음 広告ット名 (광고 스팟 이름), 広告ットサイズ (광고 스팟 크기) 및 기타 세부정보를 제공하여 양식을 작성합니다. 그런 다음 新規設 (Sign up) 버튼을 클릭합니다.

new_ad_spot_form

광고 스팟이 준비되었습니다. 통합 세부정보를 보려면 アプ設件動得 (Get App settings) 버튼을 클릭합니다.

ad_spot_list

【ホホテテーID (게시자 ID), 건너뛴 문서 ID (미디어 ID), ヰトID (Spot ID)를 기록해 두세요. 이러한 매개변수는 나중에 AdMob UI에서 미디에이션을 위해 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 和适配器

将以下代码行添加到项目的 Podfile 中:

pod 'GoogleMobileAdsMediationIMobile'

在命令行中运行以下命令:

pod install --repo-update

手动集成

  • 下载最新版本的 i-mobile SDK,并在项目中关联 ImobileSdkAds.framework
  • 通过更新日志中的下载链接下载最新版本的 i-mobile 适配器,并在项目中关联 IMobileAdapter.framework

第 4 步:添加所需的代码

SKAdNetwork 集成

按照 i-mobile 的文档中的说明,将 SKAdNetwork 标识符添加到项目的 Info.plist 文件中。

第 5 步:测试实现效果

테스트 광고 사용 설정

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

테스트 광고 확인

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

可选步骤

使用原生广告

广告呈现

i-mobile 适配器会填充 GADNativeAd

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

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

错误代码

如果适配器未能接收来自 i-mobile 的广告,发布商可以使用 GADResponseInfo.adNetworkInfoArray,位于以下类下:

格式 类名称
横幅 IMobileAdapter
插页式广告 IMobileAdapter
原生 GADMediationAdapterIMobile

当广告加载失败时,i-mobile 适配器会抛出以下代码和随附的消息:

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

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

版本 2.3.4.0

  • 已验证与 i-mobile SDK 2.3.4 的兼容性。
  • adSDKVersion 中添加了对返回 i-mobile SDK 版本的支持。

构建和测试时所用平台:

  • Google 移动广告 SDK 11.2.0 版。
  • i-mobile SDK 2.3.4 版。

版本 2.3.3.0

  • 已验证与 i-mobile SDK 2.3.3 的兼容性。

构建和测试时所用平台:

  • Google 移动广告 SDK 11.1.0 版。
  • i-mobile SDK 2.3.3 版。

版本 2.3.2.1

  • 从横幅广告、插页式广告和原生广告的植入方式中移除了已废弃的 willBackgroundApplication 委托方法。
  • 现在要求最低 iOS 版本为 12.0。
  • 现在需要 Google 移动广告 SDK 11.0 或更高版本。
  • IMobileAdapter.xcframework 的框架中添加了 Info.plist

构建和测试时所用平台:

  • Google 移动广告 SDK 11.0.1 版。
  • i-mobile SDK 2.3.2 版。

版本 2.3.2.0

  • 已验证与 i-mobile SDK 2.3.2 的兼容性。
  • 移除了对 armv7 架构的支持。
  • 现在要求最低 iOS 版本为 11.0。
  • 现在需要 Google 移动广告 SDK 10.4.0 或更高版本。

构建和测试时所用平台:

  • Google 移动广告 SDK 10.4.0 版。
  • i-mobile SDK 2.3.2 版。

版本 2.3.1.0

  • 已验证与 i-mobile SDK 2.3.1 的兼容性。

构建和测试时所用平台:

  • Google 移动广告 SDK 10.3.0 版。
  • i-mobile SDK 2.3.1 版。

版本 2.3.0.1

  • 现在需要 Google 移动广告 SDK 10.0.0 或更高版本。

构建和测试时所用平台:

  • Google 移动广告 SDK 10.0.0 版。
  • i-mobile SDK 2.3.0 版。

版本 2.3.0.0

  • 已验证与 i-mobile SDK 2.3.0 的兼容性。
  • 现在需要 Google 移动广告 SDK 9.8.0 或更高版本。

构建和测试时所用平台:

  • Google 移动广告 SDK 9.13.0 版。
  • i-mobile SDK 2.3.0 版。

版本 2.2.0.1

  • 现在需要 Google 移动广告 SDK 9.0.0 或更高版本。

构建和测试时所用平台:

  • Google 移动广告 SDK 9.0.0 版。
  • i-mobile SDK 2.2.0 版。

版本 2.2.0.0

  • 已验证与 i-mobile SDK 2.2.0 版的兼容性。

构建和测试所用的

  • Google 移动广告 SDK 8.13.0 版。
  • i-mobile SDK 2.2.0 版。

版本 2.1.0.1

  • 放宽了对 Google 移动广告 SDK 8.0.0 或更高版本的依赖。

构建和测试所用的

  • Google 移动广告 SDK 8.4.0 版。
  • i-mobile SDK 2.1.0 版。

版本 2.1.0.0

  • 已验证与 i-mobile SDK 2.1.0 版的兼容性。
  • 现在需要 Google 移动广告 SDK 8.1.0 或更高版本。
  • 将适配器更新为使用 .xcframework 格式。

构建和测试所用的

  • Google 移动广告 SDK 8.1.0 版。
  • i-mobile SDK 2.1.0 版。

版本 2.0.33.1

  • 添加了标准化的适配器错误代码和消息。
  • 适配器现在会限制请求使用相同 i-mobile Spot ID 的多个插页式广告。
  • 现在,适配器会在点按原生广告时转发 -nativeAdWillLeaveApplication: 回调。
  • 现在需要 Google 移动广告 SDK 7.68.0 或更高版本。

构建和测试所用的

  • Google 移动广告 SDK 7.68.0 版。
  • i-mobile SDK 2.0.33 版。

版本 2.0.33.0

  • 已验证与 i-mobile SDK 2.0.33 版的兼容性。
  • 现在需要 Google 移动广告 SDK 7.65.0 或更高版本。
  • 现在要求 iOS 最低版本为 9.0。

构建和测试所用的

  • Google 移动广告 SDK 7.65.0 版。
  • i-mobile SDK 2.0.33 版。

版本 2.0.32.0

  • 已验证与 i-mobile SDK 2.0.32 版兼容。
  • 现在需要 Google 移动广告 SDK 7.60.0 或更高版本。
  • 添加了对缩放 320x50 和 320x100 广告的支持,以更好地适应自适应横幅广告请求尺寸。
  • 取消了对 i386 架构的支持。

构建和测试所用的

  • Google 移动广告 SDK 7.60.0 版。
  • i-mobile SDK 2.0.32 版。

版本 2.0.31.0

  • 已验证与 i-mobile SDK 2.0.31 版兼容。

构建和测试所用的

  • Google 移动广告 SDK 7.53.1 版。
  • i-mobile SDK 2.0.31 版。

版本 2.0.29.0

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

构建和测试所用的

  • Google 移动广告 SDK 7.52.0 版。
  • i-mobile SDK 2.0.29 版。