Skip to main content

Rewarded Ads

1. Load an ad​

  • Loading ads requires some time, so it is recommended to pre-load the ads before displaying them.
  • AdUnitID is the Ad Unit ID created in the TradPlus backend. SDK will fetch the configuration and request ads according to the Ad Unit ID.
#import <TradPlusAds/TradPlusAdRewarded.h>
self.rewardedVideoAd = [[TradPlusAdRewarded alloc] init];
[self.rewardedVideoAd setAdUnitID:@"Your Ad Unit ID"];
self.rewardedVideoAd.delegate = self;
[self.rewardedVideoAd loadAd];

2. Show RewardVideo Ad​

  • Call the isAdReady method to check if there is an available ad. When there is an available ad, call the showAdWithSceneId： method to display the ad.
  • SceneId is the Ad Scene ID. The default is nil. 
if (self.rewardedVideoAd.isAdReady)
{
	[self.rewardedVideoAd showAdWithSceneId:nil];
}

3. Register TradPlusADRewardedDelegate Callback​

  • Ad event callbacks need to be registered before displaying an ad. Get callbacks for ad loading, ad show, ad click, ad close, etc.
//Ad loaded successfully. Callback when the first ad source is loaded successfully. The loading process will only be called once.
- (void)tpRewardedAdLoaded:(NSDictionary *)adInfo;

//Ad loading failed
//tpRewardedAdOneLayerLoad:didFailWithError：returns the error message of the third-party source
- (void)tpRewardedAdLoadFailWithError:(NSError *)error;

//Ad show succeeded. Valid show recognized by the third party
- (void)tpRewardedAdImpression:(NSDictionary *)adInfo;

//Ad show failed
- (void)tpRewardedAdShow:(NSDictionary *)adInfo didFailWithError:(NSError *)error;

//Ad clicked
- (void)tpRewardedAdClicked:(NSDictionary *)adInfo;

//Ad closed
- (void)tpRewardedAdDismissed:(NSDictionary *)adInfo;

//Reward completed
- (void)tpRewardedAdReward:(NSDictionary *)adInfo;

4. Server-side Reward Verification​

  • TPSDK will pass it to the third-party SDK through this API.
// @param userID user unique identifier, required
// @param customData additional information, fill in according to platform requirements
- (void)setServerSideVerificationOptionsWithUserID:(nonnull NSString *)userID customData:(nullable NSString *)customData;

5. Integration Reference​

Reference: TradPlusAdRewardedViewController