“穿山甲广告” 的使用：开屏、banner、激励广告等

穿山甲广告：官方网站文档

穿山甲及广告位ID：创建穿山甲应用和广告位

我公司之前使用的是广点通广告，但是在点击变现时，穿山甲变现的更多，所以公司要求在我们项目中接入穿山甲替换掉原来的广点通 ，

下面就是我在网上找到的iOS APP接入穿山甲文档：

Podfile文件：

#（穿山甲.广告）
#SDK版本 >=3.4.0.0
pod 'Ads-CN' # (4.0.0.5)
#SDK版本 <3.4.0.0
pod 'Bytedance-UnionAD' #  (3.3.6.2)

相关链接：
CocosCreator接入穿山甲SDK(IOS)--激励视屏
Creator iOS接入穿山甲SDK
首先介绍一下

.m文件与.mm文件有什么区别
.m文件 支持C ,OC
.mm文件 支持C,C++,OC

OC 与 TS 互调，例子有很多，比如官方的例子里面就有
TS 调用OC的时候有个点 初学者可能有点懵

//错误示例
//oc中代码  微信分享图片 
+(void) wxShareImage:(NSString*) filepath : (NSString*) title : (const int) target
{

}
//上述写法在OC中并不报错 但是在TS中我们调用OC代码时就会出现参数错误的问题
//TS代码调用
jsb.reflection.callStaticMethod("AppController","wxShareImage:",filePath,title,target);


//正确示例
+(void) wxShareImage:(NSString*) filepath titleStr : (NSString*) title targetInter : (const int) target
{
    
}
//你可能会想什么是titleStr 字符串 targetInter 整型，其实它的可选字符串可以帮助我们阅读和理解方法，尤其是当方法被调用的时候。
//这两个字段就是代表可选字段,用来帮助我们理解的，OC代码记得写上，并与JS代码配合好就可以了
//TS代码调用
jsb.reflection.callStaticMethod("AppController","wxShareImage:titleStr:targetInter:",filePath,title,target);
//无参示范
jsb.reflection.callStaticMethod("AppController","wxShareImage");
//一个参数示范
jsb.reflection.callStaticMethod("AppController","wxShareImage:","参数1");

下面开始接入穿山甲SDK
然后先根据官方文档配置环境
假设出现库引入了，但是代码不出提示，或者报错，可以点击Finder --> 前往 -->按住options 点击出现的隐藏文件资源库 --> Developer -->xcode
清除掉里面的缓存文件夹，关闭xcode,再次打开，如果还是报错，自行检查了

注意：在使用cocoapods导入SDK时，`Bytedance-UnionAD

我导入了好几次，其中几次都是因为从github`下载文件太大，而导致错误，好在最后导入进去了。遇到同样问题的童鞋~可以多试几次。

穿山甲SDK初始化

    //在AppController.mm文件中的didFinishLaunchingWithOptions方法中调用
    //穿山甲SDK初始化
    [BUAdSDKManager setAppID:@"应用ID"];
    [BUAdSDKManager setLoglevel:BUAdSDKLogLevelDebug];
    [BUAdSDKManager setIsPaidApp:NO];

1.激励视频广告

//TTRewardVideoAd.h头文件
@interface TTRewardVideoAd : UIViewController
{
    
}

+(TTRewardVideoAd*) getInstance;
-(void) ShowRewardVideoAd:(NSString *) adId;


@end

//
//  TTRewardVideoAd.mm
//
//
//  Created by Jaymz on 2020/7/18.
//
#import "TTRewardVideoAd.h"
#import 
#import 
#import 
#import 
#import "CallJS.h" 
//CallJS.h 这个是我自己封装的调用JS的类

@interface TTRewardVideoAd()
@property (nonatomic, strong) BUNativeExpressRewardedVideoAd *rewardedVideoAd;
@end

