Monetize

最后更新于

July 15, 2022

iOS (文章)

  • 此页面上提供了所有 iOS 14+ 信息。
  • 从 Chartboost iOS SDK 版本 8.3.1 开始,iOS 10 是支持的最低 iOS 版本。 只有较早版本的 Chartboost iOS SDK 保留对较旧 iOS 版本的支持。
    ‍‍
  • M1 上的 Mac:使用旧版 SDK 或没有 CocoaPods 的 8.5.0.2 的应用发布者将无法在运行于 M1 Mac 上的 iOS 模拟器上运行他们的应用程序。 要解决这个问题,他们只需要转到他们的 Xcode 项目“Build Settings”并在“Excluded Architectures”中添加值为“arm64”的“Any iOS Simulator SDK”。
  • Xcode 13.1 是发布商集成 Chartboost Ads SDK 9.0 及更高版本时的最低要求。

在您开始之前:

Chartboost SDK 需要运行在 iOS 10.0 或更高版本系统中运行。支持 iPhone 5 或以上版本, iPod 6th 或更高版本, and iPad 4th 或更高版本.

  • 您有没有注册Chartboost 帐户?
  • 是否将App 添加到了您的后台控制面板?
  • 是否下载了最新的 SDK?
  • 是否下载了 Chartboost 范例 App
  • 应用程序必须使用高于 v10.0 的 iOS 基础 SDK 进行编译。
  • 截至 2016 年 6 月 1 日,苹果公司要求所有提交的 App 支持 IPv6。

startWithAppId必须始终在您 App 启动的前几秒内 硬启动和软启动期间调用。与您 App 内任何其他操作或用户互动无关。

发布商应从 Chartboost SDK 调用 addDataUseConsent API,并为 GDPR 和 CCPA 传递适当的同意值。 作为服务条款的一部分,发布商需要在 Chartboost 处理任何个人数据并通过上述方法将其传递给 Chartboost SDK 之前获得其用户的同意。 如果可能,应在 startWithAppId 之前调用此方法。

此处详细了解隐私方法,在此处详细了解行为定位。

1. 将 Chartboost 框架 ChartboostSDK.xcframework 导入您的 Xcode 项目。

选项 1:CocoaPods
下载 Chartboost SDK 并将其链接到您的项目的最简单方法是使用 CocoaPods。 您只需要打开项目的 Podfile 并添加以下行:

pod 'ChartboostSDK'

然后从命令行运行它:

pod install --repo-update

如果您是新手,请务必查看 CocoaPods 的文档。 如果您选择此选项,则应跳至第 4 步。

2. 在 XCode 项目的 Build Settings / Other Linker Flags 里添加一个 -ObjC 参数,对Debug 和 Release 作同样设置。

3. 添加 Chartboost 专属的 SKAdNetworkIdentifier 列表到 Info.plist 文件

这一步是集成 iOS 14 的必要选项.


在您项目的 Info.plist 文件里添加名为 SKAdNetworkItems 的 Dictionary 数组,然后添加 Chartboost 的 SKAdNetworkIdentifier,取值: f38h382jlk.skadnetwork ,以及其他合作方的 SKAdNetworkIdentifier 列表。

完整的 Chartboost 相关 SKAdNetwork IDs 列表可以通过此处 XMLJSON 查看。您需要将这些 SKAdNetworkIdentifiers 放入您项目的 info.plist 文件里。

IOS

content_copybrightness_medium

<key>SKAdNetworkItems</key>
<array>
 <dict>
   <key&gt;SKAdNetworkIdentifier</key>
   <string>f38h382jlk.skadnetwork</string>
 <dict>
.
.
.
</array>


专业提示:我们建议启用警告级别日志,以便获得我们最新的 SKAdNetwork ID 列表。

请参阅我们的 iOS 14 准备页面以了解更多信息。

4. 导入 Chartboost SDK

5. 在您的 didFinishLaunchingWithOptions 方法中初始化 Chartboost。

startWithAppId 必须始终在应用程序启动的前几秒内的硬启动和软启动期间调用,无论应用程序中是否有任何其他操作或用户交互。

应用发布商应从 Chartboost SDK 调用 addDataUseConsent API,并传入适当的值来确定同意是否存在、不存在或未知。 作为服务条款的一部分,应用发布商需要在 Chartboost 处理任何个人数据并通过上述方法将其传递给 Chartboost SDK 之前获得其用户的同意。 如果可能,应在 startWithAppId 之前调用此方法。

6. 添加您的应用 ID 和应用签名。

  • 将 YOUR_CHARTBOOST_APP_ID 和 YOUR_CHARTBOOST_APP_SIGNATURE 替换为您的应用 ID 和应用签名。

Chartboost 应用程序 ID 是我们系统中的唯一应用程序标识符,因此需要为每个应用程序使用不同的 Chartboost 应用程序 ID。

7. 要显示静态或视频插页式广告:

插页式广告在显示之前需要缓存。 使用方法[interstitial cache]; 缓存插页式广告。

缓存插页式广告后,您可以使用方法 [interstitial showFromViewController:self]; 显示它。

  • 如果尝试显示插页式广告但尚未缓存,则操作将失败并且委托方法 didShow:error: 将被调用并出现 CHBShowErrorCodeNoCachedAd 错误。
  • 您可以在那里处理此错误或在显示广告之前预先检查 isCached 属性。 此属性指示广告是否已准备好显示。
    例子:

要展示插页式广告,首先创建它(详见此处),然后调用广告方法。

此处了解有关 iOS Chartboost 委托方法的更多信息。

8. 要显示激励式视频广告:


激励广告在显示前需要缓存。 使用方法[rewarded cache]; 缓存激励广告。

激励广告缓存后,您可以使用方法 [rewarded showFromViewController:self]; 显示它。

如果尝试显示奖励广告但尚未缓存,则操作将失败并且委托方法 didShow:error: 将被调用并出现 CHBShowErrorCodeNoCachedAd 错误。
您可以在那里处理此错误或在显示广告之前预先检查 isCached 属性。 此属性指示广告是否已准备好显示。
例子:

要展示激励广告,首先创建它(详见此处),然后调用广告方法。

此处了解有关 iOS Chartboost 委托方法的更多信息。

9. 展示横幅广告:

横幅广告在显示之前需要缓存。 使用方法[banner cache]; 缓存横幅广告。

要显示横幅广告,首先创建它(详见此处),然后调用广告方法。

10. 测试您的集成。

11. 在 Chartboost 后台控制面板中检查 SDK 图标。

  • 转到您的控制面板中App的App 设置 > 基本设置.
  • 当我们的服务器成功从我们的 SDK 使用您的 App ID 接收启动调用时,您 App 图标下的 SDK 将从灰色转为绿色。

 

太好了!您刚刚完成了在您的 App 中集成 Chartboost SDK!

现在您可以开始广告活动

查看更多 Chartboost SDK 功能

您可能还喜欢…