Rewarded Ads

Rewarded ads are full-screened image or video ads that rewards users for viewing the ad.

Implementing View Controller

In the view controller that will present the ad view as subview,

• add this property

  GFPRewardedAdManager *adManager

• and implement this delegate protocol

  GFPRewardedAdManagerDelegate

Objective-C

// MyViewController.h

@import GFPSDK;

@interface MyViewController : UIViewController <GFPRewardedAdManagerDelegate>

@property (nonatomic) GFPRewardedAdManager *adManager;

@end

Swift

// MyViewController.h

import GFPSDK

class MyViewController : UIViewController, GFPRewardedAdManagerDelegate {
    private var adManager : GFPRewardedAdManager?
}

GFPRewardedAdManager

Initializing GFPRewardedAdManager

Initialize GFPRewardedAdManager in your view controller, say, in viewDidLoad:.

• Provide GFPRewardedAdManager with video ad Ad Unit ID (essential) as registered on GFP dashboard, UIView to enclose video view, and GFPAdParam (optional) for better ad performance.

• Set GFPRewardedAdManagerDelegate to GFPRewardedAdManager

danger

Use GFPRewardedAdManager instance for only single ad request, than create another for the next ad request. It is designed to manage the life cycle of only single ad.

Objective-C

- (void)viewDidLoad {
    [super viewDidLoad];

    GFPAdParam *adParam = [[GFPAdParam alloc]init];
    adParam.yearOfBirth = 1990;
    adParam.gender = GFPAdParamGenderTypeMale;
    ...

    self.adManager = [[GFPRewardedAdManager alloc] initWithUnitID:@"UnitID" adParam:adParam];               
    self.adManager.delegate = self;
    self.adManager.requestTimeoutInterval = 60;
}

Swift

override func viewDidLoad() {
    super.viewDidLoad()
        
    let adParam = GFPAdParam()
    adParam.yearOfBirth = 1990
    adParam.gender = .male
    ...
    
    self.adManager = GFPRewardedAdManager(unitID: "UnitID", adParam: adParam)
    self.adManager?.delegate = self
    self.adManager?.requestTimeoutInterval = 60
}

Loading Ad

danger

Since AppLovin and IronSource runs on a singleton to for loading ads, you can preload only one ad at a time, per Ad Unit ID.

Objective-C

[self.adManager load];

Swift

self.adManager?.load()

Showing Ad

On succefully loading ad, GFPRewardedAdManagerDelegates provides ad through rewardedAdManager:didLoadAd:.

Than show the rewarded ad at the desired moment, using GFPRewardedAdManager show:

Loaded ads don't have to be shown as soon as being loaded. Thus, preload ads for app's performance.

Be mindful, though, that loaded ads are valid for a only limited time. ex) for DFP, FAN: 60 mins.

Objective-C

[self.adManager show:self];

Swift

self.adManager?.show(self)

Resuming Video Ad

For S2S rewarded video ads, if rewarded ad's viewController is presented by super-viewController's present: method, the video is paused by default.

Video must be resumed manually through the GFPRewardedAdMananger by,

Objective-C

[GFPRewardedAdManager resumeCurrentRewardVideo];

Swift

GFPRewardedAdManager.resumeCurrentRewardVideo()

Additional Configurations

Ad Request Timeout (per GFPRewardedAdManager)

Set timeout (seconds) for ad requests. GFPInterstitialAdManager will call rewardedAdManager:didFailWithError:responseInfo: on timeout. Default is 60 seconds.

Objective-C

self.adManager.requestTimeoutInterval = ...

Swift

self.adManager?.requestTimeoutInterval = ...

Ad Request Timeout (global configuration on GFPAdManager)

Set global interstitial timeout (seconds) for ad requests. GFPRewardedAdManager will call rewardedAdManager:didFailWithError:responseInfo: on timeout. Default is 60 seconds.

Objective-C

[GFPAdManager adConfiguration].rewardedAdRequestTimeout = ...

Swift

GFPAdManager.adConfiguration().rewardedAdRequestTimeout = ...

GFPRewardedAdManagerDelegate

Load Events

On Load Success

Objective-C

- (void)rewardedAdManager:(nonnull GFPRewardedAdManager *)manager didLoadAd:(nonnull GFPRewardedAd *)rewardedAd {
    ...
}

Swift

func rewardedAdManager(_ manager: GFPRewardedAdManager, didLoad rewardedAd: GFPRewardedAd) {
     ...
}

On Load Failure

rewardedAdMananger:didFailWithError emits ad load failure, show errors, valid timeout, etc.

Objective-C

- (void)rewardedAdManager:(nonnull GFPRewardedAdManager *)manager didFailWithError:(nonnull GFPError *)error responseInfo:(nullable GFPLoadResponseInfo *)responseInfo {
	...
}

Swift

 func rewardedAdManager(_ manager: GFPRewardedAdManager, didFailWithError error: GFPError, responseInfo:GFPLoadResponseInfo!) {
	...   
}
    

LifeCycle Events

On Start Showing Ad

Objective-C

- (void)rewardedAdManager:(nonnull GFPRewardedAdManager *)manager didStartAd:(nonnull GFPRewardedAd *)rewardedAd {
	...
}

Swift

func rewardedAdManager(_ manager: GFPRewardedAdManager, didStart rewardedAd: GFPRewardedAd) {
	...
}
    

On Rewarding

Objective-C

- (void)rewardedAdManager:(nonnull GFPRewardedAdManager *)manager didCompleteAd:(nonnull GFPRewardedAd *)rewardedAd withReward:(nullable GFPReward *)reward {
	...
}

Swift

func rewardedAdManager(_ manager: GFPRewardedAdManager, didComplete rewardedAd: GFPRewardedAd, with reward: GFPReward?) {
	...
}    

FAN and some ad networks does not emit GFPReward, thus, nil is returned instead.

On Dismiss

Objective-C

- (void)rewardedAdManager:(nonnull GFPRewardedAdManager *)manager didCloseAd:(nonnull GFPRewardedAd *)rewardedAd {
...
}

Swift

func rewardedAdManager(_ manager: GFPRewardedAdManager, didClose rewardedAd: GFPRewardedAd) {
	...
}    

On Click

Objective-C

- (void)rewardedAdManager:(nonnull GFPRewardedAdManager *)manager wasClickedAd:(nonnull GFPRewardedAd *)rewardedAd {
	...
}

Swift

func rewardedAdManager(_ manager: GFPRewardedAdManager, wasClickedAd rewardedAd: GFPRewardedAd) {
	...
}
    

info

For Google DFP = 7.X.X click events are not supported.