App Open Ads

App Open ad is a type of mobile advertisement designed to appear when a user opens a mobile app. These ads are full-screen and are typically displayed in a transition moment, such as when an app is launched or brought to the foreground.

The following sections show you how to load and then show an app open ad.

Load an ad

To load an App open ad, instantiate an CTAppOpenAd object that corresponds to your ad unit and call its loadAd method

• 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()

Register for Callbacks

Implement CTAppOpenAdDelegate to listen to ad events.

• Objective-C

- (void)CTOpenAdDidLoad:(nonnull CTAppOpenAd *)ad {
    NSLog(@"Ad loaded");
}

- (void)CTOpenAdLoadFail:(nonnull CTAppOpenAd *)ad withError:(nonnull NSError *)error {
    NSLog(@"Ad load fail: %@",error.localizedDescription);
}

- (void)CTOpenAdDidShow:(nonnull CTAppOpenAd *)ad {
    NSLog(@"Ad did show");
}

- (void)CTOpenAdShowFail:(nonnull CTAppOpenAd *)ad withError:(nonnull NSError *)error {
    NSLog(@"Ad show fail: %@",error.localizedDescription);
}

- (void)CTOpenAdDidClick:(nonnull CTAppOpenAd *)ad {
    NSLog(@"Ad did click");
}

- (void)CTOpenAdDidDismiss:(nonnull CTAppOpenAd *)ad {
    NSLog(@"Ad did close");
}

• Swift

func ctOpenAdDidLoad(_ ad: CTAppOpenAd) {
    print("Ad loaded")
}
    
func ctOpenAdLoadFail(_ ad: CTAppOpenAd, withError error: any Error) {
    print("Ad load fail \(error.localizedDescription)")
}
    
func ctOpenAdDidShow(_ ad: CTAppOpenAd) {
    print("Ad did show")
}
    
func ctOpenAdShowFail(_ ad: CTAppOpenAd, withError error: any Error) {
    print("Ad show fail \(error.localizedDescription)")
}
    
func ctOpenAdDidClick(_ ad: CTAppOpenAd) {
    print("Ad did click")
}
    
func ctOpenAdDidDismiss(_ ad: CTAppOpenAd) {
    print("Ad did close")
}

Display the ad

To show an App open ad, call showAd on the CTAppOpenAd object that you instantiated:

• Objective-C

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

• Swift

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

Other

Mute

Make sure make this call before load

• Objective-C

self.openAd.isMute = YES;

• Swift

openAd.isMute = true

Examples on GitHub

• Swift
• SwiftUI
• Objective-C