将 InMobi 与中介集成

将 InMobi 添加到 GDPR 和美国州级法规广告合作伙伴名单

请按照 GDPR 设置和 美国州级法规设置中的步骤，将 InMobi 添加到 AdMob 界面中的 GDPR 和美国州级法规广告合作伙伴名单中。

第 3 步：导入 InMobi SDK 和适配器

使用 CocoaPods（推荐）

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

  pod 'GoogleMobileAdsMediationInMobi'
  

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

  pod install --repo-update

手动集成

• 下载最新版本的 InMobi iOS SDK，并在项目中关联 InMobiSDK.framework。

• 从更新日志中的下载链接下载最新版 InMobi 适配器，并在项目中关联 InMobiAdapter.framework。
• 将以下框架添加到您的项目中
  • libsqlite3.0.tbd
  • libz.tbd
  • WebKit.framework

项目设置

在 Application Target > Build Settings 下，将 -ObjC 标志添加到 Other Linker Flags。

第 4 步：在 InMobi SDK 中实现隐私设置

欧盟地区意见征求和 GDPR

根据 Google 《欧盟地区用户意见征求政策》，您必须确保向位于欧洲经济区 (EEA) 的用户披露相关信息并征得他们的同意，以便使用设备标识符和个人数据。此政策反映了欧盟《电子隐私指令》和《一般数据保护条例》(GDPR) 的要求。在征求用户意见时，您必须指明中介链中可能会收集、接收或使用个人数据的每个广告联盟，并提供有关每个广告联盟使用情况的信息。Google 目前无法自动将用户的意见征求选择传递给此类广告联盟。

在 7.1.1.0 版中，InMobi 适配器添加了 GADMInMobiConsent 类，可让您将意见征求信息传递给 InMobi。以下示例代码会对 GADMInMobiConsent 类调用 updateGDPRConsent。如果您选择调用此方法，建议您先调用此方法，然后再通过 Google 移动广告 SDK 请求广告。

import InMobiAdapter
// ...

var consentObject = Dictionary<String, String>()
consentObject["gdpr"] = "1"
consentObject[IM_GDPR_CONSENT_AVAILABLE] = "true"

GADMInMobiConsent.updateGDPRConsent(consentObject)

#import <InMobiAdapter/InMobiAdapter.h>
// ...

NSMutableDictionary *consentObject = [[NSMutableDictionary alloc] init];
[consentObject setObject:@"1" forKey:@"gdpr"];
[consentObject setObject:@"true" forKey:IM_GDPR_CONSENT_AVAILABLE];

[GADMInMobiConsent updateGDPRConsent:consentObject];

如需详细了解 InMobi 在此意见征求对象中接受的可能键值对，请参阅 InMobi 的 GDPR 实现详情。

美国州级隐私保护法律

美国各州隐私保护法律 要求向用户提供选择不“出售”其“个人信息”（该法律对这些术语进行了定义）的权利，并要求“出售”方在首页醒目位置提供“不出售我的个人信息”链接，以供用户选择。美国州级隐私保护法律合规指南提供了为 Google 广告投放启用受限的数据处理的功能，但 Google 无法将此设置应用于中介链中的每个广告网络。因此，您必须找出中介链中可能参与销售个人信息的每个广告网络，并遵循每个广告网络的指南，以确保合规。

在版本10.5.6.0、中，InMobi 适配器添加了从共享偏好设置中读取 IAB 美国隐私权字符串的支持。 NSUserDefaults。 按照 美国州级隐私保护法律文档 中的说明，在 NSUserDefaults。

此外，如需了解如何在 InMobi 信息中心内启用 CCPA 设置，请参阅 InMobi 的 CCPA 文档。

第 5 步：需要额外的代码

SKAdNetwork 集成

按照 InMobi 的文档将 SKAdNetwork 标识符添加到项目的 Info.plist 文件中。

第 6 步：测试您的实现

启用测试广告

