菜单

extra参数

1. extra参数

您在加载广告(load)时可以通过向extra字典中传入参数来配置您的广告,对于不同的广告类型,配置的键不同,请您参考下表获取具体配置键的名称及说明。

请注意,您的extra字典值中不应出现对象,请在添加前将其转换为json字符串。

1.1 激励视频广告

所需值类型 说明
kATAdLoadingExtraUserIDKey NSString 用于服务器激励,用户唯一ID
kATAdLoadingExtraRewardNameKey NSString 用于服务器激励,奖励名称
kATAdLoadingExtraRewardAmountKey NSNumber 用于服务器激励,奖励数量
kATRewardedVideoCallbackExtraAdsourceIDKey NSString 激励视频广告源ID
kATRewardedVideoCallbackExtraNetworkIDKey NSString 广告平台Firm Id
kATRewardedVideoKlevinRewardTimeKey NSNumber Klevin SDK相关
kATRewardedVideoKlevinRewardTriggerKey NSNumber Klevin SDK相关

1.2 原生广告

所需值类型 说明
kATExtraInfoNativeAdSizeKey NSValue 模板渲染原生广告尺寸,需要与ATNativeAdView一致
kATExtraNativeImageSizeKey NSString 设置原生广告大图片尺寸,值有下列定义 kATExtraNativeImageSize228_150 kATExtraNativeImageSize690_388 kATExtraNativeImageSize1280_720 kATExtraNativeImageSize1200_628 kATExtraNativeImageSize640_640
kATNativeAdSizeToFitKey BOOL 设置是否自适应高度
kATExtraNativeIconImageSizeKey NSNumber StartApp 相关设置
kATExtraStartAPPNativeMainImageSizeKey NSString StartApp 相关设置

1.3 开屏广告

所需值类型 说明
kATSplashExtraTolerateTimeoutKey NSNumber 超时时间,详见开屏广告接入最佳实践
kATSplashExtraAppLogoImageKey UIImage 仅pangle平台支持,设置logo图片

1.4 插屏广告

所需值类型 说明
kATInterstitialExtraAdSizeKey NSValue 设置插屏广告大小
kATInterstitialExtraUsesRewardedVideo BOOL Sigmob平台,激励视频当做插屏使用

1.5 横幅广告

所需值类型 说明
kATAdLoadingExtraBannerAdSizeKey NSValue 请求的广告尺寸大小,请保持跟后台配置的比例相近
kATAdLoadingExtraBannerSizeAdjustKey BOOL 部分平台用,调节广告尺寸
kATAdLoadingExtraAdmobBannerSizeKey NSValue 仅Admob平台支持,自适应横幅大小
kATAdLoadingExtraAdmobAdSizeFlagsKey NSNumber 仅Admob平台支持,自适应横幅大小

2. 自定义参数

您可以在加载广告时向extra字典中传入自定义参数,或者在展示广告时向ATShowConfigs实例对象中设置自定义参数,并在之后流程的回调中获取它们。下图为您展示了自定义参数的数据流向:

2.1 加载广告时传递自定义数据

请使用 kATAdLoadingExtraMediaExtraKey 键添加,请参考下方代码片段:

复制代码
NSMutableDictionary *extra = [@{
    kATAdLoadingExtraMediaExtraKey:@"your custom data",
} mutableCopy];

2.2 展示广告时传递自定义数据

需要iOS SDK >= 6.3.10

复制代码
ATShowConfig *showConfig = ATShowConfig.new;
showConfig.showCustomExt = @"testShowCustomExt";
showConfig.scene = ...
...
上一个
ATAdManager (Native)
下一个
广告平台SKAdNetwork获取链接
最近修改: 2026-06-22Powered by