开发者文档

iOS SDK接入文档

2026-02-06

版本说明

版本更新内容更新时间
2.0.0.0建议全部升级
【新增】广告视图升级
【新增】SDK包名变更
【修复】已知问题修复
2026.03.03
1.6.2.0【优化】广发展示优化
【新增】广告Logo图片更新
【修复】已知问题修复
2026.03.03
1.6.0.0【新增】自渲染、横幅、激励广告
【新增】广告交互
【修复】已知问题修复
2026.01.14
1.5.3.2【优化】广告样式优化
【修复】已知问题修复
2025.12.29
1.2.1.1【优化】视频播放优化
【优化】初始化流程优化
【优化】交互方式优化
【修复】其他已知问题优化		2025.10.09
1.0.0.1【新增】支持开屏广告
【新增】支持插屏广告
【新增】支持信息流模板渲染		2025.08.08

在您阅读此文档时，我们假定您已经具备了基础的 iOS 应用开发经验，并能够理解相关基础概念。

1 接入准备

1.1 添加SDK

1.1.1 pod方式【推荐】

  1. 在podfile文件中加入以下代码:
pod 'YoAdCore' # 建议指定最新版本
  1. 项目根目录，执行 pod install

1.1.2 本地导入方式

  1. 将纵量广告提供的SDK压缩包解压

  2. 将其中所有 framework 和 bundle 放入自己项目文件夹下

YoAdCore.xcframework
YoAdCoreResources.bundle

1.1.3其他相关SDK说明

SDK支持架构：x86-64、arm64。

1.1.4 适配说明

当前SDK版本已适配支持 iOS 13 及以上版本。

1.2 Info.plist 配置

1.2.1 网络权限配置【必须】

<key>NSAppTransportSecurity</key>
    <dict>
        <key>NSAllowsArbitraryLoads</key>
        <true/>
</dict>

1.2.2 白名单配置【非必须】

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>weixin</string>
    <string>wechat</string>
    <string>weixinULAPI</string>
    <string>jdlogin</string>
    <string>jdmobile</string>
    <string>taobao</string>
    <string>tmall</string>
    <string>taobaolive</string>
    <string>fleamarket</string>
    <string>pinduoduo</string>
    <string>vipshop</string>
    <string>yanxuan</string>
    <string>eleme</string>
    <string>meituanwaimai</string>
    <string>imeituan</string>
    <string>diditaxi</string>
    <string>iosamap</string>
    <string>youku</string>
    <string>iqiyi</string>
    <string>tenvideo</string>
    <string>kwai</string>
    <string>ksnebula</string>
    <string>snssdk1128</string>
    <string>xhsdiscover</string>
    <string>zhihu</string>
    <string>ctrip</string>
    <string>qunariphone</string>
    <string>taobaotravel</string>
    <string>autohome</string>
    <string>ucbrowser</string>
    <string>quark</string>
    <string>baiduboxapp</string>
    <string>baiduboxlite</string>
    <string>duapp</string>
    <string>alipay</string>
    <string>bilibili</string>
</array>

1.2.3 增加获取 IDFA 权限，以便能够提供更精准的进行广告投放和收入优化。【非必须】

<key>NSUserTrackingUsageDescription</key>
<string>该标识符将用于向您投放个性化广告</string>

跟踪权限的授权提示在应用运行过程中只会弹出一次。若用户后续希望调整该权限设置，可前往手机系统设置，在「隐私」相关选项中进行修改。

值得注意的是：如果是在启动方法中调用授权，是不会弹出授权提示框的。

建议在 AppDelegate 的生命周期里面来获取权限

- (void)applicationDidBecomeActive:(UIApplication *)application
{
    if (@available(iOS 14.5, *))
    {
        if([ATTrackingManager trackingAuthorizationStatus] == ATTrackingManagerAuthorizationStatusNotDetermined)
        {
            [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {
            }];
        }
    }
}

1.3 Swift 接入方式

如果项目是 Swift 的工程，需要创建一个桥接文件，将所需要的头文件 import 进入。

#import <YoAdCore/YoAdCore.h>

2 初始化SDK

为避免SDK在用户同意隐私协议与用户协议之前获取用户信息，纵量广告SDK向开发者提供了初始化方法，开发者可根据App具体情况选择初始化时机，建议在允许网络之后初始化。

建议开发者在APP首次运行时，通过弹窗等明显方式提示用户阅读《隐私政策》，用户确认同意《隐私政策》后，再调用此接口初始化SDK进行用户信息的收集与处理。

