iOS SDK 使用说明

#import <AdtalosAdKit/AdtalosAdKit.h>

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

    // 创建配置
    AdtalosConfiguration *config = [[AdtalosConfiguration alloc]
        initWithToken:@"媒体 Token"
             appToken:@"应用 Token"
                 idfa:@""
                caids:@[
                    [[AdtalosCaid alloc]
                        initWithCaid:@"Caid"
                             version:@"version"],
                    [[AdtalosCaid alloc]
                        initWithCaid:@"Caid"
                             version:@"version"]
                ]];

    // 初始化SDK
    [AdtalosSDK initialize:config];

    return YES;
}

// 测试广告位: 5DDF6A347D99DA1D426625E847513D6F
@interface ViewController () <AdtalosListener>
@property (nonatomic, strong) AdtalosSplashAd *splashAd;
@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    self.splashAd = [[AdtalosSplashAd alloc] initWithUnitID:@"广告位 TOKEN"];
    self.splashAd.listener = self;
    self.splashAd.autoRetry = 0;  //自动重试次数，详情见文档末尾说明
    [self.splashAd load];
}

- (void)onRendered {
    // 显示广告
    [self.splashAd show];
}

- (void)onClosed {
    if (self.splashAd) {
        //销毁广告
        [self.splashAd destroy];
        self.splashAd = nil;
    }
}

- (void)dealloc {
    if (self.splashAd) {
        //销毁广告
        [self.splashAd destroy];
        self.splashAd = nil;
    }
}

@end

// 测试广告位: 828C5CDAA5CE4772970BEB29416FA6B4
@interface ViewController () <AdtalosListener>
@property (nonatomic, strong) AdtalosInterstitialAd *interstitialAd;
@end

@implementation ViewController

- (void)loadInterstitialAd {
    self.interstitialAd = [[AdtalosInterstitialAd alloc] initWithUnitID:@"广告位 TOKEN"];
    self.interstitialAd.listener = self;
    [self.interstitialAd load];
}

- (void)onLoaded {
    // 显示广告
    [self.interstitialAd show];
}

- (void)onClosed {
    if (self.interstitialAd) {
        //销毁广告
        [self.interstitialAd destroy];
        self.interstitialAd = nil;
    }
}

- (void)dealloc {
    if (self.interstitialAd) {
        //销毁广告
        [self.interstitialAd destroy];
        self.interstitialAd = nil;
    }
}

@end

// 测试广告位: C5DC50CE250B45F11BB5A70AE8BC557E
@interface ViewController () <AdtalosListener, AdtalosRewardVideoListener>
@property (nonatomic, strong) AdtalosRewardVideoAd *rewardVideoAd;
@end

@implementation ViewController

- (void)loadRewardVideoAd {
    self.rewardVideoAd = [[AdtalosRewardVideoAd alloc] initWithUnitID:@"广告位 TOKEN"];
    self.rewardVideoAd.listener = self;
    self.rewardVideoAd.videoListener = self;
    [self.rewardVideoAd load];
}

- (void)onLoaded {
    // 显示广告
    [self.rewardVideoAd show];
}

- (void)onRewarded:(NSString *)data {
    // 处理激励事件
    NSLog(@"激励数据: %@", data);
}

- (void)onClosed {
    if (self.rewardVideoAd) {
        //销毁广告
        [self.rewardVideoAd destroy];
        self.rewardVideoAd = nil;
    }
}

- (void)dealloc {
    if (self.rewardVideoAd) {
        //销毁广告
        [self.rewardVideoAd destroy];
        self.rewardVideoAd = nil;
    }
}

@end

// 测试广告位: 65F7C6A0A01358281D08D5781C5CB718
@interface ViewController () <AdtalosListener>
@property (nonatomic, strong) AdtalosBannerAd *bannerAd;
@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    // 创建横幅广告，指定位置
    self.bannerAd = [[AdtalosBannerAd alloc] init:CGPointMake(0, 50)
                                           unitID:@"广告位 TOKEN"];
    self.bannerAd.listener = self;
    [self.bannerAd load];
}

// 广告加载完成
- (void)onLoaded {
}

// 广告渲染完成
- (void)onRendered {
  // 显示广告
    UIView *adView = self.bannerAd.view;
    if (adView) {
        [self.view addSubview:adView];
    }
}

- (void)dealloc {
    if (self.bannerAd) {
        [self.bannerAd destroy];
        self.bannerAd = nil;
    }
}

@end

// 测试广告位: 7E6DF6872DD50BF85A8C07700E9C4C5B
@interface FeedViewController () <AdtalosListener>
@property (nonatomic, strong) AdtalosFeedAd *feedAd;
@end

@implementation FeedViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    self.feedAd = [[AdtalosFeedAd alloc] init:CGPointMake(0, 0)
                                       unitID:@"广告位 TOKEN"];
    self.feedAd.listener = self;
    [self.feedAd load];
}

- (void)onLoaded {
    // 显示广告
    UIView *adView = self.feedAd.view;
    if (adView) {
        [self.containerView addSubview:adView];
    }
}

- (void)onRendered {
    // 广告渲染完成
}

- (void)dealloc {
    if (self.feedAd) {
        [self.feedAd destroy];
        self.feedAd = nil;
    }
}

@end

@protocol AdtalosListener <NSObject>

@optional
// 请求广告前触发。
- (void)onBeforeRequest;

// 当广告加载完毕后触发。
- (void)onLoaded;

// 当广告加载失败后触发。
- (void)onFailedToLoad:(NSError *)error;