static TTRewardVideoAd* m_instance;
@implementation TTRewardVideoAd

    
-(void)viewDidLoad
{
    [super viewDidLoad];
    m_instance = self;
    NSLog(@"viewDidLoad");
}

+(TTRewardVideoAd*) getInstance
{
    if (m_instance == NULL)
    {
        NSLog(@"获取m_instance失败");
    }
    return m_instance;
}

//拉起视频广告
-(void) ShowRewardVideoAd:(NSString *)slotID
{
    slotID = @"xxxxxx";  //广告ID
    NSLog(@"ShowRewardVideoAd Call !!!");
    BURewardedVideoModel *model = [[BURewardedVideoModel alloc] init];
    model.userId = @"jaymz";
    self.rewardedVideoAd = [[BUNativeExpressRewardedVideoAd alloc] initWithSlotID:slotID rewardedVideoModel:model];
    self.rewardedVideoAd.delegate = self;
    [self.rewardedVideoAd loadAdData];
    NSLog(@"ShowRewardVideoAd over!!");
}

//需要获取到显示在最上面的viewController
- (UIViewController *)theTopviewControler{
    //获取根控制器
    UIViewController *rootVC = [[UIApplication sharedApplication].delegate window].rootViewController;
    
    UIViewController *parent = rootVC;
    //遍历 如果是presentViewController
    while ((parent = rootVC.presentedViewController) != nil ) {
        rootVC = parent;
    }
   
    while ([rootVC isKindOfClass:[UINavigationController class]]) {
        rootVC = [(UINavigationController *)rootVC topViewController];
    }
    return rootVC;
}

-(void) showRewardVideoAd
{
    NSLog(@"展示奖励视频广告");
    if(self.rewardedVideoAd.isAdValid)
    {
       [self.rewardedVideoAd showAdFromRootViewController:[self theTopviewControler]];
    }
}

#pragma mark - BUNativeExpressRewardedVideoAdDelegate
//加载广告的时候，delegate 传的是self，广告事件发生后会自动回调回来，我们只需要重新实现这些方法即可
- (void)nativeExpressRewardedVideoAdDidLoad:
(BUNativeExpressRewardedVideoAd *)rewardedVideoAd {
    NSLog(@"%s",__func__);
    [self showRewardVideoAd]; //记载完毕的回调，在这里做显示
}

- (void)nativeExpressRewardedVideoAd:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd didFailWithError:(NSError *_Nullable)error {
    NSLog(@"%s",__func__);
    NSLog(@"error code : %ld , error message : %@",(long)error.code,error.description);
}

- (void)nativeExpressRewardedVideoAdCallback:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd withType:(BUNativeExpressRewardedVideoAdType)nativeExpressVideoType{
    NSLog(@"%s",__func__);
}

- (void)nativeExpressRewardedVideoAdDidDownLoadVideo:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd {
    NSLog(@"%s",__func__);
}

- (void)nativeExpressRewardedVideoAdViewRenderSuccess:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd {
    NSLog(@"%s",__func__);
}

- (void)nativeExpressRewardedVideoAdViewRenderFail:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd error:(NSError *_Nullable)error {
    NSLog(@"%s",__func__);
    NSLog(@"视频广告渲染错误");
    [CallJS callJsEngineCallBack:@"window.AdMrg.VideoAdFail":@"广告播放错误"];
}

- (void)nativeExpressRewardedVideoAdWillVisible:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd {
    NSLog(@"%s",__func__);
}

- (void)nativeExpressRewardedVideoAdDidVisible:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd {
    NSLog(@"%s",__func__);
}

- (void)nativeExpressRewardedVideoAdWillClose:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd {
    NSLog(@"%s",__func__);
}

- (void)nativeExpressRewardedVideoAdDidClose:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd {
    NSLog(@"%s",__func__);
    NSLog(@"看完广告返回 发放奖励");
    [CallJS callJsEngineCallBack:@"window.AdMrg.VideoAdFinish":@""];
}

