Clone wiki

AATKit iOS / Promo_screen

Using a Promo Screen


  1. Project Setup
  2. AATKit Initialisation
  3. Banner Integration
  4. Fullscreen Integration
  5. APP Open Integration
  6. Native Ads Integration
  7. Native Ads Integration - special ad network characteristics
  8. Promo Screen
  9. Sample
  10. Disable App Transport Security (ATS)
  11. Advanced Features
  12. Targeting
  13. Rewarded Video
  14. Frequency Capping
  15. Header documentation
  16. Important Remarks
  17. AATKit's Size within your app
  18. What is an AdSpace?
  19. Network-specific Information
  20. Listen to impression level information
  21. AATKit AdMob custom events adapter (>= 2.77.x)

AATKit Changelogs

Active promo settings in the AddApptr dashboard

Before you can configure promo placements in the AddApptr dashboard, please contact the AddApptr support under Otherwise the Promotion menu will not be visible in the dashboard.

Screen Shot 2016-08-18 at 10.22.31.png

What is a promo screen?

A promo screen is a special fullscreen placement which can be configured separately on the AddApptr dashboard. This means it can have its own separate set of rules that determine which ad networks are shown on this placement. You can configure a promo placement on the tab Promotion in the AddApptr dashboard.

Screen Shot 2016-06-29 at 08.24.10.png

Correct promo placement workflow


The image shows the intended workflow for promo placements. Promo placements are supposed to be shown right at the start of your app. When looking at the details, a promo Interstitial must not be shown as the very first appearance of your app. Also it must not be shown right after the first view controller (e.g. main menu) of your app is presented. A promo placement has be presented between your app's splash screen and your first view controller (main menu).

Special behaviour for app startup

Please do not use the method enablePromo anymore, as it might disturb your user's experience.

Please note:

After the initial startup, a promo screen is only shown once every 60 minutes of the app being in memory. Also, a promo is only shown if it's coming from the background. When a promo is presented, the next one gets loaded immediately. This is the default behaviour, which can be overruled by the following method:

+ (bool) showPromo: (bool) force;

More specifically when calling it like this:


[AATKit showPromo: YES];
Calling the method showPromo with an argument of YES, overrules the 60 minute restriction and shows a promo placement immediately (if it has loaded an ad).

Handling a promo screen similar to a fullscreen placement

In case you want to handle a promo screen similar to a fullscreen placement you can use the following methods:

+ (void) preparePromo;
By calling the method [AATKit preparePromo], a fullscreen placement is created, and loading is started automatically. When an ad is loaded in this placement, the callback - (void) AATKitHaveAd:(id) placement; is invoked. When an ad is loaded, you can call the method [AATKit showPromo: NO]; in order to present it. You have to call [AATKit preparePromo] again in order to load another fullscreen ad on the promo placement.

The method + (bool) showPromo: (bool) force; allows you to show a promo placement only once within 60 minutes, unless, you enforce showing a promo screen by setting the argument force to YES.

Example workflow for reusing a promo

In case a promo could not be loaded in time to be presented at your app's startup, you can reuse the promo adspace, at the next opportunity.


- (BOOL) showPromoOrInterstitialPlacement:(id) placement {
    if ( ! [AATKit showPromo:NO] ) {
        return [AATKit showPlacement: placement];
    } else {
        return YES;
func showPromoOrInterstitial(placement: AATKitPlacement) -> Bool {
    if !AATKit.showPromo(false) {
    } else {
        return true

#back (Native Ads Integration - special characteristics)### #next (Sample)