
该广告类型支持插屏广告、全屏广告混出,开发者可以选择广告铺开大小:分为全屏和插屏,全屏和插屏场景下开发者都可以选择投放的广告类型,分别为图片+视频、仅视频、仅图片。
注意事项
使用初始化后的TTAdManager对象,创建广告请求对象TTAdNative。
创建广告请求AdSlot,用于请求广告前,传递部分广告配置参数。
方法名 | 说明 |
setCodeId(String codeId) | 聚合广告位ID,聚合场景,需传以1开头的广告位id,SDK内部会自行请求开发者在瀑布流下配置的代码位ID |
setAdCount(int adCount) | 加载广告数,最多不超过3个 |
setOrientation(@TTAdConstant.ORIENTATION_STATE int orientation) | 设置横竖屏,和平台创建的方向保持一致,否则可能展示异常 |
setUserID(String 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回传竞价结果,设置为true后可触发竞价结果回调,在 setBidNotify 设为 true 后触发receiveBidResult,开发者可在该方法中获取竞价结果、价格等信息。 |
setScenarioId(String var1) | 广告场景ID,用于标记该广告所在的业务场景(如某个页面或功能位),非必传 |
方法名 | 说明 |
void setFullScreenVideoAdInteractionListener(FullScreenVideoAdInteractionListener listener) | 注册插屏广告交互回调 |
void showFullScreenVideoAd(Activity activity) | 展示广告 |
void showFullScreenVideoAd(Activity activity, TTAdConstant.RitScenes ritScenes, String scenes) | 展示广告,ritScenes, scenes参数不生效 |
Map<String, Object> getMediaExtraInfo() | 广告额外信息 |
MediationFullScreenManager getMediationManager() | 获取聚合广告信息 |
int getFullVideoAdType() | 广告类型(聚合场景不支持) |
long getExpirationTimestamp() | 过期时间戳(聚合场景不支持) |
int getInteractionType() | 广告的交互类型(聚合场景不支持) |
void setDownloadListener(TTAppDownloadListener listener) | 注册广告的下载回调(聚合场景不支持) |
方法名 | 说明 |
void onFullScreenVideoAdLoad(TTFullScreenVideoAd ad) | 广告加载成功 |
void onFullScreenVideoCached() | 广告视频本地加载完成的回调,即将废弃 |
void onFullScreenVideoCached(TTFullScreenVideoAd ad) | 广告视频本地加载完成的回调 |
void onError(int code, String message) | 广告加载失败 |
为了确保播放流程建议在onFullScreenVideoCached(TTFullScreenVideoAd ad)回调后调用广告展示并判断isReady状态。
方法名 | 说明 |
onAdShow() | 全屏视频广告开始展示时回调,用于曝光统计或埋点 |
onAdVideoBarClick() | 用户点击广告条(视频上方/下方互动区域)时回调,用于点击统计或跳转处理 |
onAdClose() | 用户关闭全屏视频广告时回调,可在此恢复应用界面、释放资源等 |
onVideoComplete() | 视频播放完整结束时回调 |
onSkippedVideo() | 用户跳过视频(未播放完)时回调 |
注意事项:
AdSlot.Builder().setMediationAdSlot(new MediationAdSlot.Builder().setBidNotify(true)后可触发receiveBidResult,开发者可在该方法中获取竞价结果、价格等信息。方法名 | 说明 |
boolean isReady() | 当前广告是否可以展示 |
MediationAdEcpmInfo getShowEcpm() | 为了确保数据的准确性,仅支持广告展示后获取展示广告的详细信息,包括: 广告位类型-getRitType 流量分组ID-getSegmentId、 AB实验分组ID-getABTestId、 渠道名称-getChannel、 子渠道名称-getSubChannel、 场景ID-getScenariold、 价格-getEcpm、 ADN平台-getSdkName |
List<MediationAdLoadInfo> getAdLoadInfo() | load回调后获取广告加载信息 |
boolean hasDislike() | 是否需要Dislike弹窗 |
void setUseCustomVideo(boolean useCustomVideo) | 设置是否是开发者自己进行视频播放,仅支持对外提供视频url的adn,要注意有些adn需要申请白名单 |
void setShakeViewListener(MediationShakeViewListener listener) | 摇一摇监听 |
boolean isExpress() | 是否为模板广告 |
方法名 | 说明 |
Map<String, String> getCustomData() | 自定义参数 |
String getSdkName() | 获取SDK名称 |
String getCustomSdkName() | 获取自定义ADN名称 |
String getSlotId() | 获取代码位ID |
String getLevelTag() | 获取多阶底价标签 |
String getEcpm() | 获取价格 |
int getReqBiddingType() | 获取bidding类型 |
String getErrorMsg() | 获取错误信息 |
String getRequestId() | 获取请求标识 |
String getRitType() | 获取代码位类型 |
String getSegmentId() | 获取流量分组ID |
String getChannel() | 获取渠道 |
String getSubChannel() | 获取子渠道 |
String getAbTestId() | 获取AB测试ID |
String getScenarioId() | 获取场景ID |
已经展示过且不再使用的广告需要在合适的时机调用destroy方法及时对广告进行销毁,避免内存异常场景。
详细示例可参照demo:MediationInterstitialFullActivity类。
在线客服智能客服 7*24小时在线人工客服 工作日 10~12点/14~19点