请务必为 AdMob 注册测试设备，并在 InMobi 界面中启用测试模式。

验证测试广告

如需验证您是否在接收来自 InMobi 的测试广告，请使用 InMobi（出价）和 InMobi（瀑布流）广告来源在广告检查器中启用单个广告来源测试。

可选步骤

网络专用参数

InMobi 适配器支持其他请求参数，这些参数可使用 GADInMobiExtras 类传递给适配器。GADInMobiExtras 包含适用于所有受支持广告格式的以下通用属性：

以下代码示例展示了如何设置这些广告请求参数：

let request = GADRequest()
let extras = GADInMobiExtras()
extras.ageGroup = kIMSDKAgeGroupBetween35And54
extras.areaCode = "12345"
request.registerAdNetworkExtras(extras)

GADRequest *request = [GADRequest request];
GADInMobiExtras *extras = [[GADInMobiExtras alloc] init];
extras.ageGroup = kIMSDKAgeGroupBetween35And54;
extras.areaCode = @"12345";
[request registerAdNetworkExtras:extras];

使用原生广告

广告呈现

InMobi 适配器会将其原生广告作为 GADNativeAd 对象返回。它会为 GADNativeAd。

¹ InMobi 适配器不为其原生广告提供对主图片素材资源的直接访问权限。而是由适配器使用视频或图片填充 GADMediaView 。

展示和点击跟踪

Google 移动广告 SDK 会检测点击并将其转发给 InMobi，因此点击报告将保持同步。

Google 移动广告 SDK 使用 InMobi SDK 的回调进行展示跟踪，因此这两个信息中心中的报告应该是一致的，差异很小或没有差异。

错误代码

如果适配器未能从 InMobi 收到广告，发布商可以使用以下类下的 GADResponseInfo.adNetworkInfoArray：

GADMAdapterInMobi
GADMediationAdapterInMobi

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

InMobi iOS 中介适配器更新日志

版本 10.7.8.0

• 已验证与 InMobi SDK 10.7.8 的兼容性。

构建和测试所需版本：

• Google 移动广告 SDK 版本 11.10.0。
• InMobi SDK 版本 10.7.8。

版本 10.7.5.1

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

构建和测试所需版本：

• Google 移动广告 SDK 版本 11.10.0。
• InMobi SDK 版本 10.7.5。

版本 10.7.5.0

• 已验证与 InMobi SDK 10.7.5 的兼容性。

构建和测试所需版本：

• Google 移动广告 SDK 11.7.0 版。
• InMobi SDK 版本 10.7.5。

版本 10.7.4.0

• 已验证与 InMobi SDK 10.7.4 的兼容性。

构建和测试所需版本：

• Google 移动广告 SDK 11.6.0 版。
• InMobi SDK 版本 10.7.4。

版本 10.7.2.0

• 已验证与 InMobi SDK 10.7.2 的兼容性。

构建和测试所需版本：

• Google 移动广告 SDK 11.3.0 版。
• InMobi SDK 版本 10.7.2。

版本 10.7.1.0

• 已验证与 InMobi SDK 10.7.1 的兼容性。

构建和测试所需版本：

• Google 移动广告 SDK 11.2.0 版。
• InMobi SDK 版本 10.7.1。

版本 10.6.4.0

• 已验证与 InMobi SDK 10.6.4 的兼容性。
• 将已废弃的 GADMobileAds.sharedInstance.sdkVersion 方法替换为 GADMobileAds.sharedInstance.versionNumber。
• 将对 NSUserDefaults 的使用替换为 CFPreferences 函数。
• 现在，最低 iOS 版本要求为 12.0。
• 现在需要 Google 移动广告 SDK 11.0 或更高版本。
• 在 InMobiAdapter.xcframework 中的框架中添加了 Info.plist。

构建和测试所需版本：

• Google 移动广告 SDK 版本 11.0.1。
• InMobi SDK 版本 10.6.4。

版本 10.6.0.0