1、初始化SDK：只进行SDK初始化，不会获取用户隐私信息，建议在允许网络后执行

    //SDK初始化方法，不会获取设备及用户信息，建议在允许网络后执行
    YoAdConfig *config = [[YoAdConfig alloc] init];
    config.appId = adInitParams[@"adAppId"];           ///【必要】应用在纵量广告平台生成的AppId
    config.customIDFA = @"应用实际IDFA";                ///【建议】应用自行获取的IDFA
    config.customIDFV = @"应用实际IDFV";                ///【建议】应用自行获取的IDFV
    config.customUUID = @"应用实际UUID";                ///【建议】应用自行获取的UUID
    config.wechatAppId = @"应用在微信开放平台的AppId";    ///【建议】应用在微信开放平台的AppId
    config.isDebug = NO;                              ///【可选】默认关闭，正式版本建议关闭
    config.isSupportPersonalRecommend = YES;          ///【可选】是否允许个性化推荐，建议开启，否则会影响广告填充率
    config.isSupportAdvancedInteraction = YES;        ///【可选】是否支持高级互动，建议开启
    config.isCanUseLocation = YES;                    ///【可选】是否允许获取位置信息，若不允许，则建议传入
    config.customLatitude = @0.0;                     ///【可选】位置信息-纬度
    config.customLongitude = @0.0;                    ///【可选】位置信息-经度
    [YoMoreAd initWithConfiguration:config success:^{
        NSLog(@"[yodemo] 初始化成功");
    } failure:^(NSInteger code, NSString * _Nullable msg) {
        NSLog(@"[yodemo] 初始化失败：code=%ld, msg=%@", (long)code, msg);
    }];

2、启动SDK：启动SDK，建议在初始化成功后、加载广告之前调用。

    //若不关心回调，可传nil
    [YoMoreAd startWithCompletionHandler:^{
        NSLog(@"[yodemo] 启动SDK成功");
    } failure:^(NSInteger code, NSString *msg) {
        NSLog(@"[yodemo] 启动SDK成功");
    }];

3. 接入广告类型

每个广告对象仅允许加载、展示一次，且加载展示的顺序不能出错，如果使用出错不会有任何提示，请检查自己的使用是否有误。

3.1 开屏广告

开屏广告以App启动作为曝光时机，提供3~5s的可感知广告展示。用户可以点击广告跳转按钮跳转到目标页面；或者点击右上角的“跳过”按钮，跳转到app内容首页。

适用场景：开屏广告会在您的应用开启时加载，拥有固定展示时间（一般为3~5秒），展示完毕后自动关闭并进入您的应用主界面。

接入示例：

    //广告加载
    YoAdParam *adParam = [[YoAdParam alloc] init];
    adParam.adId = "qq9c4r8rs7hj";                  //【必要】广告位Id
    adParam.adCount = 1;                            //【可选】期望数量
    adParam.acceptedWidth = 900;                    //【可选】期望宽度
    adParam.acceptedHeight = 1600;                  //【可选】期望高度
    [YoMoreAd loadSplash:adParam splashDelegate:self];

YoSplashDelegate示例：

    //.h文件实现YoSplashDelegate协议
    @interface YoDemoSplash : NSObject <YoSplashDelegate>
    @end

    //.m文件
    @implementation YoDemoSplash

    //【必要】广告加载成功
     - (void)onSplashLoadSuccess:(NSArray<id<YoSplashAd>> *)adList {
        NSLog(@"[yodemo] onSplashLoadSuccess");
        if (adList && adList.count > 0) {
            _yoSplashAd = adList[0];
            //获取广告价格
            NSInteger adPrice = [_yoSplashAd getPrice];   //单位：分

            //展示广告
            [self showAd:_yoSplashAd];            
        }
    }

    //展示广告
    - (void)showAd:(nullable id <YoSplashAd>)yoAd {
        if (yoAd) {
            UIWindow *keyWindow = [UIApplication sharedApplication].keyWindow;
            //建议传入应用主window对象的根视图控制器展示，即keyWindow的rootViewController
            [yoAd showSplashWithRootViewController:keyWindow.rootViewController];
        }
    }

    //【必要】广告点击
    - (void)onSplashClicked { 
        NSLog(@"[yodemo] onSplashClicked");
    }

    //【必要】广告关闭
    - (void)onSplashClosed { 
        NSLog(@"[yodemo] onSplashClosed");
    }


    //【可选】加载失败
    - (void)onSplashLoadFailure:(NSInteger)code msg:(NSString *)msg {
        NSLog(@"[yodemo] onSplashLoadFailure: code=%ld, msg=%@", (long)code, msg);
    }

    //【可选】展示成功
    - (void)onSplashShowSuccess { 
        NSLog(@"[yodemo] onSplashShowSuccess");
    }

    //【可选】展示失败
    - (void)onSplashShowFailure:(NSInteger)code msg:(NSString *)msg {
        NSLog(@"[yodemo] onSplashShowFailure: code=%ld, msg=%@", (long)code, msg);
    }

    //【可选】倒计时结束
    - (void)onSplashTimeOver {
        NSLog(@"[yodemo] onSplashTimeOver");
    }

    //【可选】预加载成功
    - (void)onSplashPrepareSuccess:(id<YoSplashAd>)ad {
        NSLog(@"[yodemo] onSplashPrepareSuccess");
    }

    //【可选】预加载失败
    - (void)onSplashPrepareFailure:(id<YoSplashAd>)ad code:(NSInteger)code msg:(NSString *)msg {
        NSLog(@"[yodemo] onSplashPrepareFailure: 预加载失败code=%ld, msg=%@", (long)code, msg);
    }

    //【可选】视频播放开始
    - (void)onSplashVideoStart {
        NSLog(@"[yodemo] onSplashVideoStart");
    }

    //【可选】视频播放跳过
    - (void)onSplashVideoSkipped {
        NSLog(@"[yodemo] onSplashVideoSkipped");
    }

    //【可选】视频播放结束
    - (void)onSplashVideoComplete {
        NSLog(@"[yodemo] onSplashVideoComplete");
    }

    //【可选】视频播放错误
    - (void)onSplashVideoError:(NSInteger)code msg:(NSString *)msg {
        NSLog(@"[yodemo] onSplashVideoError: code=%ld, msg=%@", (long)code, msg);
    }

    @end

