iOS SDK接入文档
2026-02-06
版本说明
| 版本 | 更新内容 | 更新时间 |
|---|---|---|
| 2.0.1.0 | 建议全部升级 【新增】广告视图升级 【新增】SDK包名变更 【修复】已知问题修复 | 2026.03.20 |
| 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方式【推荐】
- 在podfile文件中加入以下代码:
pod 'YoAdCore' # 建议指定最新版本- 项目根目录，执行
pod install
1.1.2 本地导入方式
将纵量广告提供的SDK压缩包解压
将其中所有 framework 和 bundle 放入自己项目文件夹下
YoAdCore.xcframework
YoAdCoreResources.bundle1.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);
}
@end3.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);
}
@end3.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);
}
@end3.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);
}
@end3.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);
}
@end3.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;
}
@end4. 实时竞价
支持的广告类型：所有广告类型。
相关方法说明： 竞价回传
//竞价获胜：广告平台（枚举见下节），价格单位：分
[_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 | 广告重复展示 |