• 已经验证与 InMobi SDK 10.6.0 兼容。
• 为出价横幅广告、插页式广告和激励广告格式添加了水印支持。

构建和测试所需版本：

• Google 移动广告 SDK 10.13.0 版。
• InMobi SDK 版本 10.6.0。

版本 10.5.8.0

• 已验证与 InMobi SDK 10.5.8 的兼容性。

构建和测试所需版本：

• Google 移动广告 SDK 10.10.0 版。
• InMobi SDK 版本 10.5.8。

版本 10.5.6.0

• 添加了从 NSUserDefaults 读取 IAB 美国隐私字符串的支持。
• 已验证与 InMobi SDK 10.5.6 的兼容性。
• 新增了对横幅广告（包括 MREC）、插页式广告和激励广告格式的出价支持。

构建和测试所需版本：

• Google 移动广告 SDK 10.9.0 版。
• InMobi SDK 版本 10.5.6。

版本 10.5.5.0

• 现在需要 Google 移动广告 SDK 10.4.0 或更高版本。
• 更新了适配器以使用 didRewardUser API。
• 更新了适配器，以便在主线程中初始化 InMobi SDK。

构建和测试所需版本：

• Google 移动广告 SDK 10.4.0 版。
• InMobi SDK 版本 10.5.5。

版本 10.5.4.0

• 已验证与 InMobi SDK 10.5.4 的兼容性。
• 移除了已废弃的性别、生日和位置中介 API。
• 移除了对 armv7 架构的支持。
• 现在，最低 iOS 版本要求为 11.0。
• 现在需要 Google 移动广告 SDK 10.0.0 或更高版本。

构建和测试所需版本：

• Google 移动广告 SDK 10.2.0 版。
• InMobi SDK 版本 10.5.4。

补充说明：

• 此版本是在 10.1.3.0 版之前创建的，因此不使用 didRewardUser API。

版本 10.1.3.0

• 已验证与 InMobi SDK 10.1.3 的兼容性。
• 现在需要 Google 移动广告 SDK 10.4.0 或更高版本。
• 更新了适配器以使用 didRewardUser API。

构建和测试所需版本：

• Google 移动广告 SDK 10.5.0 版。
• InMobi SDK 版本 10.1.3。

补充说明：

• 此版本是在版本 10.5.4.0 之后创建的。

版本 10.1.2.1

• 已验证与 InMobi SDK 10.1.2 的兼容性。
• 修复了原生广告在可滚动界面中可能会变为空白的问题。
• 更新了适配器，以使用新的中介 API。
• 添加了对将 COPPA 值转发到 InMobi SDK 的支持。

构建和测试所需版本：

• Google 移动广告 SDK 9.14.0 版。
• InMobi SDK 版本 10.1.2。

版本 10.1.2.0

• 已验证与 InMobi SDK 10.1.2 的兼容性。

构建和测试所需版本：

• Google 移动广告 SDK 9.13.0 版。
• InMobi SDK 版本 10.1.2。

版本 10.1.1.0

• 已验证与 InMobi SDK 10.1.1 的兼容性。

构建和测试所需版本：

• Google 移动广告 SDK 9.12.0 版。
• InMobi SDK 版本 10.1.1。

版本 10.1.0.0

• 已经验证与 InMobi SDK 10.1.0 兼容。
• 更新了适配器以使用 didRewardUser API。
• 现在需要 Google 移动广告 SDK 9.8.0 或更高版本。

构建和测试所需版本：

• Google 移动广告 SDK 9.11.0 版。
• InMobi SDK 版本 10.1.0。

版本 10.0.7.0

• 已验证与 InMobi SDK 10.0.7 的兼容性。

构建和测试所需版本：

• Google 移动广告 SDK 9.5.0 版。
• InMobi SDK 版本 10.0.7。

版本 10.0.5.0

• 已验证与 InMobi SDK 10.0.5 的兼容性。

构建和测试所需版本：