3.2 插屏广告

插屏广告是移动广告的一种常见形式，广告素材类型比较丰富，包括视频类、图文类，广告呈现方式也比较灵活，可在管理后台配置，选择使用半屏或全屏呈现。

适用场景：应用的大部分流程。

接入示例：

    //广告加载
    YoAdParam *adParam = [[YoAdParam alloc] init];
    adParam.adId = "qq9c4r8rs7hj";                  //【必要】广告位Id
    adParam.adCount = 1;                            //【可选】期望数量
    [YoMoreAd loadInterstitial:adParam interstitialDelegate:self];

YoInterstitialDelegate示例：

    //.h文件实现YoInterstitialDelegate协议
    @interface YoDemoInterstitial : NSObject <YoInterstitialDelegate>
    @end



    //.m文件
    @implementation YoDemoInterstitial

    //【必要】广告加载成功
    - (void)onInterstitialLoadSuccess:(NSArray<id<YoInterstitialAd>> *)adList {
        NSLog(@"[yodemo] onInterstitialLoadSuccess: 加载成功size=%ld", adList?adList.count:0);
        if (adList && adList.count > 0){
            _yoInterstitialAd = adList[0];
            //获取广告价格
            NSInteger adPrice = [_yoInterstitialAd getPrice];   //单位：分

            //展示广告
            [self showAd:_yoInterstitialAd];
        }
    }

    //展示广告
    - (void)showAd:(nullable id <YoInterstitialAd>)yoAd {
        if (yoAd) {
            UIWindow *keyWindow = [UIApplication sharedApplication].keyWindow;
            //建议传入应用主window对象的根视图控制器展示，即keyWindow的rootViewController
            [yoAd showInterstitialWithRootViewController:keyWindow.rootViewController];
        }
    }    

    //【必要】广告点击
    - (void)onInterstitialClicked { 
        NSLog(@"[yodemo] onInterstitialClicked");
    }

    //【必要】广告关闭
    - (void)onInterstitialClosed { 
        NSLog(@"[yodemo] onInterstitialClosed");
    }


    //【可选】加载失败
    - (void)onInterstitialLoadFailure:(NSInteger)code msg:(NSString *)msg {
        NSLog(@"[yodemo] onInterstitialLoadFailure: 加载失败code=%ld, msg=%@", (long)code, msg);
    }

    //【可选】展示成功
    - (void)onInterstitialShowSuccess {
        NSLog(@"[yodemo] onInterstitialShowSuccess: 展示成功");
    }

    //【可选】展示失败
    - (void)onInterstitialShowFailure:(NSInteger)code msg:(NSString *)msg {
        NSLog(@"[yodemo] onInterstitialShowFailure: 展示失败code=%ld, msg=%@", (long)code, msg);
    }

    //【可选】预加载成功
    - (void)onInterstitialPrepareSuccess:(id<YoInterstitialAd>)ad {
        NSLog(@"[yodemo] onInterstitialPrepareSuccess");
    }

    //【可选】预加载失败
    - (void)onInterstitialPrepareFailure:(id<YoInterstitialAd>)ad code:(NSInteger)code msg:(NSString *)msg {
        NSLog(@"[yodemo] onInterstitialPrepareFailure: code=%ld, msg=%@", (long)code, msg);
    }

    //【可选】视频播放开始
    - (void)onInterstitialVideoStart {
        NSLog(@"[yodemo] onInterstitialVideoStart");
    }

    //【可选】视频播放跳过
    - (void)onInterstitialVideoSkipped {
        NSLog(@"[yodemo] onInterstitialVideoSkipped");
    }

    //【可选】视频播放结束
    - (void)onInterstitialVideoComplete {
        NSLog(@"[yodemo] onInterstitialVideoComplete");
    }

    //【可选】视频播放错误
    - (void)onInterstitialVideoError:(NSInteger)code msg:(NSString *)msg {
        NSLog(@"[yodemo] onInterstitialVideoError: code=%ld, msg=%@", (long)code, msg);
    }

    @end

3.3 信息流模板渲染广告

由广告联盟SDK提供渲染模板，开发者可在广告联盟管理后台配置渲染样式，包括上图下文、上文下图、大图等。

适用场景：适用于动态信息流等广告场景。

接入示例：

    //广告加载
    YoAdParam *adParam = [[YoAdParam alloc] init];
    adParam.adId = "qq9c4r8rs7hj";                  //【必要】广告位Id
    adParam.adCount = 1;                            //【可选】期望数量
    adParam.acceptedWidth = 900;                    //【可选】期望宽度
    adParam.acceptedHeight = 600;                   //【可选】期望高度
    [YoMoreAd loadFeed:adParam feedDelegate:self];

