将 i-mobile 与中介集成

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

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

支持的集成和广告格式

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

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

要求

  • iOS 部署目标为 12.0 或更高版本

第 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 中介作为集成类型,选择 iOS 作为平台,并选择有效作为状态。输入您在上一部分中获取的发布商 ID媒体 ID广告插播 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 步:测试您的实现

启用测试广告

请务必为 Ad Manager 注册测试设备。 i-mobile 提供测试广告素材 ID媒体 ID发布商 ID,您可以在此处找到它们。

验证测试广告

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

可选步骤

使用原生广告

广告呈现

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

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

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

错误代码

如果适配器未能从 i-mobile 收到广告,发布商可以使用以下类下的 GADResponseInfo.adNetworkInfoArray 检查广告响应的底层错误:

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

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

错误代码 原因
0-10 i-mobile SDK 返回了错误。如需了解详情,请参阅代码
101 Ad Manager 界面中配置的 i-mobile 服务器参数缺失/无效。
102 请求的广告尺寸与 i-mobile 支持的横幅广告尺寸不符。
103 i-mobile 未能展示广告。
104 i-mobile 返回了一个空的原生广告数组。
105 i-mobile 未能下载原生广告素材资源。
106 i-mobile 不支持使用相同的广告展示位置 ID 请求多个插页式广告。

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

版本 2.3.4.1

  • 更新了 CFBundleShortVersionString,使其包含三个组件,而不是四个。

构建和测试所需版本:

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

版本 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 广告展示位置 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。