• Google 移动广告 SDK 9.2.0 版。
• InMobi SDK 版本 10.0.5。

版本 10.0.2.1

• 已经验证与 Google 移动广告 SDK 9.0.0 版本兼容。
• 现在需要 Google 移动广告 SDK 9.0.0 或更高版本。

构建和测试所需版本：

• Google 移动广告 SDK 9.0.0 版。
• InMobi SDK 版本 10.0.2。

版本 10.0.2.0

• 已经验证与 InMobi SDK 10.0.2 的兼容性。

构建和测试所需版本

• Google 移动广告 SDK 8.13.0 版。
• InMobi SDK 版本 10.0.2。

版本 10.0.1.0

• 已经验证与 InMobi SDK 10.0.1 兼容。

构建和测试所需版本

• Google 移动广告 SDK 8.12.0 版。
• InMobi SDK 版本 10.0.1。

版本 10.0.0.0

• 已经验证与 InMobi SDK 10.0.0 的兼容性。
• 现在需要的最低 iOS 版本为 10.0。

构建和测试所需版本

• Google 移动广告 SDK 8.11.0 版。
• InMobi SDK 版本 10.0.0。

版本 9.2.1.0

• 已验证与 InMobi SDK 9.2.1 的兼容性。

构建和测试所需版本

• Google 移动广告 SDK 8.9.0 版。
• InMobi SDK 版本 9.2.1。

版本 9.2.0.0

• 已验证与 InMobi SDK 9.2.0 的兼容性。
• 放宽了对 Google 移动广告 SDK 8.0.0 或更高版本的依赖。

构建和测试所需版本

• Google 移动广告 SDK 8.8.0 版。
• InMobi SDK 版本 9.2.0。

版本 9.1.7.0

• 已验证与 InMobi SDK 9.1.7 的兼容性。
• 现在需要 Google 移动广告 SDK 8.3.0 或更高版本。

构建和测试所需版本

• Google 移动广告 SDK 8.3.0 版。
• InMobi SDK 版本 9.1.7。

版本 9.1.5.0

• 已验证与 InMobi SDK 9.1.5 的兼容性。
• 现在需要 Google 移动广告 SDK 8.1.0 或更高版本。

构建和测试所需版本

• Google 移动广告 SDK 8.1.0 版。
• InMobi SDK 版本 9.1.5。

版本 9.1.1.1

• 更新了适配器以使用 .xcframework 格式。
• 现在需要 Google 移动广告 SDK 8.0.0 或更高版本。

构建和测试所需版本

• Google 移动广告 SDK 8.0.0 版。
• InMobi SDK 版本 9.1.1。

版本 9.1.1.0

• 已验证与 InMobi SDK 9.1.1 的兼容性。
• 现在需要 Google 移动广告 SDK 7.68.0 或更高版本。

构建和测试所需版本

• Google 移动广告 SDK 7.68.0 版。
• InMobi SDK 版本 9.1.1。

版本 9.1.0.0

• 已经验证与 InMobi SDK 9.1.0 兼容。
• 现在需要 Google 移动广告 SDK 7.65.0 或更高版本。

构建和测试所需版本

• Google 移动广告 SDK 7.65.0 版。
• InMobi SDK 版本 9.1.0。

版本 9.0.7.2

• 如果未指定面向儿童的内容处理方式，激励广告不再默认采用 coppa=0。

构建和测试所需版本

• Google 移动广告 SDK 7.61.0 版。
• InMobi SDK 版本 9.0.7。

版本 9.0.7.1

• 现在需要 Google 移动广告 SDK 7.61.0 或更高版本。
• 添加了标准化的适配器错误代码和消息。

构建和测试所需版本

• Google 移动广告 SDK 7.61.0 版。
• InMobi SDK 版本 9.0.7。

版本 9.0.7.0

• 已经验证与 InMobi SDK 9.0.7 兼容。

构建和测试所需版本

• Google 移动广告 SDK 7.60.0 版。
• InMobi SDK 版本 9.0.7。