- (void)nativeExpressRewardedVideoAdDidClick:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd {
    NSLog(@"%s",__func__);
    NSLog(@"加载激励视频错误");
    [CallJS callJsEngineCallBack:@"window.AdMrg.VideoAdFail":@"广告播放错误"];
}

- (void)nativeExpressRewardedVideoAdDidClickSkip:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd {
    NSLog(@"%s",__func__);
}

- (void)nativeExpressRewardedVideoAdDidPlayFinish:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd didFailWithError:(NSError *_Nullable)error {
    NSLog(@"%s",__func__);
}

- (void)nativeExpressRewardedVideoAdServerRewardDidSucceed:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd verify:(BOOL)verify {
    NSLog(@"%s",__func__);
}

- (void)nativeExpressRewardedVideoAdServerRewardDidFail:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd {
    NSLog(@"%s",__func__);
}

- (void)nativeExpressRewardedVideoAdDidCloseOtherController:(BUNativeExpressRewardedVideoAd *)rewardedVideoAd interactionType:(BUInteractionType)interactionType {
    NSString *str = nil;
    if (interactionType == BUInteractionTypePage) {
        str = @"ladingpage";
    } else if (interactionType == BUInteractionTypeVideoAdDetail) {
        str = @"videoDetail";
    } else {
        str = @"appstoreInApp";
    }
    NSLog(@"%s __ %@",__func__,str);
}

@end

添加上述代码后 还需要在AppController.mm的didFinishLaunchingWithOptions方法中添加
（后续所有广告都要这样操作，这里只写这个典型了）

    //记得在初始化SDK之后，_viewController初始化之后
    UIViewController *rewardVideoAd = [[TTRewardVideoAd alloc] init];
    [_viewController.view addSubview:rewardVideoAd.view];

2.插屏广告

//插屏广告（非信息流形式，采用模版渲染）
//
//  TTExpressInsertAd.h
//  
//
//  Created by Jaymz on 2020/7/18.
//

@interface TTExpressInsertAd : UIViewController
{
    
}

+(TTExpressInsertAd*) getInstance;
-(void) ShowExpressInsertAd:(NSString *) adId;
@end

//
//  TTExpressInsertAd.mm
//
//  Created by Jaymz on 2020/7/23.
//

#import 
#import "TTExpressInsertAd.h"
#import 


@interface TTExpressInsertAd()
@property (nonatomic, strong) BUNativeExpressInterstitialAd *interstitialAd;
@end

static TTExpressInsertAd* m_instance;

@implementation TTExpressInsertAd

-(void)viewDidLoad
{
    [super viewDidLoad];
    m_instance = self;
    NSLog(@"viewDidLoad");
}

- (void)viewWillLayoutSubviews
{
    [super viewWillLayoutSubviews];
}

+(TTExpressInsertAd*) getInstance
{
    return m_instance;
}

-(void) ShowExpressInsertAd:(NSString *) slotID
{
    slotID = @"945341872";//945341872
    NSLog(@"ShowExpressInsertAd!!");
    //NSValue *sizeValue = [self.sizeDict objectForKey:slotID];
    CGSize size = CGSizeMake(300, 450);
    CGFloat width = CGRectGetWidth([UIScreen mainScreen].bounds)-40;
    CGFloat height = width/size.width*size.height;
    NSLog(@"width : %f  height : %f",width,height);
    //#warning 升级的用户请注意，初始化方法去掉了imgSize参数
    self.interstitialAd = [[BUNativeExpressInterstitialAd alloc] initWithSlotID:slotID adSize:CGSizeMake(width, height)];
    self.interstitialAd.delegate = self;
    [self.interstitialAd loadAdData];
}

- (void)showInterstitial
{
    NSLog(@"showIntersitial call %d",self.interstitialAd.adValid);
    if (self.interstitialAd)
    {
        NSLog(@"展示插屏广告 showInterstitial");
        [self.interstitialAd showAdFromRootViewController:[self theTopviewControler]];
    }
}

