Skip to content

开屏广告

WARNING

请在广告初始化成功后调用, 另外所有API请在UI线程中调用。

创建广告

使用开屏广告时,先创建开屏广告对象:VX_SplashAd

objc
VX_SplashAd *splashAd = [[VX_SplashAd alloc] init];
[splashAd setSplashOrientation:UIInterfaceOrientationPortrait]; //设置开屏广告横竖屏

设置广告回调

开屏广告在加载、播放、 关闭、点击等时机,都会通过监听VX_SplashAdDelegate,通知给游戏层:

objc

@interface AdViewController()<VX_SplashAdDelegate>
    //...
@end

@implementation AdViewController

- (void)vxAdSplashDidClicked {
    // 广告被点击
}

- (void)vxAdSplashDidClosed {
    // 广告被关闭
}

- (void)vxAdSplashDidFailed:(VXAdErrorCode)code withMessage:(NSString *)message {
    // 广告播放失败
}

- (void)vxAdSplashDidLoaded {
    // 广告加载成功回调

    [self.splashAd showAdWithController:self];
}

- (void)vxAdSplashDidShow {
    // 广告曝光成功
}

- (void)vxAdSplashDidSkipped {
    // 广告跳过
}

- (void)vxAdSplashDidLoadFailed:(VXAdErrorCode)code withMessage:(nonnull NSString *)message { 
    // 广告加载失败
}

@end


// 设置回调
[splashAd setDelegate:self];

加载广告

设置好监听器类后, 在需要的时机可以加载开屏广告:

objc
[splashAd loadAdWithUnitId:adId controller:self];

参数说明:

参数名称参数类型参数说明
adIdString聚合SDK后台创建的聚合广告位ID,如果还没创建,可以参考文档:获取广告参数
controllerUIViewController当前游戏调用广告的宿主Controller

广告加载成功, 会触发上面监听器中的vxAdSplashDidLoaded事件; 加载失败, 会触发上面监听器中的vxAdSplashDidLoadFailed事件。

播放广告

广告加载成功后, 就可以在玩家点击广告播放按钮时,进行播放了:

objc
if ([splashAd isAdReady]) {
    [splashAd showAdWithController:self];
}

建议调用播放之前, 先通过isAdReady函数判断当前广告是否就绪, 如果就绪再播放。

版权所有© 2021-2030 上海丞诺网络科技有限公司