Getting Started with the ironSource iOS SDK (Chinese)

在您开始之前

我们支持 iOS 版本 7 及更高版本。

第 1 步. 添加 SDK 至您的项目

ironSource SDK集成同时支持 Cocoapods 和手动下载两种途径:

使用 CocoaPods 集成 SDK

CocoaPods 是一种针对 Objective-C 和 Swift 的依赖管理器;其可简化 SDK 集成过程并使其自动化。请参见入门使用 CocoaPods 上的 CocoaPods 操作向导以了解更多信息。 要使用 Cocoapods 集成我们的 SDK,请在您的 podfile 中输入下行代码:

pod 'IronSourceSDK','6.6.3.1'

手动集成 SDK

请遵循以下步骤将 ironSource SDK 添加至您的项目中:

  1. 添加 IronSource 框架 在您下载 SDK 后;将其解压,并将 IronSource.framework 添加至您的 Xcode 工程中。
  2. 状态栏控件 要启用 ironSource SDK 来隐藏状态栏(即使在您的应用中,状态栏处于显示状态),请在 info.plist 中添加基于 View 控件的状态栏外观标记值,并将其设置为 NO
  3. 链接器标记 在构建设置中,添加以下链接器标记: Target ➣ Build Settings ➣ Linking ➣ Other Linker Flags: –ObjC
    iOS 10 应用传输安全设置 重要! 在 iOS9 中,Apple 加强了关于 ‘ATS’ 的控制。为确保所有的广告网络都能流畅的被调用,对您的 info.plist 文件进行以下更改很重要: 在此字典中,添加一个名为 ‘NSAllowsArbitraryLoads’的布尔值,并将其设置为 YES.
    ats
    注意:

    1. 请确保您的 info.plist 中除 ‘NSAllowsArbitraryLoads‘外不包含其他任何值,否则可能会造成冲突。
    2. 请在此处查找更多关于 ATS 的信息。

 

第 2 步. 设置Delegate

  1. 导入以下文件:
    OBJECTIVE-C

    #import "IronSource/IronSource.h"

    SWIFT
    IronSource-Bridging-Head.h。前往 Targets Build Settings ➣ Objective-C bridging header文件,并添加路径至您的bridging header文件中。关于header文件下载及其详细使用指南,请访问此处

  2.  可选:要接收详细日志事件,您可注册日志委托。
    OBJECTIVE-C

    [IronSource setLogDelegate:YOUR_LOG_DELEGATE];

    SWIFT

    IronSource.setLogDelegate(myLogDelegate)
  3. 设置Delegate  ironSource SDK 会触发多个事件,以通知您关于您广告单元的活动。 要接收这些事件,请注册您在 ironSource 平台上创建的广告单元的Delegate。
    1. 对于激励视频
      OBJECTIVE-C

      [IronSource setRewardedVideoDelegate:yourRewardedVideoDelegate];

      SWIFT

      IronSource.setRewardedVideoDelegate(yourRewardedVideoDelegate)
    2. 对于插屏广告
      OBJECTIVE-C

      [IronSource setInterstitialDelegate:yourInterstitialDelegate];

      SWIFT

      IronSource.setInterstitialDelegate(yourInterstitialDelegate)
    3. 对于积分墙
      OBJECTIVE-C

      [IronSource setOfferwallDelegate:yourOfferwallDelegate];

      SWIFT

      IronSource.setOfferwallDelegate(yourOfferwallDelegate)

第 3 步. 设置 UserID

若您正在投放积分墙广告单元,或是以服务器至服务器回调方式来使用我们的激励广告单元向用户提供奖励,您必须设置 UserID。 UserID 是对您每个用户分配的唯一标识符。您可以设置 userID 参数,或忽略它,让我们为您自动生成。若您选择在代码中不设置 userID,SDK 将会生成一个合法的 userID。

注意:若您希望手动定义 userID,您必须在初始化请求前完成此步。您在发出初始化请求后无法定义 userID。

我们支持 1 至 64 个字符长度的 NSString。通常做法是使用 Apple 广告 ID (IDFA)。更多关于 User ID 的信息可以在此处找到。

OBJECTIVE-C

[IronSource setUserId:YOUR_USERID];

SWIFT

IronSource.setUserId(userID)

第 4 步. 初始化 ironSource SDK

您可使用两种方式初始化 SDK。我们推荐第一种方式, 因为这种方式可抓取您指定的广告单元。 广告单元是字符串数组。

  1. 此方法将初始化在 adUnits 参数中指定的广告单元:
    OBJECTIVE-C

    [IronSource initWithAppkey:YOUR_APP_KEY adUnits:YOUR_AD_UNITS];

    SWIFT

    IronSource.initWithAppkey(kAPPKEY, adUnits:YOUR_AD_UNITS)

    Sample:

    OBJECTIVE-C

    [IronSource initWithAppKey:APP_KEY adUnits:@[IS_REWARDED_VIDEO]];
    /** or for all ad units
    [IronSource initWithAppKey:APP_KEY adUnits:@[IS_REWARDED_VIDEO,IS_INTERSTITIAL,IS_OFFERWALL, IS_BANNER]];

    SWIFT

    IronSource.initWithAppKey(kAPPKEY, adUnits:[IS_REWARDED_VIDEO];
    /** or for all ad units
    IronSource.initWithAppKey(kAPPKEY, adUnits:[IS_REWARDED_VIDEO,IS_INTERSTITIAL,IS_OFFERWALL, IS_BANNER];
  2.  或者,您可使用以下方式初始化 SDK, 在这种方式中 SDK 将初始化您在 ironSource 平台中已配置的广告单元:
    OBJECTIVE-C

    [IronSource initWithAppkey:YOUR_APP_KEY];

    SWIFT

    IronSource.initWithAppKey(kAPPKEY)

第 5 步. 验证集成

ironSource SDK 提供了一种简单方式,以验证您的激励视频中介集成是否成功。要验证 ironSource SDK 集成以及任何您已对接的其他广告网络,只需在项目中添加此方法即可

OBJECTIVE-C

[ISIntegrationHelper validateIntegration];

SWIFT

ISIntegrationHelper.validateIntegration()

要了解更多关于 ironSource 集成验证工具的详细信息,请前往这篇文章。   完成!您已在应用中集成了 ironSource SDK。  您现在已做好准备开始使用 ironSource 广告单元与优质聚合平台了。