版本 9.0.6.0

• 已验证与 InMobi SDK 9.0.6 的兼容性。
• 更新了 InMobi iOS 适配器 CocoaPod 依赖项，以使用 InMobiSDK/Core。
• 现在需要 Google 移动广告 SDK 7.60.0 或更高版本。

构建和测试所需版本

• Google 移动广告 SDK 7.60.0 版
• InMobi SDK 版本 9.0.6

版本 9.0.4.0

• 已验证与 InMobi SDK 9.0.4 的兼容性。
• 现在，如果 InMobi SDK 初始化失败，适配器会提前失败。
• 移除了对 i386 架构的支持。

构建和测试所需版本

• Google 移动广告 SDK 7.57.0 版
• InMobi SDK 版本 9.0.4

版本 9.0.0.0

• 已经验证与 InMobi SDK 9.0.0 的兼容性。
• 移除了针对横幅广告、插页式广告和激励广告格式的出价功能。

构建和测试所需版本

• Google 移动广告 SDK 7.53.1 版
• InMobi SDK 版本 9.0.0

版本 7.4.0.0

• 已经验证与 InMobi SDK 7.4.0 兼容。

版本 7.3.2.1

• 修复了适配器因中介配置无效而无法初始化的问题。

版本 7.3.2.0

• 已验证与 InMobi SDK 7.3.2 的兼容性。
• 为适配器添加了针对横幅广告、插页式广告和激励广告格式的出价功能。

版本 7.3.0.0

• 已经验证与 InMobi SDK 7.3.0 兼容。
• 移除了对原生内容广告请求和应用安装广告请求的支持。应用必须使用 Unified Native Ads API 请求原生广告。
• 现在需要 Google 移动广告 SDK 7.46.0 或更高版本。

版本 7.2.7.0

• 已验证与 InMobi SDK 7.2.7 的兼容性。
• 更新了适配器以使用新的激励广告 API。
• 现在需要 Google 移动广告 SDK 7.42.2 或更高版本。
• 新增了对灵活横幅广告尺寸的支持。

版本 7.2.4.0

• 已验证与 InMobi SDK 7.2.4 的兼容性。

版本 7.2.1.0

• 已验证与 InMobi SDK 7.2.1 的兼容性。

版本 7.2.0.0

• 已经验证与 InMobi SDK 7.2.0 兼容。

版本 7.1.2.0

• 已验证与 InMobi SDK 7.1.2 的兼容性。

版本 7.1.1.2

• 向适配器添加了 adapterDidCompletePlayingRewardBasedVideoAd: 回调。

版本 7.1.1.1

• 添加了 GADInMobiConsent 类，该类提供 updateGDPRConsent 和 getConsent 方法。

版本 7.1.1.0

• 已验证与 InMobi SDK 7.1.1 的兼容性。

版本 7.1.0.0

• 已经验证与 InMobi SDK 7.1.0 兼容。

版本 7.0.4.1

• 修复了当适配器与其他网络的适配器搭配使用时会导致重复符号错误的问题。

版本 7.0.4.0

• 更新了适配器，使其与 InMobi SDK 7.0.4 兼容。
• 添加了对原生视频广告的支持。
• InMobi 的 SDK 不会为包含视频素材资源的广告提供图片。为避免潜在的 NullPointerException，当适配器收到其中一种广告时，它会自动创建一个空白的 NativeAd.Image，并将其包含在应用收到的广告对象中的图片素材资源数组中。我们建议使用此适配器的发布商在中介到 InMobi 时避免直接使用图片素材资源，而是在其界面中使用 GADMediaView。GADMediaView 会自动为包含视频素材资源的广告展示视频素材资源，并为不包含视频素材资源的广告展示图片素材资源。

版本 6.2.1.0

• 已验证与 inMobi SDK 6.2.1 的兼容性

早期版本

• 支持横幅广告、插页式广告、激励视频广告和原生广告格式。