集成

CloudX iOS SDK 的 AppHarbr 广告质量连接器。无需发布方编写胶水代码即可对 CloudX 广告启用 AppHarbr 广告质量防护。

连接器（Connector）用于在 CloudX SDK 与其他产品之间传递数据。AppHarbr 连接器会对 CloudX 加载的广告运行 AppHarbr 广告质量防护。当 AppHarbr 拦截某个广告时，CloudX 不会展示该广告。只需添加依赖，防护即自动生效——连接器会在加载时向 CloudX SDK 自行注册。

安装

CocoaPods

pod 'CloudXAppHarbrConnector', '~> 1.38.3.0'

pod install --repo-update

无需任何代码改动。连接器不会初始化 AppHarbr，它使用您现有的 AppHarbr 配置和 API key。

Swift Package Manager

在 Xcode 中添加该包（File > Add Package Dependencies），并将 CloudXAppHarbrConnector 产品添加到您的应用 target：

https://github.com/cloudx-io/cloudx-ios-swift-package-connector-appharbr

• 最新包版本：1380300.0.0
• 请在应用 target 的 Other Linker Flags 中添加 -ObjC，以确保连接器在加载时自行注册。

手动注册

该 pod 会为您的 target 设置 -ObjC，以确保连接器的 +load 在宿主应用中执行并完成自行注册。如果您的构建未使用 -ObjC 链接，请在初始化 CloudX SDK 之前或之后手动注册一次：

#import <CloudXAppHarbrConnector/CloudXAppHarbrConnector.h>

CloudXAppHarbrConnectorRegister();

import CloudXAppHarbrConnector

CloudXAppHarbrConnectorRegister()

要求

• iOS 13 或更高版本。
• CloudXCore 3.11.0 或更高版本。
• 您的应用已使用自己的 AppHarbr API key 集成并初始化 AppHarbr SDK。连接器不会打包或初始化 AppHarbr；CocoaPods 会将该依赖与您应用中已有的 AppHarbrSDK 去重，因此运行时使用的是您的版本。
• 受支持的 AppHarbr SDK 版本：AppHarbrSDK 1.38.3 或更高版本。

分析范围

在通知您的应用广告已加载之前，连接器会将 CloudX 加载的每个广告发送给 AppHarbr 进行分析。如果 AppHarbr 放行该广告，则照常加载。如果 AppHarbr 拦截该广告，CloudX 不会展示它，您的应用会收到一次常规的加载失败。

如果 banner 或 MREC 在已显示后被拦截，您的应用会收到 didFailToLoadAd，同时 CloudX 会用新广告刷新该广告位。

如果 AppHarbr 尚未就绪或无法分析某个广告，该广告会正常展示。防护采用失败放行策略，不会自行阻止加载。

已知限制

• 来自 CloudX 需求、由 CloudX SDK 自行渲染的广告目前尚未被分析。AppHarbr 正在添加对这些广告的支持。
• Mintegral native 广告目前尚未被分析。后续的 CloudX 版本将添加支持。
• 在后续 AppHarbr SDK 版本发布之前，Moloco native 广告不会被分析。

未被分析的广告会照常加载和展示。

兼容性

支持

如需支持，请联系 support@cloudx.io