YoFeedDelegate示例：

    //.h文件实现YoFeedDelegate协议
    @interface YoDemoFeed : NSObject <YoFeedDelegate>
    @end



    //.m文件
    @implementation YoDemoFeed

    //【必要】广告加载成功
    - (void)onFeedLoadSuccess:(NSArray<id<YoFeedAd>> *)adList {
        NSLog(@"[yodemo] onFeedLoadSuccess: size=%@", adList);
        if (adList && adList.count > 0){
            _yoFeedAd = adList[0];
            //获取广告价格
            NSInteger adPrice = [_yoFeedAd getPrice];   //单位：分

            //展示广告
            [self showAd:_yoFeedAd]; 
        }
    }

    //展示广告
    - (void)showAd:(nullable id <YoFeedAd>)yoAd {
        if (yoAd) {
            //方式1【推荐】：建议传入应用主window对象的根视图控制器，即keyWindow的rootViewController; viewContainer为广告视图容器;
            UIWindow *keyWindow = [UIApplication sharedApplication].keyWindow;
            [yoAd showFeedWithRootViewController:keyWindow.rootViewController viewContainer:_adContainerView];
            //方式2：获取广告View,自行添加到视图容器
            UIView *adView = [_yoAd getAdView];
            if (adView) {
                [_adContainerView addSubview:adView];
            }
        }
    }

    //【必要】广告点击
    - (void)onFeedClicked { 
        NSLog(@"[yodemo] onFeedClicked");
    }

    //【必要】广告关闭
    - (void)onFeedClosed { 
        NSLog(@"[yodemo] onFeedClosed");
        //移除广告视图
        if (_adContainerView) {
            [_adContainerView.subviews makeObjectsPerformSelector:@selector(removeFromSuperview)];
        }
    }


    //【可选】加载失败
    - (void)onFeedLoadFailure:(NSInteger)code msg:(NSString *)msg {
        NSLog(@"[yodemo] onFeedLoadFailure: code=%ld, msg=%@", (long)code, msg);
    }

    //【可选】展示成功
    - (void)onFeedShowSuccess { 
        NSLog(@"[yodemo] onFeedShowSuccess");
    }

    //【可选】展示失败
    - (void)onFeedShowFailure:(NSInteger)code msg:(NSString *)msg {
        NSLog(@"[yodemo] onFeedShowFailure: code=%ld, msg=%@", (long)code, msg);
    }

    //【可选】预加载成功
    - (void)onFeedPrepareSuccess:(id<YoFeedAd>)ad {
        NSLog(@"[yodemo] onFeedPrepareSuccess");
    }

    //【可选】预加载失败
    - (void)onFeedPrepareFailure:(id<YoFeedAd>)ad code:(NSInteger)code msg:(NSString *)msg {
        NSLog(@"[yodemo] onFeedPrepareFailure: code=%ld, msg=%@", (long)code, msg);
    }

    //【可选】视频播放开始
    - (void)onFeedVideoStart {
        NSLog(@"[yodemo] onFeedVideoStart");
    }

    //【可选】视频播放跳过
    - (void)onFeedVideoSkipped {
        NSLog(@"[yodemo] onFeedVideoSkipped");
    }

    //【可选】视频播放结束
    - (void)onFeedVideoComplete {
        NSLog(@"[yodemo] onFeedVideoComplete");
    }

    //【可选】视频播放错误
    - (void)onFeedVideoError:(NSInteger)code msg:(NSString *)msg {
        NSLog(@"[yodemo] onFeedVideoError: code=%ld, msg=%@", (long)code, msg);
    }

    @end

3.4 激励视频

激励视频是一种可选观看的视频广告，通常提供给用户一定的奖励（如金币、积分或应用内道具），用户观看完成后即可获得奖励。广告素材可以是视频或图文视频形式，由广告联盟 SDK 提供标准化组件，开发者只需在指定位置加载即可。

激励视频广告全屏展示，用户可以选择观看或跳过，观看完成后自动触发奖励回调。广告样式和奖励配置可在广告联盟管理后台设置。

适用场景：适用于游戏、应用内任务或关卡激励场景，通过激励视频提升用户参与度和广告曝光量。

接入示例：

    //广告加载
    YoAdParam *adParam = [[YoAdParam alloc] init];
    adParam.adId = "xlueazcovxji";                  //【必要】广告位Id
    adParam.adCount = 1;                            //【可选】期望数量
    [YoMoreAd loadReward:adParam rewardDelegate:self];