- (UIViewController *)theTopviewControler{
    //获取根控制器
    UIViewController *rootVC = [[UIApplication sharedApplication].delegate window].rootViewController;
    
    UIViewController *parent = rootVC;
    //遍历 如果是presentViewController
    while ((parent = rootVC.presentedViewController) != nil ) {
        rootVC = parent;
    }
   
    while ([rootVC isKindOfClass:[UINavigationController class]]) {
        rootVC = [(UINavigationController *)rootVC topViewController];
    }
    return rootVC;
}

#pragma ---BUNativeExpresInterstitialAdDelegate
- (void)nativeExpresInterstitialAdDidLoad:(BUNativeExpressInterstitialAd *)interstitialAd {
    NSLog(@"%s",__func__);
}

- (void)nativeExpresInterstitialAd:(BUNativeExpressInterstitialAd *)interstitialAd didFailWithError:(NSError *)error {
    NSLog(@"%s",__func__);
}

- (void)nativeExpresInterstitialAdRenderSuccess:(BUNativeExpressInterstitialAd *)interstitialAd {
    NSLog(@"%s",__func__);
    [self showInterstitial];
    //这个插屏广告不能放在加载完毕中，加载完毕广告组件adValid = 0,问了官方才知道要在这里加，文档上跟demo里都是在加载回调，坑
}

- (void)nativeExpresInterstitialAdRenderFail:(BUNativeExpressInterstitialAd *)interstitialAd error:(NSError *)error {
    NSLog(@"%s",__func__);
    NSLog(@"error code : %ld , error message : %@",(long)error.code,error.description);
}

- (void)nativeExpresInterstitialAdWillVisible:(BUNativeExpressInterstitialAd *)interstitialAd {
    NSLog(@"%s",__func__);
}

- (void)nativeExpresInterstitialAdDidClick:(BUNativeExpressInterstitialAd *)interstitialAd {
    NSLog(@"%s",__func__);
}

- (void)nativeExpresInterstitialAdWillClose:(BUNativeExpressInterstitialAd *)interstitialAd {
    NSLog(@"%s",__func__);
}

- (void)nativeExpresInterstitialAdDidClose:(BUNativeExpressInterstitialAd *)interstitialAd {
    NSLog(@"%s",__func__);
}

- (void)nativeExpresInterstitialAdDidCloseOtherController:(BUNativeExpressInterstitialAd *)interstitialAd interactionType:(BUInteractionType)interactionType {
    NSString *str = nil;
    if (interactionType == BUInteractionTypePage) {
        str = @"ladingpage";
    } else if (interactionType == BUInteractionTypeVideoAdDetail) {
        str = @"videoDetail";
    } else {
        str = @"appstoreInApp";
    }
    NSLog(@"%s __ %@",__func__,str);
}

@end

3.Banner广告

//
//  TTBannerAd.h
//
//  Created by Jaymz on 2020/7/24.


@interface TTBannerAd : UIViewController
{
    
}

+(TTBannerAd*) getInstance;
-(void) ShowBannerAd:(NSString *) adId;
-(void) HideBannerAd;

@end

//
//  TTBannerAd.mm
//
//  Created by Jaymz on 2020/7/24.
//

#import 
#import "TTBannerAd.h"
#import 

@interface TTBannerAd()
@property (nonatomic, strong) BUNativeExpressBannerView *bannerView;
@end

static TTBannerAd* m_instance;

@implementation TTBannerAd

+(TTBannerAd*) getInstance
{
    return m_instance;
}

-(void) viewDidLoad
{
    [super viewDidLoad];
    m_instance = self;
    NSLog(@"BannerViewDidLoad");
}

