Menu

ATAdManager (RewardedVideo)

The operation extension for Rewarded Video ads, providing features such as ad display, checking cache, checking whether the ad is ready, and scenario statistics. It also includes the definition of Extra keys.

Copy
/*
 * Third-party extra data
 */
extern NSString *const kATAdLoadingExtraKeywordKey;
extern NSString *const kATAdLoadingExtraUserDataKeywordKey;
extern NSString *const kATAdLoadingExtraUserIDKey;
extern NSString *const kATAdLoadingExtraLocationKey;
extern NSString *const kATAdLoadingExtraRewardNameKey;
extern NSString *const kATAdLoadingExtraRewardAmountKey;

// Klevin SDK
extern NSString *const kATRewardedVideoKlevinRewardTimeKey;
extern NSString *const kATRewardedVideoKlevinRewardTriggerKey;


@interface ATAdManager (RewardedVideo)

/// Display the Rewarded Video ad for this placement
/// @param placementID - TopOn placement ID
/// @param viewController - The window displaying the ad
/// @param delegate - Delegate object
- (void)showRewardedVideoWithPlacementID:(NSString *)placementID
                        inViewController:(UIViewController *)viewController
                                delegate:(id<ATRewardedVideoDelegate>)delegate;

- (void)showRewardedVideoWithPlacementID:(NSString *)placementID
                                  config:(ATShowConfig *)config
                        inViewController:(UIViewController *)viewController
                                delegate:(id<ATRewardedVideoDelegate>)delegate;

/// Display the Rewarded Video ad for this placement
/// @param placementID - TopOn placement ID
/// @param scene - Scenario ID
/// @param viewController - The window displaying the ad
/// @param delegate - Delegate object
- (void)showRewardedVideoWithPlacementID:(NSString *)placementID
                                   scene:(NSString *)scene
                        inViewController:(UIViewController *)viewController
                                delegate:(id<ATRewardedVideoDelegate>)delegate;

/// Check whether the Rewarded Video ad is ready
/// v5.7.06+
- (BOOL)rewardedVideoReadyForPlacementID:(NSString *)placementID;

/// Get the status object ATCheckLoadModel of the current placement
- (nullable ATCheckLoadModel *)checkRewardedVideoLoadStatusForPlacementID:(NSString *)placementID;

/// Query all cache information for the placement
- (nullable NSArray<NSDictionary *> *)getRewardedVideoValidAdsForPlacementID:(NSString *)placementID;

/// Enter the cache status statistics of the current placement in a business scenario
/// @param scene - Ad scenario
/// v5.7.91+
- (void)entryRewardedVideoScenarioWithPlacementID:(NSString *)placementID
                                            scene:(NSString *)scene;


@end
Previous
ATAdManager (Native)
Next
ATAdManager (Splash)
Last modified: 2026-07-08Powered by