开屏广告

开屏广告是一种全屏的广告形式，可以在用户将应用切换到前台运行时展示（即冷热启动时）。

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

加载广告

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

• Objective-C

#import <CartySDK/CartySDK.h>

self.openAd = [[CTAppOpenAd alloc] init];
self.openAd.placementid = @"<your-placement-id>";
self.openAd.delegate = self;
[self.openAd loadAd];

• Swift

import CartySDK

openAd = CTAppOpenAd()
openAd.placementid = "<your-placement-id>"
openAd.delegate = self
openAd.load()

实现监听回调

Implement CTAppOpenAdDelegate to listen to presentation events. The following code shows how to implement the protocol and assign it to the ad:

• Objective-C

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

- (void)CTOpenAdLoadFail:(nonnull CTAppOpenAd *)ad withError:(nonnull NSError *)error {
    NSLog(@"加载失败: %@",error.localizedDescription);
}

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

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

- (void)CTOpenAdDidClick:(nonnull CTAppOpenAd *)ad {
    NSLog(@"广告被点击");
}

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

• Swift

func ctOpenAdDidLoad(_ ad: CTAppOpenAd) {
    print("加载成功")
}
    
func ctOpenAdLoadFail(_ ad: CTAppOpenAd, withError error: any Error) {
    print("加载失败 \(error.localizedDescription)")
}
    
func ctOpenAdDidShow(_ ad: CTAppOpenAd) {
    print("展示成功")
}
    
func ctOpenAdShowFail(_ ad: CTAppOpenAd, withError error: any Error) {
    print("展示失败 \(error.localizedDescription)")
}
    
func ctOpenAdDidClick(_ ad: CTAppOpenAd) {
    print("广告被点击")
}
    
func ctOpenAdDidDismiss(_ ad: CTAppOpenAd) {
    print("广告已关闭")
}

展示广告

调用 CTAppOpenAd 的 showAd 方法来展示广告

• Objective-C

if(self.openAd.isReady)
{
    [self.openAd showAd:self];
}

• Swift

if(openAd.isReady())
{
   	openAd.show(self)
}

其他

静音设置

需要在加载前设置

• Objective-C

self.openAd.isMute = YES;

• Swift

openAd.isMute = true

示例

• Swift
• SwiftUI
• Objective-C