YoRewardDelegate 示例：

    //.h文件实现 YoRewardDelegate 协议
    @interface YoDemoReward : NSObject <YoRewardDelegate>
    @end


    //.m文件
    @implementation YoDemoReward

    //【必要】广告加载成功
    - (void)onRewardLoadSuccess:(NSArray<id<YoRewardAd>> *)adList {
        NSLog(@"[yodemo] onRewardLoadSuccess: 加载成功size=%ld", adList?adList.count:0);
        if (adList && adList.count > 0){
            _yoRewardAd = adList[0];
            //获取广告价格
            NSInteger adPrice = [_yoRewardAd getPrice];   //单位：分

            //展示广告
            [self showAd:_yoRewardAd];
        }
    }

    //展示广告
    - (void)showAd:(nullable id <YoRewardAd>)yoAd {
        if (yoAd) {
            UIWindow *keyWindow = [UIApplication sharedApplication].keyWindow;
            //建议传入应用主window对象的根视图控制器展示，即keyWindow的rootViewController
            [yoAd showRewardWithRootViewController:keyWindow.rootViewController];
        }
    }    

    //【必要】广告点击
    - (void)onRewardClicked { 
        NSLog(@"[yodemo] onRewardClicked");
    }

    //【必要】广告关闭
    - (void)onRewardClosed { 
        NSLog(@"[yodemo] onRewardClosed");
    }

    // 【必要】用户是否已获得激励奖励（最终确认，可安全发放奖励）
    - (void)onRewardVerify:(BOOL)isRewardValid info:(NSDictionary *)info {
        NSLog(@"[yodemo] onRewardVerify");
        if (isRewardValid) {
            NSLog(@"[yodemo] 奖励有效");
        } else {
            NSLog(@"[yodemo] 奖励无效");
        }
    }

    //【可选】加载失败
    - (void)onRewardLoadFailure:(NSInteger)code msg:(NSString *)msg {
        NSLog(@"[yodemo] onRewardLoadFailure: 加载失败code=%ld, msg=%@", (long)code, msg);
    }

    //【可选】展示成功
    - (void)onRewardShowSuccess {
        NSLog(@"[yodemo] onRewardShowSuccess: 展示成功");
    }

    //【可选】展示失败
    - (void)onRewardShowFailure:(NSInteger)code msg:(NSString *)msg {
        NSLog(@"[yodemo] onRewardShowFailure: 展示失败code=%ld, msg=%@", (long)code, msg);
    }

    //【可选】预加载成功
    - (void)onRewardPrepareSuccess:(id<YoRewardAd>)ad {
        NSLog(@"[yodemo] onRewardPrepareSuccess");
    }

    //【可选】预加载失败
    - (void)onRewardPrepareFailure:(id<YoRewardAd>)ad code:(NSInteger)code msg:(NSString *)msg {
        NSLog(@"[yodemo] onRewardPrepareFailure: code=%ld, msg=%@", (long)code, msg);
    }

    //【可选】视频播放开始
    - (void)onRewardVideoStart {
        NSLog(@"[yodemo] onRewardVideoStart");
    }

    //【可选】视频播放跳过
    - (void)onRewardVideoSkipped {
        NSLog(@"[yodemo] onRewardVideoSkipped");
    }

    //【可选】视频播放结束
    - (void)ononRewardVideoStartVideoComplete {
        NSLog(@"[yodemo] onRewardVideoComplete");
    }

    //【可选】视频播放错误
    - (void)onRewardVideoError:(NSInteger)code msg:(NSString *)msg {
        NSLog(@"[yodemo] onRewardVideoError: code=%ld, msg=%@", (long)code, msg);
    }

    @end

3.5 横幅广告

横幅广告一般固定展示在页面的顶部或底部，不影响用户的核心操作流程，用户可通过点击广告跳转至广告主的目标页面。样式包括小图、中图、大图等。

适用场景：适用于应用内常驻展示的页面，如首页、列表页、内容页底部等，需要持续曝光但对用户打扰较低的广告场景。

接入示例：

    //广告加载
    YoAdParam *adParam = [[YoAdParam alloc] init];
    adParam.adId = "67alcrs8c7go";                  //【必要】广告位Id
    adParam.adCount = 1;                            //【可选】期望数量
    adParam.acceptedWidth = 900;                    //【可选】期望宽度
    adParam.acceptedHeight = 600;                   //【可选】期望高度
    [YoMoreAd loadBanner:adParam bannerDelegate:self];