-(void) ShowBannerAd:(NSString *)slotID
{
    NSLog(@"展示bannerAd");
    slotID = @"945344475";
    [self.bannerView removeFromSuperview];
    CGSize size = CGSizeMake(600,150);
    CGFloat screenWidth = CGRectGetWidth([UIScreen mainScreen].bounds);
    CGFloat bannerHeigh = screenWidth/size.width*size.height;//banner按缩放比例变化
    BOOL isOpenRotate = NO; //是否轮转 如果开启后30s后会自动再次加载banner,不做限制的话，会出现bannerAd已经被关闭，但是又被加载出来
    CGFloat screenHeight = CGRectGetHeight([UIScreen mainScreen].bounds);//获取到屏幕高度
    #warning 升级的用户请注意，初始化方法去掉了imgSize参数
    if (isOpenRotate)
    {
        self.bannerView = [[BUNativeExpressBannerView alloc] initWithSlotID:slotID rootViewController:self adSize:CGSizeMake(screenWidth, bannerHeigh) IsSupportDeepLink:YES interval:30]; //设置间隔30s?
    } else {
        self.bannerView = [[BUNativeExpressBannerView alloc] initWithSlotID:slotID rootViewController:self adSize:CGSizeMake(screenWidth, bannerHeigh) IsSupportDeepLink:YES];
    }
    self.bannerView.frame = CGRectMake(0, screenHeight - bannerHeigh - 10, screenWidth, bannerHeigh);
    //self.bannerView.frame = CGRectMake(0, 10, screenWidth, bannerHeigh);
    self.bannerView.delegate = self;
    [self.bannerView loadAdData];
}

-(void) showBanner
{
    NSLog(@"加载banner完成，开始展示");
    [self.view addSubview:self.bannerView];
}

-(void) HideBannerAd
{
    NSLog(@"关闭BannerAd");
    [self.bannerView removeFromSuperview]; //字面意思像删除操作
}

- (UIViewController *)theTopviewControler{
    //获取根控制器
    UIViewController *rootVC = [[UIApplication sharedApplication].delegate window].rootViewController;
    
    UIViewController *parent = rootVC;
    //遍历 如果是presentViewController
    while ((parent = rootVC.presentedViewController) != nil ) {
        rootVC = parent;
    }
   
    while ([rootVC isKindOfClass:[UINavigationController class]]) {
        rootVC = [(UINavigationController *)rootVC topViewController];
    }
    return rootVC;
}

#pragma BUNativeExpressBannerViewDelegate
- (void)nativeExpressBannerAdViewDidLoad:(BUNativeExpressBannerView *)bannerAdView {
    NSLog(@"%s",__func__);
    [self showBanner];
}

- (void)nativeExpressBannerAdView:(BUNativeExpressBannerView *)bannerAdView didLoadFailWithError:(NSError *)error {
    NSLog(@"%s",__func__);
    NSLog(@"error code : %ld , error message : %@",(long)error.code,error.description);
}

- (void)nativeExpressBannerAdViewRenderSuccess:(BUNativeExpressBannerView *)bannerAdView {
    NSLog(@"%s",__func__);
}

- (void)nativeExpressBannerAdViewRenderFail:(BUNativeExpressBannerView *)bannerAdView error:(NSError *)error {
    NSLog(@"%s",__func__);
}

- (void)nativeExpressBannerAdViewWillBecomVisible:(BUNativeExpressBannerView *)bannerAdView {
    NSLog(@"%s",__func__);
}

- (void)nativeExpressBannerAdViewDidClick:(BUNativeExpressBannerView *)bannerAdView {
    NSLog(@"%s",__func__);
}

- (void)nativeExpressBannerAdView:(BUNativeExpressBannerView *)bannerAdView dislikeWithReason:(NSArray *)filterwords {
    NSLog(@"%s",__func__);
    [UIView animateWithDuration:0.25 animations:^{
        bannerAdView.alpha = 0;
    } completion:^(BOOL finished) {
        [bannerAdView removeFromSuperview];
        self.bannerView = nil;
    }];
}

