横幅广告

横幅广告均为矩形的广告格式，会占据应用版面中的一部分，通常位于屏幕顶部或底部，有时也内嵌在可滚动的内容中。用户与应用互动时，横幅广告始终可见，既不会干扰或打断游戏和使用体验，也可以在指定时间周期后自动刷新。

以下各节将向您介绍如何加载、显示横幅广告。

创建横幅广告

加载插屏广告，首先创建插屏广告实例对象 CTBannerAd ，然后调用其 loadAd 方法。

在加载成功后横幅广告会自动展示，开发者无需手动调用展示。

• Objective-C

#import <CartySDK/CartySDK.h>

self.bannerAd = [[CTBannerAd alloc] init];
self.bannerAd.placementid = @"<your-placement-id>";
self.bannerAd.rootViewController = self;
self.bannerAd.bannerSize = CTBannerSizeType320x50;
self.bannerAd.delegate = self;
self.bannerAd.frame = self.adView.bounds;
[self.adView addSubview:self.bannerAd];

• Swift

import CartySDK

bannerAd = CTBannerAd()
bannerAd.placementid = "<your-placement-id>";
bannerAd.rootViewController = self;
bannerAd.delegate = self;
bannerAd.bannerSize = CTBannerSizeType320x50
bannerAd.frame = adView!.bounds;
adView!.addSubview(bannerAd)

• 支持的 bannerSize 列表

样式	尺寸
CTBannerSizeType320x50	320 x 50
CTBannerSizeType320x100	320 x 100
CTBannerSizeType300x250	300 x 250

实现监听回调

实现 CTBannerAdDelegate 接收广告相关回调通知

• Objective-C

- (void)CTBannerAdDidLoad:(nonnull CTBannerAd *)ad { 
    NSLog(@"加载成功");
}

- (void)CTBannerAdLoadFail:(nonnull CTBannerAd *)ad withError:(nonnull NSError *)error { 
    NSLog(@"加载成功: %@",error.localizedDescription);
}

- (void)CTBannerAdDidShow:(nonnull CTBannerAd *)ad { 
    NSLog(@"展示成功");
}

- (void)CTBannerAdShowFail:(nonnull CTBannerAd *)ad withError:(nonnull NSError *)error { 
    NSLog(@"展示失败: %@",error.localizedDescription);
}

- (void)CTBannerAdDidClick:(nonnull CTBannerAd *)ad {
    NSLog(@"广告已关闭"");
}

- (void)CTBannerAdDidClose:(nonnull CTBannerAd *)ad {
    NSLog(@"广告已关闭");
}

• Swift

func ctBannerAdDidLoad(_ ad: CTBannerAd) {
    print("加载成功")
}
    
func ctBannerAdLoadFail(_ ad: CTBannerAd, withError error: any Error) {
    print("加载失败 \(error.localizedDescription)")
}
    
func ctBannerAdDidShow(_ ad: CTBannerAd) {
    print("展示成功")
}
    
func ctBannerAdShowFail(_ ad: CTBannerAd, withError error: any Error) {
    print("展示失败 \(error.localizedDescription)")
}
    
func ctBannerAdDidClick(_ ad: CTBannerAd) {
    print("广告被点击")
}
    
func ctBannerAdDidClose(_ ad: CTBannerAd) {
    print("广告已关闭")
}

其他

静音设置

需要在加载前设置

• Objective-C

self.bannerAd.isMute = YES;

• Swift

bannerAd.isMute = true

示例

• Swift
• SwiftUI
• Objective-C