Menu

Shared Placement Params

Rewarded Video — Server-Side Reward

If your Rewarded Ad Placement is configured with a shared ad placement, you can refer to the following code to set the server-side reward parameters when loading:

objc Copy
NSMutableDictionary * loadConfigDict = [NSMutableDictionary dictionary];
// kATAdLoadingExtraMediaExtraKey is valid for both shared ad placements and regular ad placements. Use this single key to pass all the parameters you need.
[loadConfigDict setValue:@"{\"userID\":\"xxx\"}" 
// Initiate ad loading
[[ATAdManager sharedManager] loadADWithPlacementID:RewardedPlacementID extra:loadConfigDict delegate:self];

If you need to set parameters specifically for a shared ad placement, please refer to:

objc Copy
NSMutableDictionary * loadConfigDict = [NSMutableDictionary dictionary];
// Optional integration. The following key parameters are used for ad platform server-side reward verification and will be forwarded through to the third-party ad platform SDK.
[loadConfigDict setValue:@"media_val_RewardedVC" forKey:kATAdLoadingExtraMediaExtraKey];
[loadConfigDict setValue:@"rv_test_user_id" forKey:kATAdLoadingExtraUserIDKey];
[loadConfigDict setValue:@"reward_Name" forKey:kATAdLoadingExtraRewardNameKey];
[loadConfigDict setValue:@3 forKey:kATAdLoadingExtraRewardAmountKey];

// Based on your actual needs, decide whether to create a new ATSharePlacementConfig object each time.
if (![ATSDKGlobalSetting sharedManager].sharePlacementConfig) {
    [ATSDKGlobalSetting sharedManager].sharePlacementConfig = [[ATSharePlacementConfig alloc] init];
}
// Set for shared ad placement
[ATSDKGlobalSetting sharedManager].sharePlacementConfig.rewardedVideoLoadExtra = loadConfigDict;
 
// Initiate ad loading
[[ATAdManager sharedManager] loadADWithPlacementID:RewardedPlacementID extra:loadConfigDict delegate:self];
    

Other Scenarios

Setting shared ad placement parameters is generally done before the ad placement load.

objc Copy
#pragma mark - Shared Ad Placement
/// Set shared ad placement extra parameters - Splash Ad
/// - Parameter extraDict: Extra parameters dictionary
+ (void)setSplashSharePlacementConfig:(NSMutableDictionary *)extraDict {
    
    if (![ATSDKGlobalSetting sharedManager].sharePlacementConfig) {
        [ATSDKGlobalSetting sharedManager].sharePlacementConfig = [[ATSharePlacementConfig alloc] init];
    }
    [ATSDKGlobalSetting sharedManager].sharePlacementConfig.splashLoadExtra = extraDict;
}

/// Set shared ad placement extra parameters - Interstitial Ad
/// - Parameter extraDict: Extra parameters dictionary
+ (void)setInterstitialSharePlacementConfig:(NSMutableDictionary *)extraDict {
    
    if (![ATSDKGlobalSetting sharedManager].sharePlacementConfig) {
        [ATSDKGlobalSetting sharedManager].sharePlacementConfig = [[ATSharePlacementConfig alloc] init];
    }
    [ATSDKGlobalSetting sharedManager].sharePlacementConfig.interstitialLoadExtra = extraDict;
}

/// Set shared ad placement extra parameters - Rewarded Video Ad
/// - Parameter extraDict: Extra parameters dictionary
+ (void)setRewardedVideoSharePlacementConfig:(NSMutableDictionary *)extraDict {
    
    if (![ATSDKGlobalSetting sharedManager].sharePlacementConfig) {
        [ATSDKGlobalSetting sharedManager].sharePlacementConfig = [[ATSharePlacementConfig alloc] init];
    }
    [ATSDKGlobalSetting sharedManager].sharePlacementConfig.rewardedVideoLoadExtra = extraDict;
}

/// Set shared ad placement extra parameters - Banner Ad
/// - Parameter extraDict: Extra parameters dictionary
+ (void)setBannerSharePlacementConfig:(NSMutableDictionary *)extraDict {
    
    if (![ATSDKGlobalSetting sharedManager].sharePlacementConfig) {
        [ATSDKGlobalSetting sharedManager].sharePlacementConfig = [[ATSharePlacementConfig alloc] init];
    }
    [ATSDKGlobalSetting sharedManager].sharePlacementConfig.bannerLoadExtra = extraDict;
}

/// Set shared ad placement extra parameters - Native Ad
/// - Parameter extraDict: Extra parameters dictionary
+ (void)setNativeSharePlacementConfig:(NSMutableDictionary *)extraDict {
    
    if (![ATSDKGlobalSetting sharedManager].sharePlacementConfig) {
        [ATSDKGlobalSetting sharedManager].sharePlacementConfig = [[ATSharePlacementConfig alloc] init];
    }
    [ATSDKGlobalSetting sharedManager].sharePlacementConfig.nativeLoadExtra = extraDict;
}
Previous
Baidu Two-Stage Reward
Next
Privacy Policy
Last modified: 2026-07-08Powered by