您在加载广告(load)时可以通过向extra字典中传入参数来配置您的广告,对于不同的广告类型,配置的键不同,请您参考下表获取具体配置键的名称及说明。
请注意,您的extra字典值中不应出现对象,请在添加前将其转换为json字符串。
| 键 | 所需值类型 | 说明 |
|---|---|---|
| kATAdLoadingExtraUserIDKey | NSString | 用于服务器激励,用户唯一ID |
| kATAdLoadingExtraRewardNameKey | NSString | 用于服务器激励,奖励名称 |
| kATAdLoadingExtraRewardAmountKey | NSNumber | 用于服务器激励,奖励数量 |
| kATRewardedVideoCallbackExtraAdsourceIDKey | NSString | 激励视频广告源ID |
| kATRewardedVideoCallbackExtraNetworkIDKey | NSString | 广告平台Firm Id |
| kATRewardedVideoKlevinRewardTimeKey | NSNumber | Klevin SDK相关 |
| kATRewardedVideoKlevinRewardTriggerKey | NSNumber | Klevin SDK相关 |
| 键 | 所需值类型 | 说明 |
|---|---|---|
| kATExtraInfoNativeAdSizeKey | NSValue | 模板渲染原生广告尺寸,需要与ATNativeAdView一致 |
| kATExtraNativeImageSizeKey | NSString | 设置原生广告大图片尺寸,值有下列定义 kATExtraNativeImageSize228_150 kATExtraNativeImageSize690_388 kATExtraNativeImageSize1280_720 kATExtraNativeImageSize1200_628 kATExtraNativeImageSize640_640 |
| kATNativeAdSizeToFitKey | BOOL | 设置是否自适应高度 |
| kATExtraNativeIconImageSizeKey | NSNumber | StartApp 相关设置 |
| kATExtraStartAPPNativeMainImageSizeKey | NSString | StartApp 相关设置 |
| 键 | 所需值类型 | 说明 |
|---|---|---|
| kATSplashExtraTolerateTimeoutKey | NSNumber | 超时时间,详见开屏广告接入最佳实践 |
| kATSplashExtraAppLogoImageKey | UIImage | 仅pangle平台支持,设置logo图片 |
| 键 | 所需值类型 | 说明 |
|---|---|---|
| kATInterstitialExtraAdSizeKey | NSValue | 设置插屏广告大小 |
| kATInterstitialExtraUsesRewardedVideo | BOOL | Sigmob平台,激励视频当做插屏使用 |
| 键 | 所需值类型 | 说明 |
|---|---|---|
| kATAdLoadingExtraBannerAdSizeKey | NSValue | 请求的广告尺寸大小,请保持跟后台配置的比例相近 |
| kATAdLoadingExtraBannerSizeAdjustKey | BOOL | 部分平台用,调节广告尺寸 |
| kATAdLoadingExtraAdmobBannerSizeKey | NSValue | 仅Admob平台支持,自适应横幅大小 |
| kATAdLoadingExtraAdmobAdSizeFlagsKey | NSNumber | 仅Admob平台支持,自适应横幅大小 |
您可以在加载广告时向extra字典中传入自定义参数,或者在展示广告时向ATShowConfigs实例对象中设置自定义参数,并在之后流程的回调中获取它们。下图为您展示了自定义参数的数据流向:

请使用 kATAdLoadingExtraMediaExtraKey 键添加,请参考下方代码片段:
NSMutableDictionary *extra = [@{
kATAdLoadingExtraMediaExtraKey:@"your custom data",
} mutableCopy];
需要iOS SDK >= 6.3.10
ATShowConfig *showConfig = ATShowConfig.new;
showConfig.showCustomExt = @"testShowCustomExt";
showConfig.scene = ...
...