Integracja i-mobile z zapośredniczeniem

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

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

支持的集成和广告格式

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

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

要求

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

  • 最新版 Google 移动广告 SDK

  • 看完中介服务入门指南

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

Zarejestruj się lub zaloguj na konto i-mobile.

Aby dodać aplikację do panelu i-mobile, kliknij kartę サイシ/アプチ管理 (Site/Application Management) i kliknij przycisk platformy aplikacji.

Wypełnij formularz i kliknij przycisk OPEN規登録 (Zarejestruj się).

Aby utworzyć nowe Spot reklamowy, wybierz swoją aplikację na karcie サイシ/アプチ管理 (Site/Application Management).

Przejdź do karty 広告ブブッシ管理 (Zarządzanie miejscem wyświetlania reklamy) i kliknij przycisk 規広告すッ (Nowe miejsce reklamy).

create_ad_spot

Następnie wypełnij formularz, podając 広告ブッブシキ (nazwa miejsca reklamy), 広告すッブサイズ (rozmiar reklamy) i inne szczegóły. Następnie kliknij przycisk OPEN規登録 (Zarejestruj się).

new_ad_spot_form

Twoje nowe miejsce wyświetlania reklamy jest gotowe. Aby wyświetlić szczegóły jego integracji, kliknij przycisk アプ zespołami엔定取得 (Pobierz ustawienia aplikacji).

ad_spot_list

Zwróć uwagę na パャキッシャーID (identyfikator wydawcy), 名デすアID (Media ID) i カッブシID (identyfikator Spotu). Będziesz ich potrzebować później podczas konfigurowania i-mobile na potrzeby zapośredniczenia w interfejsie Ad Manager .

第 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, iOS 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 和适配器

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

pod 'GoogleMobileAdsMediationIMobile'

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

pod install --repo-update

手动集成

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

第 4 步：添加所需的代码

SKAdNetwork 集成

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

第 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 适配器会填充 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 服务器参数缺失/无效。 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 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 版。