# ADSuyi广告聚合SDKDemo-iOS
**Repository Path**: jianlailing/ADSuyiSDKDemo-iOS
## Basic Information
- **Project Name**: ADSuyi广告聚合SDKDemo-iOS
- **Description**: ADSuyi-iOS-OC-示例Demo
ADmobile广告聚合平台，让移动开发者可以根据自身业务选择支持接入的三方广告平台，并能快速接入、统一管理广告流量，同时借助ADmobile广告数据分析和聚合优化工具提升收益。SDK支持一站聚合管理优量汇穿山甲快手联盟等国内十几家主流移动广告平台，提供开屏广告、原生广告、插屏广告、横幅广告、激励视频广告、视频广告、全屏视频、插屏视频等广告样式，满足各类移动广告变现需求。支持Android、iOS开发。
- **Primary Language**: Objective-C
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: https://www.admobile.top/Suez.html
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 7
- **Created**: 2022-01-12
- **Last Updated**: 2022-05-24
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# ADmobile ADSuyiSDK iOS接入文档 v3.4.2.12161
[TOC]
## 修订历史
| 文档版本 | 修订日期 | 修订说明 |
| -------- | ---------- | ------------------------------------------------------------ |
| v3.1.5 | 2021-03-05 | 部分平台激励视频支持服务端验证;升级第三方SDK（优量汇、穿山甲等） |
| v3.2.0 | 2021-03-31 | admobile支持模板信息流;支持优量汇模板2.0激励视频;支持穿山甲新版插屏;升级第三方SDK（穿山甲,汇量,Unity等） |
| v3.2.1 | 2021-04-22 | 升级第三方SDK（穿山甲，百度，优量汇，汇量等），部分功能优化 |
| v3.2.2 | 2021-05-25 | admobile合规优化;支持优量汇插屏模板2.0;支持百度模板及自渲染 信息流;新增云码平台;升级第三方SDK（穿山甲，优量汇，快手等）；部分功能优化 |
| v3.2.3 | 2021-06-18 | 适配Gromore平台;支持快手非内容版本;升级第三方SDK（穿山甲，优量汇，汇量，百度，云码等）；部分功能优化 |
| v3.3.0 | 2021-07-20 | 新增开屏保底（可选）(支持穿山甲，优量汇，快手，百度，汇量）; 浮窗广告支持百度，快手平台；升级第三方SDK（穿山甲，优量汇，汇量，百度，快手等）；部分功能优化 |
| v3.3.1 | 2021-08-31 | 升级第三方SDK（穿山甲，优量汇，汇量，百度，快手等）；部分功能优化 |
| v3.3.2 | 2021-09-23 | 新增开屏热区及跳过按钮控制开关；升级第三方SDK（穿山甲，优量汇，汇量，百度，快手等）；部分功能优化 |
| v3.4.0 | 2021-11-04 | 新增开屏自定义跳过按钮位置调整(支持穿山甲,admobile)；新增快手插屏广告；升级第三方SDK（穿山甲，优量汇，汇量，快手等）；部分功能优化 |
| v3.4.1 | 2021-12-09 | 新增百度插屏广告支持；穿山甲，优量汇插屏全屏视频合并加载接口；升级第三方SDK（穿山甲，优量汇，汇量，百度，Gromore等）；部分功能优化 |
| v3.4.2 | 2022-01-04 | Admobile插屏样式修改；升级第三方SDK（穿山甲，优量汇，快手，百度，Gromore等）；部分功能优化 |
## 1.1 概述
尊敬的开发者朋友，欢迎您使用ADmobile 苏伊士广告SDK。通过本文档，您可以在几分钟之内轻松完成广告的集成过程。
操作系统： iOS 9.0 及以上版本
运行设备：iPhone （iPad上可能部分广告正常展示，但是存在填充很低或者平台不支持等问题，建议不要在iPad上展示广告，穿山甲等平台开屏广告iPad端展示异常）
- `ADSuyiSDK Objective-C Demo地址`[[ADSuyiSDK Objective-C Demo]](https://github.com/ADSuyi/ADSuyiSDKDemo-iOS)
- `ADSuyiSDK Swift Demo地址`[[ADSuyiSDK Swift Demo]](https://github.com/ADSuyi/ADSuyiSDKDemo-iOS-Swift.git)
## 2.1 采用cocoapods进行SDK的导入
推荐使用pod命令，使用[集成工具](https://app.admobile.top/#/adsdk/adsdk)获取导入命令
```ruby
// 挑选在苏伊士托管的平台导入项目，请不要导入全部，如果不清楚需要哪些平台可以咨询媒介
pod 'ADSuyiSDK','~> 3.4.2.0' # 主SDK 必选
pod 'ADSuyiSDK/ADSuyiSDKPlatforms/admobile' # ADMobile #必选
pod 'ADSuyiSDK/ADSuyiSDKPlatforms/gdt' # 优量汇(广点通）
pod 'ADSuyiSDK/ADSuyiSDKPlatforms/baidu' # 百度
pod 'ADSuyiSDK/ADSuyiSDKPlatforms/bu' # 穿山甲(头条)
pod 'ADSuyiSDK/ADSuyiSDKPlatforms/inmobi' # Inmobi
pod 'ADSuyiSDK/ADSuyiSDKPlatforms/ks' # 快手(非内容版本，内容与非内容版本不可同时导入)
pod 'ADSuyiSDK/ADSuyiSDKPlatforms/ksfull' # 快手(内容版本)
pod 'ADSuyiSDK/ADSuyiSDKPlatforms/mtg' # Mobvista(汇量)
pod 'ADSuyiSDK/ADSuyiSDKPlatforms/cloudcode' # 云码
pod 'ADSuyiSDK/ADSuyiSDKPlatforms/gromore' # gromore
```
推荐使用导入命令
```ruby
pod 'ADSuyiSDK', '~> 3.4.2.0' # 主SDK #必选
pod 'ADSuyiSDK/ADSuyiSDKPlatforms/admobile' # ADMobile #必选
pod 'ADSuyiSDK/ADSuyiSDKPlatforms/gdt' # 优量汇(广点通)
pod 'ADSuyiSDK/ADSuyiSDKPlatforms/baidu' # 百度
pod 'ADSuyiSDK/ADSuyiSDKPlatforms/bu' # 穿山甲(头条)
pod 'ADSuyiSDK/ADSuyiSDKPlatforms/inmobi' # Inmobi
pod 'ADSuyiSDK/ADSuyiSDKPlatforms/ks' # 快手(非内容版本，内容与非内容版本不可同时导入)
pod 'ADSuyiSDK/ADSuyiSDKPlatforms/ksfull' # 快手(内容版本)
pod 'ADSuyiSDK/ADSuyiSDKPlatforms/mtg' # Mobvista(汇量)
pod 'ADSuyiSDK/ADSuyiSDKPlatforms/cloudcode' # 云码
pod 'ADSuyiSDK/ADSuyiSDKPlatforms/gromore' # gromore
```
## 2.2 手动导入SDK方式
[点击进入SDK下载地址](https://doc.admobile.top/iOSSDK/ADSuyi_iOS_34212161_1c36319711a0b0d25ab3be7a60f072fb.zip)下载各SDK拖入到工程中
手动方式导入,需要添加如下依赖库:
```obj-c
AdSupport.framework
CoreLocation.framework
QuartzCore.framework
SystemConfiguration.framework
CoreTelephony.framework
libz.tbd
WebKit.framework (Optional)
libxml2.tbd
Security.framework
StoreKit.framework
AVFoundation.framework
CoreMedia.framework
```
头条还需要添加依赖库：
```obj-c
Accelerate.framework
AudioToolbox.framework
CoreGraphics.framework
CoreImage.framework
CoreMotion.framework
CoreText.framework
ImageIO.framework
JavaScriptCore.framework
MapKit.framework
MediaPlayer.framework
MobileCoreServices.framework
UIKit.framework
libbz2.tbd
libc++.tbd
libiconv.tbd
libresolv.9.tbd
libsqlite3.tbd
libc++abi.tbd
```
## 3.1 工程环境配置
1. 打开项目的 app target，查看 Build Settings 中的 Linking-Other Linker Flags 选项，确保含有 -ObjC 一值， 若没有则添加。
2. 在项目的 app target 中，查看 Build Settings 中的 Build options - Enable Bitcode 选项， 设置为NO。
3. info.plist 添加支持 Http访问字段
```obj-c
NSAppTransportSecurity
NSAllowsArbitraryLoads
```
4. Info.plist 添加定位权限字段（使用ADMobGenLocation可不设置）
```obj-c
NSLocationWhenInUseUsageDescription
NSLocationAlwaysAndWhenInUseUsageDeion
```
5. Info.plist推荐设置白名单，可提高广告收益
```obj-c
LSApplicationQueriesSchemes
dianping
imeituan
com.suning.SuningEBuy
openapp.jdmobile
vipshop
snssdk141
ctrip
suning
qunariphone
QunarAlipay
qunaraphone
yohobuy
kaola
agoda
openapp.xzdz
beibeiapp
taobao
tmall
openjd
jhs
yhd
wireless1688
GomeEShop
wbmain
xhsdiscover
douyin
pinduoduo
jdmobile
tbopen
pddopen
mogujie
koubei
eleme
youku
gengmei
airbnb
alipays
didicommon
OneTravel
farfetchCN
farfetch
snssdk1112
snssdk1128
miguvideo
kfcapplinkurl
iqiyi
uclink
app.soyoung
```
## 3.2 iOS14适配
由于iOS14中对于权限和隐私内容有一定程度的修改，而且和广告业务关系较大，请按照如下步骤适配，如果未适配。不会导致运行异常或者崩溃等情况，但是会一定程度上影响广告收入。敬请知悉。
1. 应用编译环境升级至 Xcode 12.0 及以上版本；
2. 升级ADSuyiSDK 3.1.5及以上版本；
3. 设置SKAdNetwork和IDFA权限；
### 3.2.1 获取App Tracking Transparency授权（弹窗授权获取IDFA）
从 iOS 14 开始，在应用程序调用 App Tracking Transparency 向用户提跟踪授权请求之前，IDFA 将不可用。
1. 更新 Info.plist，添加 NSUserTrackingUsageDescription 字段和自定义文案描述。
弹窗小字文案建议：
- `获取标记权限向您提供更优质、安全的个性化服务及内容，未经同意我们不会用于其他目的；开启后，您也可以前往系统“设置-隐私 ”中随时关闭。`
- `获取IDFA标记权限向您提供更优质、安全的个性化服务及内容；开启后，您也可以前往系统“设置-隐私 ”中随时关闭。`
```objective-c
NSUserTrackingUsageDescription
获取标记权限向您提供更优质、安全的个性化服务及内容，未经同意我们不会用于其他目的；开启后，您也可以前往系统“设置-隐私 ”中随时关闭
```
2. 向用户申请权限。
```objective-c
#import
#import
...
- (void)requestIDFA {
[ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {
// 无需对授权状态进行处理
}];
}
// 建议启动App用户同意协议后就获取权限或者请求广告前获取
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// 针对iOS15中不弹窗被拒解决方案，方案1：经测试可能无效
//dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(1.0 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
// 用户同意协议后获取
//[self requestIDFA];
//});
}
// 方案2：根据官方文档调整权限申请时机
// 根据官方开发文档选择在此方法中进行权限申请
- (void)applicationDidBecomeActive:(UIApplication *)application {
// 用户同意协议后获取
[self requestIDFA];
}
// 建议方案1与2一起使用，可正常通过审核。
```
### 3.2.2 SKAdNetwork
SKAdNetwork 是接收iOS端营销推广活动归因数据的一种方法。
1. 将下列SKAdNetwork ID 添加到 info.plist 中，以保证 SKAdNetwork 的正确运行。根据对接平台添加相应SKAdNetworkID，若无对接平台SKNetworkID则无需添加。
```xml
SKAdNetworkItems
// 穿山甲广告（ADSuyiBU）
SKAdNetworkIdentifier
238da6jt44.skadnetwork
SKAdNetworkIdentifier
22mmun2rn5.skadnetwork
SKAdNetworkIdentifier
x2jnk7ly8j.skadnetwork
// 优量汇广告（ADSuyiGDT）
SKAdNetworkIdentifier
f7s53z58qe.skadnetwork
// 汇量广告（ADSuyiMTG）
SKAdNetworkIdentifier
KBD757YWX3.skadnetwork
// 汇量广告 合作伙伴（ADSuyiMTG）
SKAdNetworkIdentifier
wg4vff78zm.skadnetwork
SKAdNetworkIdentifier
737z793b9f.skadnetwork
SKAdNetworkIdentifier
ydx93a7ass.skadnetwork
SKAdNetworkIdentifier
prcb7njmu6.skadnetwork
SKAdNetworkIdentifier
7UG5ZH24HU.skadnetwork
SKAdNetworkIdentifier
44jx6755aq.skadnetwork
SKAdNetworkIdentifier
2U9PT9HC89.skadnetwork
SKAdNetworkIdentifier
W9Q455WK68.skadnetwork
SKAdNetworkIdentifier
YCLNXRL5PM.skadnetwork
SKAdNetworkIdentifier
TL55SBB4FM.skadnetwork
SKAdNetworkIdentifier
8s468mfl3y.skadnetwork
SKAdNetworkIdentifier
GLQZH8VGBY.skadnetwork
SKAdNetworkIdentifier
c6k4g5qg8m.skadnetwork
SKAdNetworkIdentifier
mlmmfzh3r3.skadnetwork
SKAdNetworkIdentifier
4PFYVQ9L8R.skadnetwork
SKAdNetworkIdentifier
av6w8kgt66.skadnetwork
SKAdNetworkIdentifier
6xzpu9s2p8.skadnetwork
SKAdNetworkIdentifier
hs6bdukanm.skadnetwork
```
## 4.1 集合SDK的初始化
`申请的appid必须与您的包名一一对应`
```obj-c
// ADSuyiSDK初始化
[ADSuyiSDK initWithAppId:@"3427764" completionBlock:^(NSError * _Nonnull error) {
if (error) {
NSLog(@"SDK 初始化失败：%@", error.localizedDescription);
}
}];
```
用户日志输出等级
```obj-c
// 设置日志输出等级
[ADSuyiSDK setLogLevel:ADSuyiKitLogLevelDebug];
```
获取ADSuyiSDK版本号
```obj-c
//获取SDK版本号
NSString *sdkVersion = [ADSuyiSDK getSDKVersion];
```
## 4.2 开屏广告 - ADSuyiSDKSplashAd
开屏广告会在您的应用开启时加载展示，拥有固定展示时间，展示完毕后自动关闭并进入您的应用主界面。
开屏广告建议在闪屏页进行展示，开屏广告的宽度和高度取决于容器的宽高，都是会撑满广告容器；**开屏广告的高度必须大于等于屏幕高度（手机屏幕完整高度，包括状态栏之类）的75%**，否则可能会影响收益计费。
推荐在 `AppDelegate`的 `didFinishLaunchingWithOptions`方法的 `return YES`之前调用开屏。
`OC请求开屏代码示例：`[[开屏代码示例]](https://github.com/ADSuyi/ADSuyiSDKDemo-iOS/blob/master/ADSuyiSDKDemo-iOS/AppDelegate.m)
`Swift请求开屏代码示例：`[[开屏代码示例]](https://github.com/ADSuyi/ADSuyiSDKDemo-iOS-Swift/blob/master/ADSuyiSDKDemo-iOS-Swift/AppDelegate.swift)
开屏广告 - ADSuyiSDKSplashAd：
```obj-c
@interface ADSuyiSDKSplashAd : NSObject
/**
开屏的默认背景色,或者启动页,为nil则代表透明
*/
@property (nonatomic, copy, nullable) UIColor *backgroundColor;
/*
viewControllerForPresentingModalView
详解：[必选]开发者需传入用来弹出目标页的ViewController，一般为当前ViewController
*/
@property (nonatomic, weak) UIViewController *controller;
/**
广告位id
*/
@property (nonatomic, copy) NSString *posId;
/**
代理回调
*/
@property (nonatomic, weak) id delegate;
/**
开屏请求总超时时间:所有平台轮询的请求等待总时长（不包括图片渲染时间），单位秒，推荐设置为4s，最小值为3s
开屏各平台分配逻辑:(目前只有开屏需要分配时间，并且理论上分配给到各平台的超时时间不会完全耗尽)
1、3<=tolerateTimeout<=4:轮询首位平台的超时时间为(tolerateTimeout-1)s，次位为2s，如果后续还有平台统一为1s;
2、tolerateTimeout>=5:轮询首位平台的超时时间为(tolerateTimeout-2)s，次位为3s，如果后续还有平台统一为2s;
*/
@property (nonatomic, assign) NSInteger tolerateTimeout;
/**
跳过按钮的类型，可以通过此接口替换开屏广告的跳过按钮样式
*/
@property (nonatomic, strong, null_resettable) UIView *skipView;
/**
是否使用右下角跳过按钮，默认为右上角（仅针对穿山甲<头条>平台生效）
*/
@property (nonatomic, assign) BOOL needBottomSkipButton;
/**
设置保底开屏 （可选）
（App初次启动及suyiSDK未初始化状态保证开屏填充，支持平台：穿山甲、优量汇、快手、百度）
@param suyiId suyi平台广告源id
@param platformListId admobile后台配置查看networkAdPosListID
@param appId 广告平台AppId，非suyiAPPid
@param appKey 广告平台AppKey,没有传nil
@param platformPosid 三方广告平台广告位id
@param renderType 平台广告类型，如：原生，模板等。
*/
- (void)setBottomSplashWithSuyiPosid:(NSString *)suyiId platformListId:(NSString *)platformListId platform:(NSString *)platform appId:(NSString *)appId appKey:(nullable NSString *)appKey platformPosid:(NSString *)platformPosid renderType:(ADSuyiSplashRenderType)renderType;
/**
加载开屏广告
@param window 开屏广告展示的window
@param bottomView 底部logo视图, 高度不能超过屏幕的25%, 建议: 开屏的广告图片默认640 / 960比例, 可以用 MIN(screenHeight - screenWidth * (960 / 640.0), screenHeight * 0.25) 得出bottomview的高度
*/
- (void)loadAndShowInWindow:(UIWindow *)window withBottomView:(nullable UIView *)bottomView;
/**
加载开屏广告
@param window 开屏广告展示的window
*/
- (void)loadAndShowInWindow:(UIWindow *)window;
@end
```
开屏广告代理回调 - ADSuyiSDKSplashAdDelegate,ADSuyiSDKSplashAdZoomOutViewDelegate
```obj-c
@protocol ADSuyiSDKSplashAdDelegate
@optional
/**
开屏展现成功
@param splashAd 广告实例
*/
- (void)adsy_splashAdSuccessToPresentScreen:(ADSuyiSDKSplashAd *)splashAd;
/**
开屏展现失败
@param splashAd 广告实例
@param error 具体错误信息
*/
- (void)adsy_splashAdFailToPresentScreen:(ADSuyiSDKSplashAd *)splashAd failToPresentScreen:(ADSuyiAdapterErrorDefine *)error;
/**
开屏广告点击
@param splashAd 广告实例
*/
- (void)adsy_splashAdClicked:(ADSuyiSDKSplashAd *)splashAd;
/**
开屏被关闭
@param splashAd 广告实例
*/
- (void)adsy_splashAdClosed:(ADSuyiSDKSplashAd *)splashAd;
/**
开屏展示
@param splashAd 广告实例
*/
- (void)adsy_splashAdEffective:(ADSuyiSDKSplashAd *)splashAd;
@end
@protocol ADSuyiSDKSplashAdZoomOutViewDelegate
@optional
/**
ZoomOutView被点击
@param splashAd 广告实例
@param splashZoomOutView zoomOutView
*/
- (void)adsy_splashZoomOutViewDidClick:(ADSuyiSDKSplashAd *)splashAd
splashZoomOutView:(__kindof UIView *)splashZoomOutView;
/**
ZoomOutView 被关闭
@param splashAd 广告实例
@param splashZoomOutView zoomOutView
*/
- (void)adsy_splashZoomOutViewAdDidClose:(ADSuyiSDKSplashAd *)splashAd
splashZoomOutView:(__kindof UIView *)splashZoomOutView;
/**
ZoomOutView 播放完成
@param splashAd 广告实例
@param splashZoomOutView zoomOutView
*/
- (void)adsy_splashZoomOutViewAdVideoFinished:(ADSuyiSDKSplashAd *)splashAd
splashZoomOutView:(__kindof UIView *)splashZoomOutView;
/**
ZoomOutView 进入视频详情页
@param splashAd 广告实例
@param splashZoomOutView zoomOutView
*/
- (void)adsy_splashZoomOutViewAdDidPresentFullScreenModal:(ADSuyiSDKSplashAd *)splashAd
splashZoomOutView:(__kindof UIView *)splashZoomOutView;
/**
ZoomOutView 退出视频详情页
@param splashAd 广告实例
@param splashZoomOutView zoomOutView
*/
- (void)adsy_splashZoomOutViewAdDidDismissFullScreenModal:(ADSuyiSDKSplashAd *)splashAd
splashZoomOutView:(__kindof UIView *)splashZoomOutView;
@end
```
Swift请求开屏广告代码示例：[[开屏代码示例]](https://github.com/ADSuyi/ADSuyiSDKDemo-iOS-Swift/blob/master/ADSuyiSDKDemo-iOS-Swift/AppDelegate.swift)
OC请求开屏广告代码示例：
```obj-c
#import
#import
/*
* 推荐在AppDelegate中的最后加载开屏广告
* 其他的接入方式会有需要特殊注意的方式，遇到过的相关问题在SDK相关问题的文档中有提到
* 不建议在开屏展示过程中做控制器的切换（如：开屏广告关闭回调时切换当前window的根控制器或者present另外一个控制器）
* SUPPORT_SPLASH_ZOOMOUT，是否需要支持V+视频开屏广告取决于开发者，不选择v+开屏则可以不去适配
*/
- (void)loadSplashAd{
// 1、初始化开屏广告实例对象
self.splashAd = [[ADSuyiSDKSplashAd alloc]init];
self.splashAd.delegate = self;
#ifdef SUPPORT_SPLASH_ZOOMOUT
self.splashAd.zoomOutViewDelegate = self;
#endif
self.splashAd.controller = _window.rootViewController;
// 2、设置开屏的广告位id
self.splashAd.posId = @"d11c2ef29dcb7e6e62";
// 3、设置是否使用右下角跳过按钮，默认为右上角（仅针对穿山甲<头条>平台生效）
self.splashAd.needBottomSkipButton = YES;
/**
开屏请求总超时时间:所有平台轮询的请求等待总时长（不包括图片渲染时间），单位秒，推荐设置为4s，最小值为3s
开屏各平台分配逻辑:(目前只有开屏需要分配时间，并且理论上分配给到各平台的超时时间不会完全耗尽)
1、3<=tolerateTimeout<=4:轮询首位平台的超时时间为(tolerateTimeout-1)s，次位为2s，如果后续还有平台统一为1s;
2、tolerateTimeout>=5:轮询首位平台的超时时间为(tolerateTimeout-2)s，次位为3s，如果后续还有平台统一为2s;
*/
self.splashAd.tolerateTimeout = 4;
// 4、设置默认启动图(一般设置启动图的平铺颜色为背景颜色，使得视觉效果更加平滑)
self.splashAd.backgroundColor = [UIColor adsy_getColorWithImage:[UIImage imageNamed:@"750x1334.png"] withNewSize:[UIScreen mainScreen].bounds.size];
// 5、开屏广告机型适配
CGFloat bottomViewHeight;
if (kADSYCurveScreen) { // 刘海屏
bottomViewHeight = [UIScreen mainScreen].bounds.size.height * 0.15;
} else {
bottomViewHeight = [UIScreen mainScreen].bounds.size.height - [UIScreen mainScreen].bounds.size.width * (960 / 640.0);
}
// 6、底部视图设置，非必选项
UIView *bottomView = [[UIView alloc] init];
bottomView.backgroundColor = [UIColor whiteColor];
bottomView.frame = CGRectMake(0, 0, [UIScreen mainScreen].bounds.size.width, bottomViewHeight);
UIImageView *logoImageView = [[UIImageView alloc]initWithImage:[UIImage imageNamed:@"ADMob_Logo.png"]];
logoImageView.frame = CGRectMake(([UIScreen mainScreen].bounds.size.width-135)/2, (bottomViewHeight-46)/2, 135, 46);
[bottomView addSubview:logoImageView];
// 7、设置开屏保底逻辑（可选）
/**
*功能说明：App在首次启动时，需要先请求获取广告位配置文件后，然后再去请求开屏广告，也就是首次加载开屏广告时需要两次串行网络请求，因此很容易因超时导致开屏广告展示失败。
*解决方案：为避免开屏超时问题，开放此设置给开发者，开发者可以根据实际需求选择一家广告平台，通过API接口将必需参数传递给Suyi聚合SDK。（该设置只能指定一家广告平台，并且首次启动时只会请求该平台的广告，但App首次开屏广告将不受ADmobile后台控制，包括下载提示，广告位关闭。）
*该设置仅会在首次加载开屏广告时，SDK会使用开发者传入的参数进行广告请求，同时获取后台配置文件的广告配置信息缓存到本地（首次请求广告平台广告和获取配置信息时并发进行），后续的开屏广告将按照缓存缓存的后台广告位配置顺序进行开屏广告请求。
*支持穿山甲、优量汇、快手、百度、汇量
*/
[self.splashAd setBottomSplashWithSuyiPosid:@"73128265daffdd6a1d" platformListId:@"3827" platform:@"ksad" appId:@"90010" appKey:nil platformPosid:@"4000000041" renderType:ADSuyiSplashRenderTypeExpressPro];
// 8、加载开屏广告
[self.splashAd loadAndShowInWindow:_window withBottomView:bottomView];
}
// 9、代理回调
#pragma mark - ADSuyiSDKSplashAdDelegate
/**
开屏展现成功
@param splashAd 广告实例
*/
- (void)adsy_splashAdSuccessToPresentScreen:(ADSuyiSDKSplashAd *)splashAd{
#ifdef SUPPORT_SPLASH_ZOOMOUT
if(splashAd.splashZoomOutView) {
UIViewController *rootVc = [UIApplication sharedApplication].keyWindow.rootViewController;
[rootVc.view addSubview:splashAd.splashZoomOutView];
}
#endif
}
/**
开屏展现失败
@param splashAd 广告实例
@param error 具体错误信息
*/
- (void)adsy_splashAdFailToPresentScreen:(ADSuyiSDKSplashAd *)splashAd failToPresentScreen:(ADSuyiAdapterErrorDefine *)error{
_splashAd = nil;
}
/**
开屏广告点击
@param splashAd 广告实例
*/
- (void)adsy_splashAdClicked:(ADSuyiSDKSplashAd *)splashAd{
}
/**
开屏被关闭
@param splashAd 广告实例
*/
- (void)adsy_splashAdClosed:(ADSuyiSDKSplashAd *)splashAd{
#ifdef SUPPORT_SPLASH_ZOOMOUT
if(_splashAd.splashZoomOutView == nil)
_splashAd = nil;
#else
_splashAd = nil;
#endif
}
/**
开屏展示
@param splashAd 广告实例
*/
- (void)adsy_splashAdEffective:(ADSuyiSDKSplashAd *)splashAd{
}
#ifdef SUPPORT_SPLASH_ZOOMOUT
#pragma mark - ADSuyiSDKSplashAdZoomOutViewDelegate
/**
ZoomOutView被点击
*/
- (void)adsy_splashZoomOutViewDidClick:(ADSuyiSDKSplashAd *)splashAd
splashZoomOutView:(__kindof UIView *)splashZoomOutView {
}
/**
ZoomOutView 被关闭
*/
- (void)adsy_splashZoomOutViewAdDidClose:(ADSuyiSDKSplashAd *)splashAd
splashZoomOutView:(__kindof UIView *)splashZoomOutView {
}
/**
ZoomOutView 播放完成
*/
- (void)adsy_splashZoomOutViewAdVideoFinished:(ADSuyiSDKSplashAd *)splashAd
splashZoomOutView:(__kindof UIView *)splashZoomOutView {
}
/**
ZoomOutView 进入视频详情页
*/
- (void)adsy_splashZoomOutViewAdDidPresentFullScreenModal:(ADSuyiSDKSplashAd *)splashAd
splashZoomOutView:(__kindof UIView *)splashZoomOutView {
}
/**
ZoomOutView 退出视频详情页
*/
- (void)adsy_splashZoomOutViewAdDidDismissFullScreenModal:(ADSuyiSDKSplashAd *)splashAd
splashZoomOutView:(__kindof UIView *)splashZoomOutView {
_splashAd = nil;
}
#endif
```
## 4.3 Banner横幅广告 - ADSuyiSDKBannerAdView
Banner广告(横幅广告)位于app顶部、中部、底部任意一处，横向贯穿整个app页面；当用户与app互动时，Banner广告会停留在屏幕上，并可在一段时间后自动刷新。
`OC请求横幅代码示例：`[[横幅代码示例]](https://github.com/ADSuyi/ADSuyiSDKDemo-iOS/blob/master/ADSuyiSDKDemo-iOS/SuyiAds/BannerAd/AdSuyiBannerViewController.m)
`Swift请求横幅代码示例：`[[横幅代码示例]](https://github.com/ADSuyi/ADSuyiSDKDemo-iOS-Swift/blob/master/ADSuyiSDKDemo-iOS-Swift/SuyiAds/BannerAd/ADSuyiBannerViewController.swift)
横幅广告 - ADSuyiSDKBannerAdView：
```obj-c
@interface ADSuyiSDKBannerAdView : UIView
/**
广告生命周期代理
*/
@property (nonatomic, weak) id delegate;
/**
广告位id
*/
@property (nonatomic, copy) NSString *posId;
/**
banner刷新时间间隔，30-120s之间.
*/
@property (nonatomic, assign) NSInteger refershTime;
/**
请求超时时间,默认为4s,需要设置3s及以上
*/
@property (nonatomic, assign) NSInteger tolerateTimeout;
/**
viewControllerForPresentingModalView
详解：[必选]开发者需传入用来弹出目标页的ViewController，一般为当前ViewController
*/
@property (nonatomic, weak) UIViewController *controller;
- (id)new NS_UNAVAILABLE;
- (id)init NS_UNAVAILABLE;
/*
初始化bannerView
@param frame 期望的banner视图尺寸
*/
- (instancetype)initWithFrame:(CGRect)frame;
/**
拉取并展示广告
*/
- (void)loadAndShow;
@end
```
横幅广告 - ADSuyiSDKBannerAdViewDelegate
```obj-c
@protocol ADSuyiSDKBannerAdViewDelegate
/**
广告获取成功
@param bannerView banner实例
*/
- (void)adsy_bannerViewDidReceived:(ADSuyiSDKBannerAdView *)bannerView;
/**
广告拉取失败
@param bannerView banner实例
@param errorModel 错误描述
*/
- (void)adsy_bannerViewFailToReceived:(ADSuyiSDKBannerAdView *)bannerView errorModel:(ADSuyiAdapterErrorDefine *)errorModel;
/**
广告点击
@param bannerView 广告实例
*/
- (void)adsy_bannerViewClicked:(ADSuyiSDKBannerAdView *)bannerView;
/**
广告关闭
@param bannerView 广告实例
*/
- (void)adsy_bannerViewClose:(ADSuyiSDKBannerAdView *)bannerView;
/**
广告展示
@param bannerView 广告实例
*/
- (void)adsy_bannerViewExposure:(ADSuyiSDKBannerAdView *)bannerView;
@end
```
Swift请求横幅代码示例：[[横幅代码示例]](https://github.com/ADSuyi/ADSuyiSDKDemo-iOS-Swift/blob/master/ADSuyiSDKDemo-iOS-Swift/SuyiAds/BannerAd/ADSuyiBannerViewController.swift)
OC请求横幅广告请求示例：
```obj-c
#import
- (void)loadBannerWithRate:(CGFloat)rate posId:(NSString *)posId {
[self.bannerView removeFromSuperview];
self.bannerView.delegate = nil;
self.bannerView = nil;
// 1、初始化banner视图，并给定frame值，rate取值根据banner的尺寸
self.bannerView = [[ADSuyiSDKBannerAdView alloc] initWithFrame:CGRectMake(0, 250, kADSYScreenWidth, kADSYScreenWidth / rate)];
self.bannerView.delegate = self;
// 2、设置控制器，用来弹出落地页，重要
self.bannerView.controller = self;
// 3、设置广告位id，重要
self.bannerView.posId = posId;
self.bannerView.refershTime = 30;
// 4、可先展示再请求
[self.view addSubview:self.bannerView];
self.bannerView.backgroundColor = [UIColor redColor];
// 5、加载并展示
[self.bannerView loadAndShow];
}
// 5、代理回调
#pragma mark - ADSuyiSDKBannerAdViewDelegate
/**
广告获取成功
@param bannerView banner实例
*/
- (void)adsy_bannerViewDidReceived:(ADSuyiSDKBannerAdView *)bannerView{
}
/**
广告拉取失败
@param bannerView banner实例
@param errorModel 错误描述
*/
- (void)adsy_bannerViewFailToReceived:(ADSuyiSDKBannerAdView *)bannerView errorModel:(ADSuyiAdapterErrorDefine *)errorModel{
NSLog(@"adsy_bannerViewFailToReceived:%@, %@",errorModel.errorDescription, errorModel.errorDetailDict);
[_bannerView removeFromSuperview];
_bannerView = nil;
}
/**
广告点击
@param bannerView 广告实例
*/
- (void)adsy_bannerViewClicked:(ADSuyiSDKBannerAdView *)bannerView{
}
/**
广告关闭
@param bannerView 广告实例
*/
- (void)adsy_bannerViewClose:(ADSuyiSDKBannerAdView *)bannerView{
_bannerView = nil;
}
/**
广告展示
@param bannerView 广告实例
*/
- (void)adsy_bannerViewExposure:(ADSuyiSDKBannerAdView *)bannerView{
}
```
## 4.4 信息流广告 - ADSuyiSDKNativeAd
信息流广告，具备自渲染和模板两种广告样式：自渲染是SDK将返回广告标题、描述、Icon、图片、多媒体视图等信息，开发者可通过自行拼装渲染成喜欢的样式；模板样式则是返回拼装好的广告视图，开发者只需将视图添加到相应容器即可，模板样式的容器高度建议是自适应。**请务必确保自渲染类型广告渲染时包含广告创意素材（至少包含一张图片）、平台logo、广告标识、关闭按钮；模板广告不得被遮挡。** **注意，信息流广告点击关闭时，开发者需要在- (void)adsy_nativeAdClose:回调中将广告视图隐藏或移除，避免如穿山甲渠道点击关闭后视图依旧存在问题**
`OC请求信息流广告代码示例：`[[信息流广告代码示例]](https://github.com/ADSuyi/ADSuyiSDKDemo-iOS/blob/master/ADSuyiSDKDemo-iOS/SuyiAds/NativeAd/AdSuyiNativeViewController.m)
`Swift请求信息流广告代码示例：`[[信息流广告代码示例]](https://github.com/ADSuyi/ADSuyiSDKDemo-iOS-Swift/blob/master/ADSuyiSDKDemo-iOS-Swift/SuyiAds/NativeAd/AdSuyiNativeViewController.swift)
信息流广告 - ADSuyiSDKNativeAd：
```obj-c
typedef NS_ENUM(NSUInteger, ADSuyiSDKNativeAdStatus) {
ADSuyiSDKNativeAdStatusDefault, // 闲置状态
ADSuyiSDKNativeAdStatusLoading, // 加载广告中
};
@protocol ADSuyiSDKNativeAdDelegate;
@class ADSuyiAdapterNativeAdDataObject;
@interface ADSuyiSDKNativeAd : NSObject
- (instancetype)new NS_UNAVAILABLE;
- (instancetype)init NS_UNAVAILABLE;
- (instancetype)initWithAdSize:(CGSize)adSize;
/*
viewControllerForPresentingModalView
详解：[必选]开发者需传入用来弹出目标页的ViewController，一般为当前ViewController
*/
@property (nonatomic, weak) UIViewController *controller;
/*
status
详解：开发者可通过状态值来判断当前广告对象是否正在加载广告，支持KVO
*/
@property (nonatomic, assign, readonly) ADSuyiSDKNativeAdStatus status;
/**
代理回调
*/
@property (nonatomic, weak) id delegate;
/**
广告位id
*/
@property (nonatomic, copy) NSString *posId;
/**
请求超时时间,默认为4s,需要设置3s及以上
*/
@property (nonatomic, assign) NSInteger tolerateTimeout;
/**
加载广告
@param count 拉取几条广告,建议区间 1~5, 超过可能无法拉取到
*/
- (void)load:(int)count;
@end
```
信息流广告代理回调 - ADSuyiSDKNativeAdDelegate
```obj-c
/**
信息流广告请求成功
@param nativeAd 广告实例
@param adViewArray 广告模板集合
*/
- (void)adsy_nativeAdSucessToLoad:(ADSuyiSDKNativeAd *)nativeAd
adViewArray:(NSArray<__kindof UIView *> *)adViewArray;
/**
信息流广告请求失败
@param nativeAd 广告实例
@param errorModel 请求错误描述
*/
- (void)adsy_nativeAdFailToLoad:(ADSuyiSDKNativeAd *)nativeAd
errorModel:(ADSuyiAdapterErrorDefine *)errorModel;
/**
信息流广告渲染成功
@param adView 广告视图
*/
- (void)adsy_nativeAdViewRenderOrRegistSuccess:(UIView *)adView;
/**
信息流广告渲染失败
@param adView 广告视图
*/
- (void)adsy_nativeAdViewRenderOrRegistFail:(UIView *)adView;
/**
信息流广告被点击
@param nativeAd 广告模板
*/
- (void)adsy_nativeAdClicked:(ADSuyiSDKNativeAd *)nativeAd
adView:(__kindof UIView *)adView;
/**
信息流广告被关闭
@param nativeAd 广告模板
*/
- (void)adsy_nativeAdClose:(ADSuyiSDKNativeAd *)nativeAd
adView:(__kindof UIView *)adView;
/**
信息流广告被展示
@param nativeAd 广告实例
*/
- (void)adsy_nativeAdExposure:(ADSuyiSDKNativeAd *)nativeAd
adView:(__kindof UIView *)adView;
@end
```
Swift请求信息流广告代码示例：[[信息流广告代码示例]](https://github.com/ADSuyi/ADSuyiSDKDemo-iOS-Swift/blob/master/ADSuyiSDKDemo-iOS-Swift/SuyiAds/NativeAd/AdSuyiNativeViewController.swift)
OC请求信息流广告请求示例：
```obj-c
#import
if(!_nativeAd) {
// 1、信息流广告初始化
_nativeAd = [[ADSuyiSDKNativeAd alloc] initWithAdSize:CGSizeMake(self.tableView.frame.size.width, 10)];
// 2、传入posId，重要
_nativeAd.posId = self.posId;
_nativeAd.delegate = self;
_nativeAd.controller = self;
}
// 3、加载信息流广告
[_nativeAd load:1];
// 4、代理回调
#pragma mark - ADSuyiSDKNativeAdDelegate
- (void)adsy_nativeAdSucessToLoad:(ADSuyiSDKNativeAd *)nativeAd
adViewArray:(NSArray<__kindof UIView *> *)adViewArray {
for (UIView *adView in adViewArray) {
// 4、判断信息流广告是否为自渲染类型
if(adView.renderType == ADSuyiAdapterRenderTypeNative) {
// 4.1、如果是自渲染类型则可样式自定义
[self setUpUnifiedNativeAdView:adView];
}
// 5、注册，自渲染：注册点击事件，模板：render，重要
[adView adsy_registViews:@[adView]];
}
[self.tableView.mj_header endRefreshing];
[self.tableView.mj_footer endRefreshing];
}
// 渲染成功回调
- (void)adsy_nativeAdViewRenderOrRegistSuccess:(UIView *)adView {
// 6、注册或渲染成功，此时高度正常，可以展示
dispatch_async(dispatch_get_main_queue(), ^{
for (int i = 0; i < 6; i ++) {
[self.items addObject:[NSNull null]];
}
[self.items addObject:adView];
[self.tableView reloadData];
});
}
- (void)adsy_nativeAdClose:(ADSuyiSDKNativeAd *)nativeAd
adView:(__kindof UIView *)adView {
for (id item in _items) {
if(item == adView) {
dispatch_async(dispatch_get_main_queue(), ^{
[adView adsy_unRegistView];
[self.items removeObject:adView];
[self.tableView reloadData];
});
}
}
}
```
## 4.5 激励视频广告 - ADSuyiSDKRewardvodAd
将短视频融入到APP场景当中，用户观看短视频广告后可以给予一些应用内奖励。常出现在游戏的复活、任务等位置，或者网服类APP的一些增值服务场景。
`OC请求激励视频代码示例：`[[激励视频广告代码示例]](https://github.com/ADSuyi/ADSuyiSDKDemo-iOS/blob/master/ADSuyiSDKDemo-iOS/SuyiAds/RewardVodAd/AdSuyiRewardvodViewController.m)
`Swift请求激励视频代码示例：`[[激励视频广告代码示例]](https://github.com/ADSuyi/ADSuyiSDKDemo-iOS-Swift/blob/master/ADSuyiSDKDemo-iOS-Swift/SuyiAds/RewardAd/AdSuyiRewardViewController.swift)
激励视频广告 - ADSuyiSDKRewardvodAd：
```obj-c
@interface ADSuyiSDKRewardvodAd : NSObject
/*
viewControllerForPresentingModalView
详解：[必选]开发者需传入用来弹出目标页的ViewController，一般为当前ViewController
*/
@property (nonatomic, weak) UIViewController *controller;
/**
请求超时时间,默认为4s,需要设置3s及以上
*/
@property (nonatomic, assign) NSInteger tolerateTimeout;
/**
广告位id
*/
@property (nonatomic, copy) NSString *posId;
/**
场景id
*/
@property (nonatomic, copy, nullable) NSString *scenesId;
/**
用户id （用户在App内的userID，用于激励视频服务器验证，如无需服务器验证可不传）
*/
@property (nonatomic, copy, nullable) NSString *userId;
/**
奖励名称 （用于激励视频服务器验证参数，可选）
*/
@property (nonatomic, copy, nullable) NSString *rewardName;
/**
奖励数量 （用于激励视频服务器验证参数，可选）
*/
@property (nonatomic, assign,nullable) NSNumber *rewardAmount;
/**
其他信息 （服务器端验证回调中包含的可选自定义奖励字符串，可选）
*/
@property (nonatomic, copy, nullable) NSString *extraInfo;
/**
代理回调
*/
@property (nonatomic, weak) id delegate;
/**
加载激励视频广告
*/
- (void)loadRewardvodAd;
/**
激励视频广告是否支持服务端验证
*/
- (BOOL)rewardvodAdCanServerVerrify;
/**
激励视频广告是否准备好
*/
- (BOOL)rewardvodAdIsReady;
/**
激励视频广告物料是否有效
*/
- (BOOL)rewardvodAdIsValid;
/**
展示激励视频广告
*/
- (void)showRewardvodAd;
@end
```
激励视频广告代理回调 - ADSuyiSDKRewardvodAdDelegate
```obj-c
@protocol ADSuyiSDKRewardvodAdDelegate
/**
广告数据加载成功回调
@param rewardvodAd 广告实例
*/
- (void)adsy_rewardvodAdLoadSuccess:(ADSuyiSDKRewardvodAd *)rewardvodAd;
/**
激励视频广告准备好被播放
@param rewardvodAd 广告实例
*/
- (void)adsy_rewardvodAdReadyToPlay:(ADSuyiSDKRewardvodAd *)rewardvodAd;
/**
视频数据下载成功回调，已经下载过的视频会直接回调
@param rewardvodAd 广告实例
*/
- (void)adsy_rewardvodAdVideoLoadSuccess:(ADSuyiSDKRewardvodAd *)rewardvodAd;
/**
视频播放页即将展示回调
@param rewardvodAd 广告实例
*/
- (void)adsy_rewardvodAdWillVisible:(ADSuyiSDKRewardvodAd *)rewardvodAd;
/**
视频广告曝光回调
@param rewardvodAd 广告实例
*/
- (void)adsy_rewardvodAdDidVisible:(ADSuyiSDKRewardvodAd *)rewardvodAd;
/**
视频播放页关闭回调
@param rewardvodAd 广告实例
*/
- (void)adsy_rewardvodAdDidClose:(ADSuyiSDKRewardvodAd *)rewardvodAd;
/**
视频广告信息点击回调
@param rewardvodAd 广告实例
*/
- (void)adsy_rewardvodAdDidClick:(ADSuyiSDKRewardvodAd *)rewardvodAd;
/**
视频广告视频播放完成
@param rewardvodAd 广告实例
*/
- (void)adsy_rewardvodAdDidPlayFinish:(ADSuyiSDKRewardvodAd *)rewardvodAd;
/**
视频广告视频达到奖励条件 （开启服务器验证后请使用服务端验证判断是否达到条件，无需使用本回调做激励达成判断）
@param rewardvodAd 广告实例
*/
- (void)adsy_rewardvodAdDidRewardEffective:(ADSuyiSDKRewardvodAd *)rewardvodAd;
/**
视频广告请求失败回调
@param rewardvodAd 广告实例
@param errorModel 具体错误信息
*/
- (void)adsy_rewardvodAdFailToLoad:(ADSuyiSDKRewardvodAd *)rewardvodAd errorModel:(ADSuyiAdapterErrorDefine *)errorModel;
/**
视频广告播放时各种错误回调
@param rewardvodAd 广告实例
@param errorModel 具体错误信息
*/
- (void)adsy_rewardvodAdPlaying:(ADSuyiSDKRewardvodAd *)rewardvodAd errorModel:(ADSuyiAdapterErrorDefine *)errorModel;
/**
视频广告激励服务验证成功（需等待服务器返回结果后判断是否激励生效）
@param rewardvodAd 广告实例
*/
- (void)adsy_rewardvodAdServerDidSucceed:(ADSuyiSDKRewardvodAd *)rewardvodAd;
/**
视频广告完成激励服务验证失败
@param rewardvodAd 广告实例
@param errorModel 认证失败错误信息
*/
- (void)adsy_rewardvodAdServerDidFailed:(ADSuyiSDKRewardvodAd *)rewardvodAd errorModel:(ADSuyiAdapterErrorDefine *)errorModel;
@end
```
Swift请求激励视频代码示例：[[激励视频广告代码示例]](https://github.com/ADSuyi/ADSuyiSDKDemo-iOS-Swift/blob/master/ADSuyiSDKDemo-iOS-Swift/SuyiAds/RewardAd/AdSuyiRewardViewController.swift)
OC请求激励视频代码示例：
```obj-c
#import
- (void)loadRewardvodAd{
// 1、初始化激励视频广告
self.rewardvodAd = [[ADSuyiSDKRewardvodAd alloc]init];
self.rewardvodAd.delegate = self;
self.rewardvodAd.tolerateTimeout = 5;
self.rewardvodAd.controller = self;
self.rewardvodAd.posId = @"e9e0f8d1fe21873695";
// 以下参数如不需服务端验证可不传
self.rewardvodAd.userId = @"xxx";
self.rewardvodAd.extraInfo = @"这是一个激励视频生效验证";
self.rewardvodAd.rewardName = @"看视频得金币";
self.rewardvodAd.rewardAmount = [NSNumber numberWithInt:2];
// 2、加载激励视频广告
[self.rewardvodAd loadRewardvodAd];
}
/**
激励视频广告准备好被播放
@param rewardvodAd 广告实例
*/
- (void)adsy_rewardvodAdReadyToPlay:(ADSuyiSDKRewardvodAd *)rewardvodAd{
// 3、推荐在准备好被播放回调中展示激励视频广告
if ([self.rewardvodAd rewardvodAdIsReady]) {
[self.rewardvodAd showRewardvodAd];
}
}
/**
视频播放页关闭回调
@param rewardvodAd 广告实例
*/
- (void)adsy_rewardvodAdDidClose:(ADSuyiSDKRewardvodAd *)rewardvodAd{
// 4、广告内存回收
_rewardvodAd = nil;
}
/**
视频广告请求失败回调
@param rewardvodAd 广告实例
@param errorModel 具体错误信息
*/
- (void)adsy_rewardvodAdFailToLoad:(ADSuyiSDKRewardvodAd *)rewardvodAd errorModel:(ADSuyiAdapterErrorDefine *)errorModel{
// 4、广告内存回收
_rewardvodAd = nil;
}
/**
视频广告发送服务端验证成功回调
@param rewardvodAd 广告实例
*/
- (void)adsy_rewardvodAdServerDidSucceed:(ADSuyiSDKRewardvodAd *)rewardvodAd {
}
/**
视频广告发送服务端验证请求失败回调
@param rewardvodAd 广告实例
@param errorModel 具体错误信息
*/
- (void)adsy_rewardvodAdServerDidFailed:(ADSuyiSDKRewardvodAd *)rewardvodAd errorModel:(ADSuyiAdapterErrorDefine *)errorModel {
}
```
## 4.6 插屏广告 - ADSuyiSDKIntertitialAd
插屏广告是移动广告的一种常见形式，在应用流程中弹出，当应用展示插屏广告时，用户可以选择点击广告，访问其目标网址，也可以将其关闭并返回应用。在应用执行流程的自然停顿点，适合投放这类广告。
`OC请求插屏广告代码示例：`[[插屏广告代码示例]](https://github.com/ADSuyi/ADSuyiSDKDemo-iOS/blob/master/ADSuyiSDKDemo-iOS/SuyiAds/InterstitialAd/AdSuyiInterstitialViewController.m)
`Swift请求插屏广告代码示例：`[[插屏广告代码示例]](https://github.com/ADSuyi/ADSuyiSDKDemo-iOS-Swift/blob/master/ADSuyiSDKDemo-iOS-Swift/SuyiAds/InterstitialAd/AdSuyiInterstitialViewController.swift)
插屏广告 - ADSuyiSDKIntertitialAd：
```obj-c
@interface ADSuyiSDKIntertitialAd : NSObject
/**
代理回调
*/
@property (nonatomic, weak) id delegate;
/*
viewControllerForPresentingModalView
详解：[必选]开发者需传入用来弹出目标页的ViewController，一般为当前ViewController
*/
@property (nonatomic, weak) UIViewController *controller;
/**
请求超时时间,默认为4s,需要设置3s及以上
*/
@property (nonatomic, assign) NSInteger tolerateTimeout;
/**
广告位id
*/
@property (nonatomic, copy) NSString *posId;
/**
加载广告数据
*/
- (void)loadAdData;
/**
展示广告
*/
- (void)show;
@end
```
插屏广告代理回调 - ADSuyiSDKIntertitialAdDelegate
```obj-c
@protocol ADSuyiSDKIntertitialAdDelegate
/**
ADSuyiSDKIntertitialAd请求成功回调
@param interstitialAd 插屏广告实例对象
*/
- (void)adsy_interstitialAdSuccedToLoad:(ADSuyiSDKIntertitialAd *)interstitialAd;
/**
ADSuyiSDKIntertitialAd请求失败回调
@param interstitialAd 插屏广告实例对象
@param error 失败原因
*/
- (void)adsy_interstitialAdFailedToLoad:(ADSuyiSDKIntertitialAd *)interstitialAd error:(ADSuyiAdapterErrorDefine *)error;
/**
ADSuyiSDKIntertitialAd展示在屏幕内回调
@param interstitialAd 插屏广告实例对象
*/
- (void)adsy_interstitialAdDidPresent:(ADSuyiSDKIntertitialAd *)interstitialAd;
/**
ADSuyiSDKIntertitialAd展示在屏幕内失败回调
@param interstitialAd 插屏广告实例对象
*/
- (void)adsy_interstitialAdFailedToPresent:(ADSuyiSDKIntertitialAd *)interstitialAd error:(NSError *)error;
/**
ADSuyiSDKIntertitialAd点击回调
@param interstitialAd 插屏广告实例对象
*/
- (void)adsy_interstitialAdDidClick:(ADSuyiSDKIntertitialAd *)interstitialAd;
/**
ADSuyiSDKIntertitialAd关闭回调
@param interstitialAd 插屏广告实例对象
*/
- (void)adsy_interstitialAdDidClose:(ADSuyiSDKIntertitialAd *)interstitialAd;
/**
ADSuyiSDKIntertitialAd展示回调
@param interstitialAd 广告实例
*/
- (void)adsy_interstitialAdExposure:(ADSuyiSDKIntertitialAd *)interstitialAd;
@end
```
Swift请求插屏代码示例：[[插屏广告代码示例]](https://github.com/ADSuyi/ADSuyiSDKDemo-iOS-Swift/blob/master/ADSuyiSDKDemo-iOS-Swift/SuyiAds/InterstitialAd/AdSuyiInterstitialViewController.swift)
OC请求插屏代码示例：
```obj-c
#import
- (void)loadInterstitialAd{
// 1、初始化插屏广告
self.intertitialAd = [ADSuyiSDKIntertitialAd new];
self.intertitialAd.controller = self;
self.intertitialAd.posId = @"1fbfbb9778d168e5a7";
self.intertitialAd.delegate = self;
self.intertitialAd.tolerateTimeout = 4;
// 2、加载插屏广告
[self.intertitialAd loadAdData];
}
#pragma mark - ADSuyiSDKIntertitialAdDelegate
/**
ADSuyiSDKIntertitialAd请求成功回调
@param interstitialAd 插屏广告实例对象
*/
- (void)adsy_interstitialAdSuccedToLoad:(ADSuyiSDKIntertitialAd *)interstitialAd{
// 3、展示插屏广告
[self.intertitialAd show];
}
/**
ADSuyiSDKIntertitialAd请求失败回调
@param interstitialAd 插屏广告实例对象
@param error 失败原因
*/
- (void)adsy_interstitialAdFailedToLoad:(ADSuyiSDKIntertitialAd *)interstitialAd error:(ADSuyiAdapterErrorDefine *)error{
// 4、内存回收
_intertitialAd = nil;
}
/**
ADSuyiSDKIntertitialAd关闭回调
@param interstitialAd 插屏广告实例对象
*/
- (void)adsy_interstitialAdDidClose:(ADSuyiSDKIntertitialAd *)interstitialAd{
// 4、内存回收
_intertitialAd = nil;
}
```
## 4.7 全屏视频广告 - ADSuyiSDKFullScreenVodAd
类似激励视频，与激励视频不同的是，全屏视频广告在观看一定时长（通常为5s）后即可跳过广告，无需全部观看完成，有视频跳过回调，但是没有激励回调。
`OC请求全屏视频广告代码示例：`[[全屏视频广告代码示例]](https://github.com/ADSuyi/ADSuyiSDKDemo-iOS/blob/master/ADSuyiSDKDemo-iOS/SuyiAds/FullScreenVodAd/AdSuyiFullScreenvodViewController.m)
`Swift请求全屏视频广告代码示例：`[[全屏视频广告代码示例]](https://github.com/ADSuyi/ADSuyiSDKDemo-iOS-Swift/blob/master/ADSuyiSDKDemo-iOS-Swift/SuyiAds/FullScreenVodAd/AdSuyiFullScreenVodViewController.swift)
全屏视频广告 - ADSuyiSDKFullScreenVodAd：
```objective-c
@interface ADSuyiSDKFullScreenVodAd : NSObject
@property (nonatomic, weak) id delegate;
/*
viewControllerForPresentingModalView
详解：[必选]开发者需传入用来弹出目标页的ViewController，一般为当前ViewController
*/
@property (nonatomic, weak) UIViewController *controller;
/**
请求超时时间,默认为4s,需要设置3s及以上
*/
@property (nonatomic, assign) NSInteger tolerateTimeout;
/**
广告位id
*/
@property (nonatomic, copy) NSString *posId;
/**
加载广告
*/
- (void)loadAdData;
/**
展示广告
*/
- (void)show;
@end
```
全屏视频广告代理回调 - ADSuyiSDKFullScreenVodAdDelegate
```objective-c
@protocol ADSuyiSDKFullScreenVodAdDelegate
/**
ADSuyiSDKFullScreenVodAd请求成功回调
@param fullScreenVodAd 全屏视频广告实例对象
*/
- (void)adsy_fullScreenVodAdSuccedToLoad:(ADSuyiSDKFullScreenVodAd *)fullScreenVodAd;
/**
ADSuyiSDKFullScreenVodAd准备好被播放
@param fullScreenVodAd 全屏视频广告实例对象
*/
- (void)adsy_fullScreenVodAdReadyToPlay:(ADSuyiSDKFullScreenVodAd *)fullScreenVodAd;
/**
ADSuyiSDKFullScreenVodAd视频加载成功回调
@param fullScreenVodAd 全屏视频广告实例对象
*/
- (void)adsy_fullScreenVodAdSuccessToLoadVideo:(ADSuyiSDKFullScreenVodAd *)fullScreenVodAd;
/**
ADSuyiSDKFullScreenVodAd请求失败回调
@param fullScreenVodAd 全屏视频广告实例对象
@param error 失败原因
*/
- (void)adsy_fullScreenVodAdFailedToLoad:(ADSuyiSDKFullScreenVodAd *)fullScreenVodAd error:(ADSuyiAdapterErrorDefine *)error;
/**
ADSuyiSDKFullScreenVodAd展示在屏幕内回调
@param fullScreenVodAd 全屏视频广告实例对象
*/
- (void)adsy_fullScreenVodAdDidPresent:(ADSuyiSDKFullScreenVodAd *)fullScreenVodAd;
/**
ADSuyiSDKFullScreenVodAd展示失败回调
@param fullScreenVodAd 全屏视频广告实例对象
@param error 失败原因
*/
- (void)adsy_fullScreenVodAdFailToPresent:(ADSuyiSDKFullScreenVodAd *)fullScreenVodAd error:(NSError *)error;
/**
ADSuyiSDKFullScreenVodAd点击回调
@param fullScreenVodAd 全屏视频广告实例对象
*/
- (void)adsy_fullScreenVodAdDidClick:(ADSuyiSDKFullScreenVodAd *)fullScreenVodAd;
/**
ADSuyiSDKFullScreenVodAd关闭回调
@param fullScreenVodAd 全屏视频广告实例对象
*/
- (void)adsy_fullScreenVodAdDidClose:(ADSuyiSDKFullScreenVodAd *)fullScreenVodAd;
/**
ADSuyiSDKFullScreenVodAd展示回调
@param fullScreenVodAd 广告实例
*/
- (void)adsy_fullScreenVodAdExposure:(ADSuyiSDKFullScreenVodAd *)fullScreenVodAd;
/**
ADSuyiSDKFullScreenVodAd播放完成回调
@param fullScreenVodAd 广告实例
@param error 失败原因（如果为nil，则是单纯的播放完成）
*/
- (void)adsy_fullScreenVodAdPlayComplete:(ADSuyiSDKFullScreenVodAd *)fullScreenVodAd didFailed:(NSError *_Nullable)error;
@end
```
Swift请求全屏视频广告代码示例：[[全屏视频广告代码示例]](https://github.com/ADSuyi/ADSuyiSDKDemo-iOS-Swift/blob/master/ADSuyiSDKDemo-iOS-Swift/SuyiAds/FullScreenVodAd/AdSuyiFullScreenVodViewController.swift)
OC请求全屏视频广告代码示例：
```objective-c
#import
- (void)loadFullScreenvod{
// 1、初始化全屏视频广告
self.fullScreenvodAd = [ADSuyiSDKFullScreenVodAd new];
self.fullScreenvodAd.controller = self;
self.fullScreenvodAd.posId = @"7206088624654025e7";
self.fullScreenvodAd.delegate = self;
self.fullScreenvodAd.tolerateTimeout = 5;
// 2、加载全屏视频广告
[self.fullScreenvodAd loadAdData];
}
/**
ADSuyiSDKFullScreenVodAd准备好被播放
@param fullScreenVodAd 全屏视频广告实例对象
*/
- (void)adsy_fullScreenVodAdReadyToPlay:(ADSuyiSDKFullScreenVodAd *)fullScreenVodAd{
// 3、推荐在准备好被播放会调用展示激励视频广告
[self.fullScreenvodAd show];
}
/**
ADSuyiSDKFullScreenVodAd视频加载成功回调
@param fullScreenVodAd 全屏视频广告实例对象
*/
- (void)adsy_fullScreenVodAdSuccessToLoadVideo:(ADSuyiSDKFullScreenVodAd *)fullScreenVodAd{
// 3、也可在视频加载成功回调中展示激励视频广告
[self.fullScreenvodAd show];
}
/**
ADSuyiSDKFullScreenVodAd请求失败回调
@param fullScreenVodAd 全屏视频广告实例对象
@param error 失败原因
*/
- (void)adsy_fullScreenVodAdFailedToLoad:(ADSuyiSDKFullScreenVodAd *)fullScreenVodAd error:(ADSuyiAdapterErrorDefine *)error{
// 4、广告内存回收
_fullScreenvodAd = nil;
}
/**
ADSuyiSDKFullScreenVodAd关闭回调
@param fullScreenVodAd 全屏视频广告实例对象
*/
- (void)adsy_fullScreenVodAdDidClose:(ADSuyiSDKFullScreenVodAd *)fullScreenVodAd{
// 4、广告内存回收
_fullScreenvodAd = nil;
}
```
## 4.8 沉浸式视频广告 - ADSuyiSDKDrawvodAd
类似抖音、快手小视频一样的视频广告，目前仅有穿山甲和快手联盟拥有该样式。
`OC请求沉浸式视频代码示例：`[[沉浸式视频广告代码示例]](https://github.com/ADSuyi/ADSuyiSDKDemo-iOS/blob/master/ADSuyiSDKDemo-iOS/SuyiAds/DrawVodAd/AdSuyiDrawvodViewController.m)
`Swift请求沉浸式视频代码示例：`[[沉浸式视频广告代码示例]](https://github.com/ADSuyi/ADSuyiSDKDemo-iOS-Swift/blob/master/ADSuyiSDKDemo-iOS-Swift/SuyiAds/DrawVodAd/AdSuyiDrawVodViewController.swift)
沉浸式视频广告 - ADSuyiSDKDrawvodAd：
```objective-c
#import
typedef NS_ENUM(NSUInteger, ADSuyiSDKDrawvodAdStatus) {
ADSuyiSDKDrawvodAdStatusDefault, // 闲置状态
ADSuyiSDKDrawvodAdStatusLoading, // 加载广告中
};
@class ADSuyiAdapterDrawvodAdView;
@protocol ADSuyiSDKDrawvodAdDelegate;
@interface ADSuyiSDKDrawvodAd : NSObject
- (instancetype)new NS_UNAVAILABLE;
- (instancetype)init NS_UNAVAILABLE;
- (instancetype)initWithSize:(CGSize)size;
/**
代理回调
*/
@property (nonatomic, weak) id delegate;
/*
viewControllerForPresentingModalView
详解：[必选]开发者需传入用来弹出目标页的ViewController，一般为当前ViewController
*/
@property (nonatomic, weak) UIViewController *controller;
/*
status
详解：开发者可通过状态值来判断当前广告对象是否正在加载广告，支持KVO
*/
@property (nonatomic, assign, readonly) ADSuyiSDKDrawvodAdStatus status;
/**
广告位id
*/
@property (nonatomic, copy) NSString *posId;
/**
请求超时时间,默认为4s,需要设置3s及以上
*/
@property (nonatomic, assign) NSInteger tolerateTimeout;
/**
加载广告
@param count 拉取几条广告,建议区间 1~4, 超过可能无法拉取到
*/
- (void)load:(NSInteger)count;
@end
```
沉浸式视频广告代理回调 - ADSuyiSDKDrawvodAdDelegate
```objective-c
@protocol ADSuyiSDKDrawvodAdDelegate
/**
DrawvodAd请求成功
@param drawvodAd 广告实例
@param drawvodAdViewArray ADMobGenDrawvodAd集合
*/
- (void)adsy_drawvodAdSuccessToLoad:(ADSuyiSDKDrawvodAd *)drawvodAd drawvodAdArray:(NSArray *)drawvodAdViewArray;
/**
DrawvodAd请求失败
@param drawvodAd 广告实例
@param errorModel 请求错误描述
*/
- (void)adsy_drawvodAdFailToLoad:(ADSuyiSDKDrawvodAd *)drawvodAd errorModel:(ADSuyiAdapterErrorDefine *)errorModel;
/**
DrawvodAd请求成功
@param drawvodAd 广告实例
@param drawvodAdView ADMobGenDrawvodAd广告
*/
- (void)adsy_drawvodAdSuccessToRender:(ADSuyiSDKDrawvodAd *)drawvodAd view:(ADSuyiAdapterDrawvodAdView *)drawvodAdView;
/**
DrawvodAd请求成功
@param drawvodAd 广告实例
@param drawvodAdView ADMobGenDrawvodAd广告
*/
- (void)adsy_drawvodAdFailToRender:(ADSuyiSDKDrawvodAd *)drawvodAd view:(ADSuyiAdapterDrawvodAdView *)drawvodAdView error:(nullable NSError *)error;
/**
DrawvodAdView播放完成
@param drawvodAdView 广告视图
*/
- (void)adsy_drawvodAdPlayerDidPlayFinish:(ADSuyiAdapterDrawvodAdView *)drawvodAdView ;
/**
DrawvodAdView被展示
@param drawvodAdView 广告视图
*/
- (void)adsy_drawvodAdDidExposure:(ADSuyiAdapterDrawvodAdView *)drawvodAdView;
/**
DrawvodAdView被点击
@param drawvodAdView 广告视图
*/
- (void)adsy_drawvodAdDidClick:(ADSuyiAdapterDrawvodAdView *)drawvodAdView;
@end
```
Swift请求沉浸式视频代码示例：[[沉浸式视频广告代码示例]](https://github.com/ADSuyi/ADSuyiSDKDemo-iOS-Swift/blob/master/ADSuyiSDKDemo-iOS-Swift/SuyiAds/DrawVodAd/AdSuyiDrawVodViewController.swift)
OC请求沉浸式视频代码示例：
```objective-c
- (ADSuyiSDKDrawvodAd *)drawvodAd {
if(!_drawvodAd) {
// 1、初始化沉浸式视频广告，流程和信息流广告类似
_drawvodAd = [[ADSuyiSDKDrawvodAd alloc] initWithSize:self.tableView.frame.size];
_drawvodAd.posId = @"16e160a112f019de2b";
_drawvodAd.controller = self;
_drawvodAd.delegate = self;
}
return _drawvodAd;
}
- (void)loadDrawvodAd{
// 2、加载沉浸式视频广告
[self.drawvodAd load:3];
}
#pragma mark - ADSuyiSDKDrawvodAdDelegate
- (void)adsy_drawvodAdSuccessToLoad:(ADSuyiSDKDrawvodAd *)drawvodAd drawvodAdArray:(NSArray *)drawvodAdViewArray {
for (ADSuyiAdapterDrawvodAdView *adView in drawvodAdViewArray) {
// 3、渲染沉浸式广告
[adView render];
}
}
- (void)adsy_drawvodAdFailToLoad:(ADSuyiSDKDrawvodAd *)drawvodAd errorModel:(ADSuyiAdapterErrorDefine *)errorModel {
}
- (void)adsy_drawvodAdSuccessToRender:(ADSuyiSDKDrawvodAd *)drawvodAd view:(ADSuyiAdapterDrawvodAdView *)drawvodAdView {
// 4、渲染成功，此时高度正常，资源加载中，可展示
[self.data addObject:drawvodAdView];
[self.tableView reloadData];
}
- (void)dealloc
{
for (ADSuyiAdapterDrawvodAdView *adview in self.data) {
// 5、广告内存回收
[adview unRegist];
}
}
```
## 4.9 浮窗广告 - ADSuyiSDKNotificationAd
浮窗广告正常情况下不需要手动调用任何相关代码，如果需要展示请联系媒介处理。
**浮窗广告的暂停和恢复**。
```objective-c
#import
// 可通过调用此方法暂停浮窗广告投放
[ADSuyiSDKStatusManager notificationAdPause];
// 可通过调用此方法恢复浮窗广告投放
[ADSuyiSDKStatusManager notificationAdContinue];
```
## 4.10 快手内容 - ADSuyiContentAd
快手小视频一样的视频广告，点击进入快手的内容页面
快手内容广告 - ADSuyiContentAd：
```objective-c
typedef NS_ENUM(NSUInteger, ADSuyiSDKContentAdStatus) {
ADSuyiSDKContentAdStatusDefault, // 闲置状态
ADSuyiSDKContentAdStatusLoading, // 加载广告中
};
@protocol ADSuyiSDKContentAdDelegate;
@protocol ADSuyiSDKContentAdViewProtocol;
@interface ADSuyiSDKContentAd : NSObject
/*
contentAdPadding
详解：[可选]内容广告padding 默认 padding 左右各 16，上 8 下 0 ，在 调用loadContentAd之前配置
*/
@property (nonatomic, assign) UIEdgeInsets contentAdPadding;
/*
contentAdWidth
详解：内容广告默认宽度为屏幕宽度 在调用loadContentAd之前配置
*/
@property (nonatomic, assign) CGFloat contentAdWidth;
/*
status
详解：开发者可通过状态值来判断当前广告对象是否正在加载广告
*/
@property (nonatomic, assign, readonly) ADSuyiSDKContentAdStatus status;
/**
代理回调
*/
@property (nonatomic, weak) id delegate;
/**
广告位id
*/
@property (nonatomic, copy) NSString *posId;
/**
场景id
*/
@property (nonatomic, copy, nullable) NSString *scenesId;
/**
加载广告
*/
- (void)loadContentAd;
/**
模拟点击 会回调- (void)adsy_contentAdClicked:(ADSuyiSDKContentAd *)contentAd contentDetailPage:(UIViewController *)contentPageVc方法
*/
- (void)clickContentPageWithContentView:(UIView*)contentView;
@end
```
快手内容广告回调：
```objective-c
@protocol ADSuyiSDKContentAdDelegate
/**
内容广告请求成功
@param contentAd 广告实例
@param contentAdView 广告视图
*/
- (void)adsy_contentAdSucessToLoad:(ADSuyiSDKContentAd *)contentAd contentAdView:(__kindof UIView *)contentAdView;
/**
内容广告请求失败
@param contentAd 广告实例
@param errorModel 请求错误描述
*/
- (void)adsy_contentAdFailToLoad:(ADSuyiSDKContentAd *)contentAd
errorModel:(ADSuyiAdapterErrorDefine *)errorModel;
/**
内容广告被点击
@param contentAd 广告实例
@param contentPageVc 点击后跳转的内容页面控制器 自行选择 push / present / 容器组操作
*/
- (void)adsy_contentAdClicked:(ADSuyiSDKContentAd *)contentAd contentDetailPage:(UIViewController *)contentPageVc;
@end
@protocol ADSuyiSDKContentAdViewProtocol
/*
contentAdSize
详解：内容广告尺寸 adsy_contentAdSucessToLoad 回调成功时获取
*/
@property (nonatomic, assign, readonly) CGSize contentAdSize;
@end
```
Swift请求沉浸式视频代码示例：[[内容页广告代码示例]](https://github.com/ADSuyi/ADSuyiSDKDemo-iOS-Swift/blob/master/ADSuyiSDKDemo-iOS-Swift/SuyiAds/content/AdSuyiBaseContentViewController.swift)
OC请求沉浸式视频代码示例：
```objective-c
#import
- (void)loadContentAd {
_contentAd = [[ADSuyiSDKContentAd alloc]init];
_contentAd.delegate = self;
_contentAd.posId = @"7d4b7081b1cb1467aa";
[_contentAd loadContentAd];
}
#pragma mark - ADSuyiContentAdDelegate
- (void)adsy_contentAdSucessToLoad:(ADSuyiSDKContentAd *)contentAd contentAdView:(__kindof UIView *)contentAdView {
_contentAdWidth = contentAdView.contentAdSize.width;
_contentAdHeight = contentAdView.contentAdSize.height;
[contentAdView adsy_registView:nil];
[self.items addObject:contentAdView];
[self.tableView reloadData];
}
- (void)adsy_contentAdFailToLoad:(ADSuyiSDKContentAd *)contentAd errorModel:(ADSuyiAdapterErrorDefine *)errorModel {
NSLog(@"内容广告加载失败%@",errorModel);
}
- (void)adsy_contentAdClicked:(ADSuyiSDKContentAd *)contentAd contentDetailPage:(UIViewController *)contentPageVc {
// 使用控制器作为内容页面父控制器来添加返回按钮（按需求是否采用该方式）
AdSuyiBaseContentViewController *contentVc = [[AdSuyiBaseContentViewController alloc] initWithViewController:contentPageVc];
[self.navigationController pushViewController:contentVc animated:YES];
}
```
## 作者
bale@admobile.top
xianggua@admobile.top
## 商务合作
tomato@admobile.top