ZBAdvertisementSDK 1.0.0.4

ZBAdvertisementSDK 1.0.0.4

seanios 维护。



  • Sean

iOS 广告 SDK集成文档

Cocoapods集成

Cocoapods集成统计SDK,例如工程target名为appDemo,在项目根目录的Podfile的格式:

target 'appDemo' do
pod 'ZBAdvertisementSDK'
end

ZBAdvertisementSDK支持的iOS最低版本为9.0

Pod集成示例更新说明

在配置以上 Podfile 文件后,终端使用 pod update 命令进行更新和集成。

$ cd [存放Podfile的项目路径]
$ pod update

注意:不建议加入--no-repo-update 参数,若添加后仅从本地Cocoapods库中查找SDK,不再更新线上SDK。如果本地存在SDK会直接使用本地SDK版本(不是线上最新版本),若本地不存在SDK会产生错误。也不建议使用 pod install 命令,此命令不会更新最新版本SDK。

由于 pod search 命令对新增项目可能出现无法找到的情况,建议直接使用 pod update 进行直接更新。

Pod常见问题

问题: pod search 报错:无法找到名为

“Unable to find a pod with name, author, summary, or description matching `ZBAdvertisementSDK`”

原因:新增 Pod 项目并没有实时同步到 pod search 所需的索引文件中:~/Library/Caches/CocoaPods/search_index.json

解决:

1、执行 pod setup,完成后再进行 pod search 搜索

2、删除上面提到的 cocoapods 对应路径的索引文件,再执行 pod search 时重建索引就可以找到相应项目

在终端输入以下命令

rm ~/Library/Caches/CocoaPods/search_index.json

手动集成framwork

在GitHub下载最新SDK https://github.com/wangxinIOS/ZBAdvertisementSDK

集成步骤如下:

  1. 下载ZBAdFramework。

  2. Xcode 文件 —> 将文件添加到"您的项目",在弹出窗口中选择所下载的组件包-> 添加。(注:选择“在需要时复制”)

  1. 添加依赖库,在项目设置目标 -> 选项卡通用 -> 链接框架和库如下:

    CoreTelephony.framework    获取运营商标识
    StoreKit.framework  应用内打开App Store
    AdSupport.framework 广告标识
    QuartzCore.framework
    ImageIO.framework
    

项目中Build Settings必须设置Other Linker Flags

集成说明

创建应用并获取ClientId

ClientId是广告SDK后台用来标示App的唯一标识符,集成SDK前需要在创建应用并获取相应的ClientId。

初始化,示例代码

在AppDelegate.m文件中 didFinishLaunchingWithOptions 方法内部设置

 ZBAdConfigure *confg = [ZBAdConfigure new];
 confg.debug = YES;//开发环境设置为YES,会访问测试环境URL
 [ZBAdApi gainApiWithClientId:@"ClientId" andConfig:confg];

ZBAdConfigure 属性的说明

/// debug模式 为true打印SDKlog信息  default:false
@property (nonatomic, assign) BOOL debug;

ZBAdDelegate 代理方法的说明

/**
 广告加载失败

 @param code 错误码
 @param msg 错误信息
 */
- (void)onAdLoadFailure:(NSString *)code msg:(NSString *)msg;

/**
 广告加载成功
 */
- (void)onAdLoadSuccess;

/**
 广告被点击
 */
- (void)onAdClick;

由于SDK处于测试阶段,网络请求使用http协议,项目中需要进行以下配置