Menu

Shared Placement Parameter Settings

Rewarded Video —— Server-Side Reward

If your Rewarded Video placement is configured with a shared 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 effective for both shared placements and regular placements. Use only this one key to pass all the parameters you need.
[loadConfigDict setValue:@"{\"userID\":\"xxx\"}" 
// Initiate ad load
[[ATAdManager sharedManager] loadADWithPlacementID:RewardedPlacementID extra:loadConfigDict delegate:self];

If you need to set parameters for the shared placement separately, refer to the following:

objc Copy
NSMutableDictionary * loadConfigDict = [NSMutableDictionary dictionary];
// Optional integration. The following key parameters are applicable to the ad network's server-side reward verification and will be passed through to the third-party ad network 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];

// Depending 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 the shared placement
[ATSDKGlobalSetting sharedManager].sharePlacementConfig.rewardedVideoLoadExtra = loadConfigDict;
 
// Initiate ad load
[[ATAdManager sharedManager] loadADWithPlacementID:RewardedPlacementID extra:loadConfigDict delegate:self];
    

Other Scenarios

Setting shared placement parameters is generally done before loading the placement.

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

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

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

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

/// Set extra parameters for shared placement - Native Ad
/// - Parameter extraDict: Extra parameter dictionary
+ (void)setNativeSharePlacementConfig:(NSMutableDictionary *)extraDict {
    
    if (![ATSDKGlobalSetting sharedManager].sharePlacementConfig) {
        [ATSDKGlobalSetting sharedManager].sharePlacementConfig = [[ATSharePlacementConfig alloc] init];
    }
    [ATSDKGlobalSetting sharedManager].sharePlacementConfig.nativeLoadExtra = extraDict;
}
Previous
Debug Mode Parameter List
Next
Unity Guide
Last modified: 2026-07-08Powered by