// 当广告渲染完毕后触发。
- (void)onRendered;

// 当广告展示完毕后触发。
- (void)onShown;

// 当广告中的有效连接被点击时触发。
- (void)onClicked;

// 当用户点击打开其他应用（如外部浏览器、Deeplink等），从而当前应用在后台运行时触发。
- (void)onLeftApplication;

// 当广告关闭时触发。
- (void)onClosed;

@end

@protocol AdtalosRewardVideoListener <AdtalosListener>

@optional
// 当激励发生时触发。
- (void)onRewarded:(NSString *)data;

@end

@protocol AdtalosVideoListener <NSObject>

@optional
// 视频加载时触发
- (void)onVideoLoad:(AdtalosVideoMetadata *)metadata;

// 开始播放视频
- (void)onVideoStart;

// 视频播放中
- (void)onVideoPlay;

// 视频暂停
- (void)onVideoPause;

// 视频播放结束
- (void)onVideoEnd;

// 视频音量变化
// @param volume, 音量值 (0.0 - 1.0)
// @param muted, 是否静音
- (void)onVideoVolumeChange:(double)volume muted:(BOOL)muted;

// 视频播放进度更新
// @param currentTime, 当前播放时间（秒）
// @param duration, 视频总时长（秒）
- (void)onVideoTimeUpdate:(double)currentTime duration:(double)duration;

// 视频播放错误
- (void)onVideoError;

// 视频播放中断
- (void)onVideoBreak;

@end

// 销毁广告
- (void)destroy;

// 暂停广告（仅横幅和信息流广告）
- (void)pause;

// 恢复广告（仅横幅和信息流广告）
- (void)resume;

#import <AppTrackingTransparency/AppTrackingTransparency.h>
#import <AdSupport/AdSupport.h>

- (void)requestIDFA {
    if (@available(iOS 14, *)) {
        [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {
            NSString *idfa = @"";
            if (status == ATTrackingManagerAuthorizationStatusAuthorized) {
                idfa = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
            }
            // 使用 idfa 初始化 SDK
            AdtalosConfiguration *config = [[AdtalosConfiguration alloc]
                initWithToken:@"媒体 Token"
                     appToken:@"应用 Token"
                         idfa:idfa
                        caids:@[]];
            [AdtalosSDK initialize:config];
        }];
    } else {
        // iOS 14 以下版本直接获取
        NSString *idfa = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
        AdtalosConfiguration *config = [[AdtalosConfiguration alloc]
            initWithToken:@"媒体 Token"
                 appToken:@"应用 Token"
                     idfa:idfa
                    caids:@[]];
        [AdtalosSDK initialize:config];
    }
}

@interface FeedViewController () <UITableViewDelegate, UITableViewDataSource>
@property (nonatomic, strong) NSMutableDictionary<NSNumber *, AdtalosFeedAd *> *feedAds;
@property (nonatomic, strong) NSMutableSet<NSNumber *> *visibleAdPositions;
@end

@implementation FeedViewController

- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath {
    if ([self isAdPosition:indexPath.row]) {
        NSInteger adPosition = [self adPositionIndexForRow:indexPath.row];
        NSNumber *positionKey = @(adPosition);

        // 直接从广告视图获取实时高度
        AdtalosFeedAd *feedAd = self.feedAds[positionKey];
        if (feedAd && feedAd.isLoaded && feedAd.view) {
            CGFloat height = feedAd.view.frame.size.height;
            if (height > 0) {
                return height;
            }
        }
        return 0.0;  // 广告未加载时返回 0
    }
    return 100.0;  // 普通 cell 高度
}

// 监听广告视图尺寸变化，更新 cell 高度
- (void)feedAdCell:(FeedAdCell *)cell didUpdateAdViewSize:(CGSize)size {
    NSIndexPath *indexPath = [self.tableView indexPathForCell:cell];
    if (indexPath) {
        // 使用 beginUpdates 和 endUpdates 来平滑更新高度
        [self.tableView beginUpdates];
        [self.tableView endUpdates];
    }
}

// 滚动结束时，更新可见广告列表，销毁超出屏幕的广告
- (void)scrollViewDidEndDecelerating:(UIScrollView *)scrollView {
    [self updateVisibleAds];
}

- (void)updateVisibleAds {
    NSArray *visibleIndexPaths = [self.tableView indexPathsForVisibleRows];
    NSMutableSet *newVisibleAds = [NSMutableSet set];

    // 收集当前可见的广告位置
    for (NSIndexPath *indexPath in visibleIndexPaths) {
        if ([self isAdPosition:indexPath.row]) {
            NSInteger pos = [self adPositionIndexForRow:indexPath.row];
            [newVisibleAds addObject:@(pos)];
        }
    }

    // 销毁离开屏幕的广告
    for (NSNumber *pos in self.visibleAdPositions) {
        if (![newVisibleAds containsObject:pos]) {
            [self destroyAdAtPosition:pos.integerValue];
        }
    }

    self.visibleAdPositions = newVisibleAds;
}

- (void)destroyAdAtPosition:(NSInteger)position {
    NSNumber *positionKey = @(position);
    AdtalosFeedAd *feedAd = self.feedAds[positionKey];

    if (feedAd) {
        // 先清理 listener，避免回调访问已销毁的实例
        feedAd.listener = nil;
        feedAd.videoListener = nil;
        [feedAd destroy];
        [self.feedAds removeObjectForKey:positionKey];
    }
}

@end