- (void)nativeExpressBannerAdViewDidCloseOtherController:(BUNativeExpressBannerView *)bannerAdView interactionType:(BUInteractionType)interactionType {
    NSString *str = nil;
    if (interactionType == BUInteractionTypePage) {
        str = @"ladingpage";
    } else if (interactionType == BUInteractionTypeVideoAdDetail) {
        str = @"videoDetail";
    } else {
        str = @"appstoreInApp";
    }
    NSLog(@"%s __ %@",__func__,str);
}

@end

4.开屏广告

//
//  TTSplashAd.h
//
//  Created by Jaymz on 2020/7/24.
//

@interface TTSplashAd : UIViewController
{
    
}

+(TTSplashAd*) getInstance;
-(void) ShowSplashAd:(NSString *) adId;
@end

//
//  TTSplashAd.mm
//
//  Created by Jaymz on 2020/7/24.
//

#import 
#import "TTSplashAd.h"
#import 

@interface TTSplashAd()
@property (nonatomic, strong) BUSplashAdView *splashView;
@end

static TTSplashAd* m_instance;

@implementation TTSplashAd

+(TTSplashAd*) getInstance
{
    return m_instance;
}

-(void)viewDidLoad
{
    [super viewDidLoad];
    m_instance = self;
    NSLog(@"viewDidLoad");
}

-(void) ShowSplashAd:(NSString *)adId
{
    NSLog(@"调用开屏广告展示");
    CGRect frame=[UIScreen mainScreen].bounds;
    BUSplashAdView *splashView = [[BUSplashAdView alloc] initWithSlotID:adId frame:frame];
    //yyyyyyyyyy是你在穿山甲后台对应的广告位Id
    splashView.delegate = self;
    UIWindow *keyWindow =[UIApplication sharedApplication].windows.firstObject;
    [splashView loadAdData];
    [keyWindow.rootViewController.view addSubview:splashView];
    splashView.rootViewController = keyWindow.rootViewController;
}

#pragma mark --Splash Delegate
- (void)splashAdDidLoad:(BUSplashAdView *)splashAd {
    NSLog(@"splashAdDidLoad");
    NSLog(@"mediaExt-%@",splashAd.mediaExt);
}

- (void)splashAdDidClose:(BUSplashAdView *)splashAd {
    NSLog(@"splashAdView AdDidClose");
    [splashAd removeFromSuperview];
}

- (void)splashAd:(BUSplashAdView *)splashAd didFailWithError:(NSError *)error {
    NSLog(@"splashAdView load data fail");
    [splashAd removeFromSuperview];
    NSLog(@"error code : %ld , error message : %@",(long)error.code,error.description);
}

- (void)splashAdDidCloseOtherController:(BUSplashAdView *)splashAd interactionType:(BUInteractionType)interactionType {
    NSString *str = @"";
    if (interactionType == BUInteractionTypePage) {
        str = @"ladingpage";
    } else if (interactionType == BUInteractionTypeVideoAdDetail) {
        str = @"videoDetail";
    } else {
        str = @"appstoreInApp";
    }
    //弹窗提示
//    #pragma clang diagnostic push
//    #pragma clang diagnostic ignored"-Wdeprecated-declarations"
//        UIAlertView *alert = [[UIAlertView alloc] initWithTitle:str message:[NSString stringWithFormat:@"%s",__func__] delegate:self cancelButtonTitle:nil otherButtonTitles:@"ok", nil];
//        [alert show];
//    #pragma clang diagnostic pop
}

- (void)didReceiveMemoryWarning {
    [super didReceiveMemoryWarning];
    // Dispose of any resources that can be recreated.
}


@end

开屏广告需要在AppController.mm的didFinishLaunchingWithOptions函数中，app->start(); 之前调用

    UIViewController *splashAd = [[TTSplashAd alloc] init];
    [_viewController.view addSubview:splashAd.view];
    [[TTSplashAd getInstance] ShowSplashAd:@"开屏广告ID"]; //展示开屏广告