方法名

说明

setCodeId(String codeId)

聚合广告位ID

setOrientation(@TTAdConstant.ORIENTATION_STATE int orientation)

设置横竖屏方向

setUserID(String userID)

用户唯一标识，使用服务端奖励验证回调，当达到奖励下发条件后穿山甲会通过开发者提供的回调链接透传开发者请求广告时传入的userId，开发者服务端判断是否下发奖励

setMediationAdSlot(MediationAdSlot mediationAdSlot)

设置聚合广告请求参数

方法名

说明

setMuted(boolean var1)

设置静音

setVolume(float var1)

设置音量范围0~1；静音设置为0

setUseSurfaceView(boolean var1)

是否使用SurfaceView

setExtraObject(String var1, Object var2)

设置额外参数

setBidNotify(boolean var1)

bidding类型广告，竞价成功或者失败后是否通知对应的ADN

setScenarioId(String var1)

广告场景ID

setRewardName(String var1)

设置激励名称

setRewardAmount(int var1)

设置激励金额

方法名

说明

void onRewardVideoAdLoad(TTRewardVideoAd ad)

加载完成的回调

void onRewardVideoCached()

广告视频本地加载完成的回调，即将废弃

void onRewardVideoCached(TTRewardVideoAd ad)

广告视频本地加载完成的回调

void onError(int code, String message)

加载失败回调

方法名

说明

void setRewardAdInteractionListener(RewardAdInteractionListener listener)

设置激励事件监听

void setRewardPlayAgainInteractionListener(RewardAdInteractionListener listener)

再看一个功能(7200及以上废弃)

void showRewardVideoAd(Activity activity)

展示激励广告

Map<String, Object> getMediaExtraInfo()

返回广告额外信息

void showRewardVideoAd(Activity activity, TTAdConstant.RitScenes ritScenes, String scenes)

展示广告，ritScenes, scenes参数不生效

MediationRewardManager getMediationManager()

获取聚合广告信息

long getExpirationTimestamp()

过期时间戳（聚合场景不支持）

int getRewardVideoAdType()

广告真实类型（聚合场景不支持）

void setShowDownLoadBar(boolean showDownLoadBar)

聚合场景不支持

int getInteractionType()

广告交互类型（聚合场景不支持）

void setDownloadListener(TTAppDownloadListener listener)

注册广告的下载回调（聚合场景不支持）

void setRewardPlayAgainController(RewardAdPlayAgainController listener)

再看一个功能控制器(7200及以上废弃)

方法名

说明

void onAdShow()

广告展示

void onAdVideoBarClick()

广告的下载bar点击回调

void onAdClose()

广告关闭的回调

void onVideoComplete()

视频播放完毕的回调

void onVideoError()

视频播放失败的回调

void onRewardArrived(boolean isRewardValid, int rewardType, Bundle extraInfo)

激励视频播放完毕，验证是否有效发放奖励的回调

方法名

说明

boolean isReady()

当前广告是否可以展示

MediationAdEcpmInfo getShowEcpm()

获取展示广告的详细信息

List <MediationAdLoadInfo> getAdLoadInfo()

load回调后获取广告加载信息

void destroy()

广告销毁

方法名

返回值

说明

getCustomData()

Map<String, String>

自定义参数集合，一般用于透传额外业务字段（如服务端回调、自定义统计等）

getSdkName()

String

实际投放所用广告 SDK 名称，如穿山甲、GDT 等，用于识别当前流量来自哪个广告源

getCustomSdkName()

String

自定义的 ADN 名称（如在聚合侧自定义的别名），用于区分同一厂商下的不同接入或做自定义标记

getSlotId()

String

实际展示广告使用的代码位 ID，一般对应各 ADN 后台的广告位标识

getLevelTag()

String

多阶底价标签/阶梯价标签，用于标记当前展示走的是哪一档价格策略

getEcpm()

String

当前展示广告的 eCPM（单位通常为分），可用于收入与比价分析

getReqBiddingType()

int

请求的竞价类型（如普通、Bidding），具体枚举需结合文档查看

getErrorMsg()

String

如本次加载/竞价存在错误，这里返回对应的错误信息或原因描述

getRequestId()

String

当前广告请求的唯一标识 ID，便于日志排查与联调定位问题

getRitType()

String

广告位类型（如开屏、激励视频、插屏、信息流等）的标识，用于区分不同广告形态

getSegmentId()

String

流量分组 ID，用于区分不同实验组、用户分群或分流策略

getChannel()

String

渠道信息（如应用分发渠道、推广渠道等），便于按渠道维度统计与分析

getSubChannel()

String

子渠道信息，相比 channel 更细粒度的分渠道标识

getAbTestId()

String

AB 实验 ID，用于标记当前请求命中了哪个 AB 实验方案

getScenarioId()

String

场景 ID，用于标记该广告所在的业务场景（如某个页面或功能位）

getSubRitType()

String

子广告位类型/更细颗粒的广告形态标识，用于在同一大类广告内做进一步区分