YoBannerDelegate示例：

    //.h文件实现 YoBannerDelegate 协议
    @interface YoDemoBanner : NSObject <YoBannerDelegate>
    @end

    //.m文件
    @implementation YoDemoBanner

    //【必要】广告加载成功
    - (void)onBannerLoadSuccess:(NSArray<id<YoBannerAd>> *)adList {
        NSLog(@"[yodemo] onBannerLoadSuccess: size=%@", adList);
        if (adList && adList.count > 0){
            _yoBannerAd = adList[0];
            //获取广告价格
            NSInteger adPrice = [_yoBannerAd getPrice];   //单位：分

            //展示广告
            [self showAd:_yoBannerAd]; 
        }
    }

    //展示广告
    - (void)showAd:(nullable id <YoBannerAd>)yoAd {
        if (yoAd) {
            //方式1【推荐】：建议传入应用主window对象的根视图控制器，即keyWindow的rootViewController; viewContainer为广告视图容器;
            UIWindow *keyWindow = [UIApplication sharedApplication].keyWindow;
            [yoAd showBannerWithRootViewController:keyWindow.rootViewController viewContainer:_adContainerView];

            //方式2：获取广告View,自行添加到视图容器
            UIView *adView = [_yoAd getAdView];
            if (adView) {
                [_adContainerView addSubview:adView];
            }
        }
    }

    //【必要】广告点击
    - (void)onBannerClicked { 
        NSLog(@"[yodemo] onBannerClicked");
    }

    //【必要】广告关闭
    - (void)onBannerClosed { 
        NSLog(@"[yodemo] onBannerClosed");
        //移除广告视图
        if (_adContainerView) {
            [_adContainerView.subviews makeObjectsPerformSelector:@selector(removeFromSuperview)];
        }
    }


    //【可选】加载失败
    - (void)onBannerLoadFailure:(NSInteger)code msg:(NSString *)msg {
        NSLog(@"[yodemo] onBannerLoadFailure: code=%ld, msg=%@", (long)code, msg);
    }

    //【可选】展示成功
    - (void)onBannerShowSuccess { 
        NSLog(@"[yodemo] onBannerShowSuccess");
    }

    //【可选】展示失败
    - (void)onBannerShowFailure:(NSInteger)code msg:(NSString *)msg {
        NSLog(@"[yodemo] onBannerShowFailure: code=%ld, msg=%@", (long)code, msg);
    }

    //【可选】预加载成功
    - (void)onBannerPrepareSuccess:(id<YoBannerAd>)ad {
        NSLog(@"[yodemo] onBannerPrepareSuccess");
    }

    //【可选】预加载失败
    - (void)onBannerPrepareFailure:(id<YoBannerAd>)ad code:(NSInteger)code msg:(NSString *)msg {
        NSLog(@"[yodemo] onBannerPrepareFailure: code=%ld, msg=%@", (long)code, msg);
    }

    //【可选】视频播放开始
    - (void)onBannerVideoStart {
        NSLog(@"[yodemo] onBannerVideoStart");
    }

    //【可选】视频播放跳过
    - (void)onBannerVideoSkipped {
        NSLog(@"[yodemo] onBannerVideoSkipped");
    }

    //【可选】视频播放结束
    - (void)onBannerVideoComplete {
        NSLog(@"[yodemo] onBannerVideoComplete");
    }

    //【可选】视频播放错误
    - (void)onBannerVideoError:(NSInteger)code msg:(NSString *)msg {
        NSLog(@"[yodemo] onBannerVideoError: code=%ld, msg=%@", (long)code, msg);
    }

    @end

3.6 自渲染广告

自渲染广告适合需要高度定制化广告样式的场景，例如自定义信息流、专题页广告或原生界面嵌入广告。开发者需在应用内实现点击事件回调和曝光统计，确保广告数据能够正确上报给广告联盟。

适用场景：高度自定义广告样式需求；信息流、内容列表、专题页等原生场景；需要与应用 UI 融合的广告展示

支持类型：目前自渲染支持原生信息流自渲染和插屏自渲染

接入示例：

    // 广告加载
    YoAdParam *adParam = [[YoAdParam alloc] init];
    adParam.adId = "gpraequ0a1wq";                  //【必要】广告位Id
    adParam.adCount = 1;                            //【可选】期望数量
    adParam.acceptedWidth = 900;                    //【可选】期望宽度
    adParam.acceptedHeight = 600;                   //【可选】期望高度

    // 加载信息流自渲染
    [YoMoreAd loadFeedSelfRender:adParam selfRenderDelegate:self];

    // 加载插屏自渲染
    [YoMoreAd loadInterstitialSelfRender:adParam selfRenderDelegate:self];

YoSelfRenderDelegate

    //.h文件实现 YoSelfRenderDelegate 协议
    @interface YoDemoSelfRender : NSObject <YoSelfRenderDelegate>
    @end

    //.m文件
    @implementation YoDemoSelfRender

    //【必要】广告加载成功
    - (void)onSelfRenderLoadSuccess:(NSArray<id<YoSelfRenderAd>> *)adList {
        NSLog(@"[yodemo] onSelfRenderLoadSuccess: size=%@", adList);
        if (adList && adList.count > 0){
            _yoAd = adList[0];
            //获取广告价格
            NSInteger adPrice = [_yoAd getPrice];   //单位：分
            // NSInteger thirdAdPrice = 99999;   //单位：分
            //竞价获胜：平台（枚举见下节），价格单位：分
            [_yoAd bidWin:YO_PLATFORM_ZongLiang price:adPrice];
            //竞价失败：竟败原因（枚举见下节），平台（枚举见下节），价格单位：分
            //[_yoAd bidLoss:YO_LOSS_CODE_LOW_PRICE platform:YO_PLATFORM_CSJ price:thirdAdPrice];
        }
    }

    //【必要】广告加载失败
    - (void)onSelfRenderLoadFailure:(NSInteger)code msg:(NSString *)msg {
        NSLog(@"[yodemo] onSelfRenderLoadFailure: code=%ld, msg=%@", (long)code, msg);
    }

    //【必要】广告点击
    - (void)onSelfRenderClicked { 
        yolog_msg(@"[yodemo] onSelfRenderClicked");
    }

    //【必要】广告关闭
    - (void)onSelfRenderClosed { 
        yolog_msg(@"[yodemo] onSelfRenderClosed");
        // 自渲染移除注册的事件
        [self.yoAd unregisterView];
        // 移除广告视图
        [self.adContainerView.subviews makeObjectsPerformSelector:@selector(removeFromSuperview)];
    }

    //【可选】广告展示失败
    - (void)onSelfRenderShowFailure:(NSInteger)code msg:(NSString *)msg {
        NSLog(@"[yodemo] onSelfRenderShowFailure: code=%ld, msg=%@", (long)code, msg);
    }

    //【可选】广告展示成功
    - (void)onSelfRenderShowSuccess { 
        NSLog(@"[yodemo] onSelfRenderShowSuccess");
    }

    //【可选】缓存成功
    - (void)onSelfRenderPrepareSuccess:(id<YoSelfRenderAd>)ad {
        NSLog(@"[yodemo] onSelfRenderPrepareSuccess");
    }

    //【可选】缓存失败
    - (void)onSelfRenderPrepareFailure:(id<YoSelfRenderAd>)ad code:(NSInteger)code msg:(NSString *)msg {
        NSLog(@"[yodemo] onSelfRenderPrepareFailure: code=%ld, msg=%@", (long)code, msg);
    }

    //【可选】视频开始播放
    - (void)onSelfRenderVideoStart {
        NSLog(@"[yodemo] onSelfRenderVideoStart");
    }

    //【可选】视频播放进度
    - (void)onSelfRenderVideoProgress:(NSInteger)currentTime duration:(NSInteger)duration {
        NSLog(@"[yodemo] onSelfRenderVideoProgress currentTime=%ld duration=%ld", currentTime, duration);
    }

    //【可选】视频跳过
    - (void)onSelfRenderVideoSkipped {
        NSLog(@"[yodemo] onSelfRenderVideoSkipped");
    }

    //【可选】视频播放完成
    - (void)onSelfRenderVideoComplete {
        NSLog(@"[yodemo] onSelfRenderVideoComplete");
    }

    //【可选】视频播放爆错
    - (void)onSelfRenderVideoError:(NSInteger)code msg:(NSString *)msg {
        NSLog(@"[yodemo] onSelfRenderVideoError: code=%ld, msg=%@", (long)code, msg);
    }

自渲染视图示例：

    // 获取扩展视图View，一般是为了渲染广告的主视频或主图片
    UIView *mediaView = self.yoAd.mediaView;
    if (!mediaView) {
        return;
    }
    // 自渲染视图：YoDemoNativeFeedView为自渲染视图View
    YoDemoNativeFeedView *nativeFeedView = [[YoDemoNativeFeedView alloc] init];     
    nativeFeedView.translatesAutoresizingMaskIntoConstraints = NO;
    nativeFeedView.mediaView = mediaView;   
    nativeFeedView.titleLabel.text = self.yoAd.title;                   //标题
    nativeFeedView.detailLabel.text = self.yoAd.adDesc;                 //表述
    nativeFeedView.adLogoImageView.image = self.yoAd.adLogoImage;       //广告Logo
    //自渲染视图View添加到页面容器
    [adContainer addSubview:nativeFeedView];
    //注册交互View：根据自己的自渲染视图View按需添加
    [self.yoAd registerContainerView:adContainer clickableViews:@[
        mediaView, nativeFeedView.titleLabel
    ] closeableViews:@[
        nativeFeedView.closeButton
    ] rootViewController:[DemoTool getRootViewController]];

自渲染视图YoDemoNativeFeedView示例：

@interface YoDemoNativeFeedView ()

@property (nonatomic, readonly) UIView *bottomView;
@property (nonatomic, readonly) UILabel *titleLabel;
@property (nonatomic, readonly) UILabel *detailLabel;
@property (nonatomic, readonly) UIButton *closeButton;
@property (nonatomic, readonly) UIImageView *adLogoImageView;
@property (nonatomic, weak) UIView *mediaView;

@end

@implementation YoDemoNativeFeedView

- (instancetype)init {
    if (self = [super init]) {
        self.backgroundColor = [UIColor blueColor];
        [self setupSubviews];
    }
    return self;
}

- (void)setupSubviews {
    [self addSubview:self.bottomView];
    [self.bottomView addSubview:self.titleLabel];
    [self.bottomView addSubview:self.detailLabel];
    [self.bottomView addSubview:self.closeButton];
    [self addSubview:self.adLogoImageView];
}

- (void)layoutSubviews {
    [super layoutSubviews];
    ///子View布局
}

#pragma mark - getters | setters

- (void)setMediaView:(UIView *)mediaView {
    _mediaView = mediaView;
    if (mediaView) {
        [self addSubview:mediaView];
    }
}

- (UIView *)bottomView {
    if (!_bottomView) {
        _bottomView = [[UIView alloc] init];
    }
    return _bottomView;
}

- (UILabel *)titleLabel {
    if (!_titleLabel) {
        _titleLabel = [[UILabel alloc] init];
        _titleLabel.font = [UIFont boldSystemFontOfSize:17.f];
        _titleLabel.backgroundColor = [UIColor redColor];
    }
    return _titleLabel;
}

- (UILabel *)detailLabel {
    if (!_detailLabel) {
        _detailLabel = [[UILabel alloc] init];
        _detailLabel.font = [UIFont systemFontOfSize:15.f];
        _detailLabel.backgroundColor = [UIColor redColor];
    }
    return _detailLabel;
}

- (UIButton *)closeButton {
    if (!_closeButton) {
        _closeButton = [UIButton buttonWithType:UIButtonTypeSystem];
        [_closeButton setTitle:@"点我关闭" forState:UIControlStateNormal];
        _closeButton.backgroundColor = [UIColor redColor];
        _closeButton.titleLabel.font = [UIFont systemFontOfSize:16.f];
        [_closeButton setTitleColor:[UIColor whiteColor] forState:UIControlStateNormal];
    }
    return _closeButton;
}

- (UIImageView *)adLogoImageView {
    if (!_adLogoImageView) {
        _adLogoImageView = [[UIImageView alloc] init];
    }
    return _adLogoImageView;
}

@end

4. 实时竞价

支持的广告类型：所有广告类型。

相关方法说明： 竞价回传

    //竞价获胜：广告平台（枚举见下节），价格单位：分
    [_yoAd bidWin:YO_PLATFORM_ZongLiang price:adPrice];

    //竞价失败：竟败原因（枚举见下节），广告平台（枚举见下节），价格单位：分
    [_yoAd bidLoss:YO_LOSS_CODE_LOW_PRICE platform:YO_PLATFORM_CSJ price:thirdAdPrice];

广告平台枚举如下：

    /**
     * 纵量
     */
    static NSString *const YO_PLATFORM_ZongLiang = @"ZongLiang";
    /**
     * 穿山甲
     */
    static NSString *const YO_PLATFORM_CSJ = @"csj";
    /**
     * 广点通 或 优量汇
     */
    static NSString *const YO_PLATFORM_GDT = @"gdt";
    /**
     * 快手
     */
    static NSString *const YO_PLATFORM_KuaiShou = @"KuaiShou";
    /**
     * 百度 或 百青藤
     */
    static NSString *const YO_PLATFORM_BaiDu = @"Baidu";
    /**
     * VIVO
     */
    static NSString *const YO_PLATFORM_VIVO = @"vivo";
    /**
     * OPPO
     */
    static NSString *const YO_PLATFORM_OPPO = @"oppo";
    /**
     * 小米
     */
    static NSString *const YO_PLATFORM_XiaoMi = @"XiaoMi";
    /**
     * 华为
     */
    static NSString *const YO_PLATFORM_HuaWei = @"HuaWei";
    /**
     * 京东
     */
    static NSString *const YO_PLATFORM_JingDong = @"JingDong";
    /**
     * SIGMOB
     */
    static NSString *const YO_PLATFORM_SIGMOB = @"Sigmob";
    /**
     * 爱奇艺
     */
    static NSString *const YO_PLATFORM_IQIYI = @"IQiYi";
    /**
     * 阿里妈妈
     */
    static NSString *const YO_PLATFORM_ALIMAMA = @"AliMama";
    /**
     * Tanx
     */
    static NSString *const YO_PLATFORM_Tanx = @"Tanx";
    /**
     * TopOn
     */
    static NSString *const YO_PLATFORM_TopOn = @"TopOn";
    /**
     * PinDuoDuo
     */
    static NSString *const YO_PLATFORM_PinDuoDuo = @"PinDuoDuo";
    /**
     * 其他
     */
    static NSString *const YO_PLATFORM_OTHER = @"other";

竟败原因枚举如下：

    /**
     * 竞争力不足，如不是本次竞价的最高出价方，可上报此竞败原因
     */
    static const NSInteger YO_LOSS_CODE_LOW_PRICE = 1;
    /**
     * 无广告回包，如优在本次竞价中未返回广告，可上报此竞败原因
     */
    static const NSInteger YO_LOSS_CODE_NO_AD = 2;
    /**
     * 有广告回包但是未参与竞价
     */
    static const NSInteger YO_LOSS_CODE_NO_JOIN = 101;
    /**
     * 其他（有回包）
     */
    static const NSInteger YO_LOSS_CODE_OTHER = 10001;

5. 其他API

5.1 SDK版本

    ///获取SDK版本号
    NSInteger sdkVersionCode = [YoMoreAd getSdkVersionCode];

    ///获取SDK版本名称
    NSString* sdkVersionName = [YoMoreAd getSdkVersionName];

6. 错误码

若出现的错误码在找不到，可联系我方。

错误码（code）错误说明（msg）
10700正在初始化，无需重复初始化
10701初始化上下文Context不能为空
10702初始化参数AppId不能为空
10704初始化失败
10800初始化SDK失败
10801代码位不能为空
10802初始化未成功，请检查先调用YoMoreAd.init进行初始化
10812请求参数不完整
10821广告配置参数错误
10823广告配置不可用
10824广告加载参数错误
10825广告加载重复
10826广告配置异常
10827未加载到广告
10828广告组重复加载
10829广告配置异常
10830广告重复加载
10831广告配置异常
10832广告源不存在或初始化异常
10833广告加载超时
10834很抱歉，暂不支持该广告类型
10835未加载到广告
10836广告组未加载到广告
10851广告构建失败
10852无可用广告
10861广告重复展示