
draw视频广告的展示场景一般在应用的视频流中进行展示,广告内容与应用其他内容区分开,防止意外点击。
注意事项
使用初始化后的TTAdManager对象,创建广告请求对象TTAdNative。
AdSlot用于请求广告前,传递部分广告配置参数。
方法名 | 说明 |
setCodeId(String codeId) | 聚合广告位ID,聚合广告位,聚合场景,需传以1开头的广告位id,SDK内部会自行请求开发者在瀑布流下配置的代码位ID |
setAdCount(int adCount) | 加载广告数,最多不超过3个 |
setImageAcceptedSize(int width, int height) | 自渲染设置宽高,单位px |
setExpressViewAcceptedSize(float width, float height) | 模板设置宽高,单位dp |
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 |
setScenarioId(String var1) | 广告场景ID |
接入方可调用 loadDrawFeedAd(adSlot, new TTAdNative.DrawFeedAdListener() 异步加载广告。
注意:点击事件注册时机在广告render之前,否则会影响展示、点击的数据上报。
方法名 | 说明 |
onError(int var1, String var2) | 加载 Draw 信息流广告失败时回调 |
onDrawFeedAdLoad(List<TTDrawFeedAd> var1) | Draw 信息流广告加载成功时回调 |
为了确保播放流程,建议在广告加载成功 onDrawFeedAdLoad(List<TTDrawFeedAd> list) 回调后调用广告展示并判断 isReady 状态。模板类型需调用render()进行广告渲染;
方法名 | 说明 |
String getTitle() | 广告标题 |
String getDescription() | 广告描述 |
String getButtonText() | 广告创意按钮文案 |
int getAppScore() | 广告app评分 |
String getSource() | 广告来源 |
List getImageList() | 广告图片Image list,返回的list可能为0个 |
int getInteractionType() | 原生广告交互类型 |
int getImageMode() | 原生广告图片模式 |
ComplianceInfo getComplianceInfo() | 应用下载相关信息 |
TTAdDislike getDislikeDialog(Activity activity) | 得到Dislike dialog,建议传当前activity,否则可能会影响dislike对话框弹出 |
DownloadStatusController getDownloadStatusController() | 下载状态控制器 |
void registerViewForInteraction(...) | 自渲染交互注册入口 |
void setDownloadListener(TTAppDownloadListener downloadListener) | 设置下载监听器 |
View getAdView() | 模板类型获取广告View |
Map<String, Object> getMediaExtraInfo() | 返回广告额外信息 |
void render() | 渲染模板广告,渲染成功后通过getAdView()可获取到渲染成功的广告 |
void setExpressRenderListener(ExpressRenderListener expressRenderListener) | 设置模板渲染回调监听 |
void setDislikeCallback(...) | 设置dislike监听 |
void destroy() | 资源释放 |
MediationNativeManager getMediationManager() | 获取聚合广告信息 |
void setVideoAdListener(VideoAdListener videoAdListener) | 设置Video监听 |
CustomizeVideo getCustomVideo() | 自渲染信息流广告,开发者可自定义播放器 |
方法名 | 说明 |
void onVideoLoad(TTFeedAd ad); | 视频广告加载成功 |
void onVideoError(int errorCode, int extraCode) | 视频播放失败 |
void onVideoAdStartPlay(TTFeedAd ad) | 视频广告开始播放 |
void onVideoAdPaused(TTFeedAd ad) | 视频广告暂停 |
void onVideoAdContinuePlay(TTFeedAd ad) | 视频广告继续播放 |
void onProgressUpdate(long current, long duration) | 视频广告播放进度 |
void onVideoAdComplete(TTFeedAd ad) | 视频广告播放完成 |
获取合规信息五要素
方法名 | 说明 |
String getAppName() | 获取AppName |
String getAppVersion() | 获取应用版本 |
String getDeveloperName() | 获取开发者名称 |
String getPrivacyUrl() | 获取隐私协议 |
Map<String, String> getPermissionsMap() | 获取权限名称及权限描述列表 |
String getPermissionUrl() | 获取权限列表url |
方法名 | 说明 |
void showDislikeDialog() | 展示Dislike dialog |
void setDislikeInteractionCallback(DislikeInteractionCallback dislikeInteractionCallback) | 设置Dislike选中时的回调 |
void setDislikeSource(String dislikeSource) | 设置Dislike的来源(聚合场景不支持) |
void resetDislikeStatus() | 重置Dislike状态(聚合场景不支持) |
boolean isShow() | 当前是否显示(聚合场景不支持) |
方法名 | 说明 |
void onSelected(int position, String value, boolean enforce) | 选择原因,enforce无效默认false |
void onShow() | Dislike show |
void onCancel() | 点击取消 |
方法名 | 说明 |
void changeDownloadStatus() | 在未点击创意按钮开始下载时调用,则会无效、在正在下载中调用,则会暂停下载 【正在下载】-->【暂停下载】,在暂停时调用,则会继续下载 【暂停下载】-->【继续下载】 |
void cancelDownload() | 取消当前下载任务 |
方法名 | 说明 |
void onDownloadActive(long totalBytes, long currBytes, String fileName, String appName) | 下载中回调; totalBytes :安装包总字节数, -1 :未知 currBytes :当前已下载的字节数 fileName :下载的文件名称,无效时为空 appName :下载的app名称,无效时为空 |
void onDownloadPaused(long totalBytes, long currBytes, String fileName, String appName) | 下载暂停回调; totalBytes :安装包总字节数, -1 :未知 currBytes :当前已下载的字节数 fileName :下载的文件名称,无效时为空 appName :下载的app名称,无效时为空 |
void onDownloadFailed(long totalBytes, long currBytes, String fileName, String appName) | 下载失败回调; totalBytes :安装包总字节数, -1 :未知 currBytes :当前已下载的字节数 fileName :下载的文件名称,无效时为空 appName :下载的app名称,无效时为空 |
void onDownloadFinished(long totalBytes, String fileName, String appName) | 下载完成回调; totalBytes :安装包总字节数, -1 :未知 currBytes :当前已下载的字节数 fileName :下载的文件名称,无效时为空 appName :下载的app名称,无效时为空 |
void onInstalled(String fileName, String appName) | 安装完成回调; fileName :下载的文件名称,无效时为空 appName :下载的app名称,无效时为空 |
方法名 | 说明 |
void onRenderSuccess(View view, float width, float height, boolean isExpress) | 模板渲染成功 |
void onRenderFail(View view, String msg, int code) | 渲染失败 |
void onAdClick() | 点击回调 |
void onAdShow() | 展示回调 |
方法名 | 说明 |
void onAdClicked(View view, TTNativeAd ad) | 广告点击的回调,View 无效返回值为null |
void onAdCreativeClick(View view, TTNativeAd ad) | 创意广告点击回调,View 无效返回值为null |
void onAdShow(TTNativeAd ad) | 广告展示回调,每个广告仅回调一次 |
方法名 | 说明 |
String getVideoUrl() | 视频类型的视频URL |
void reportVideoStart() | 播放开始 |
void reportVideoPause(long playingTime) | 播放暂停 |
void reportVideoContinue(long playingTime) | 播放继续 |
void reportVideoFinish() | 播放结束 |
void reportVideoBreak(long playingTime) | 播放终止 |
void reportVideoAutoStart() | 自动播放 |
void reportVideoStartError(int errorCode, int extra) | 起播错误 |
void reportVideoError(long playingTime, int errorCode, int extra) | 播放中错误 |
方法名 | 说明 |
titleId(final int titleId) | 广告标题对应控件的ID |
logoLayoutId(final int logoLayoutId) | 广告logo |
groupImage1Id(final int groupImage1Id) | 组图ID |
groupImage2Id(final int groupImage2Id) | 组图ID |
groupImage3Id(final int groupImage3Id) | 组图ID |
mainImageId(final int mediaLayoutId) | 广告大图对应控件的ID |
sourceId(final int sourceId) | 广告来源对于控件的ID |
mediaViewIdId(final int mediaViewId) | 广告视频对于控件的ID(视频类才需要传递) |
descriptionTextId(final int textId) | 广告描述对应控件的ID |
callToActionId(final int callToActionId) | 广告创意按钮(如下载,查看详情等)对应控件的ID |
iconImageId(final int iconImageId) | 广告Icon对应的控件ID |
shakeViewContainerId(int shakeViewContainerId) | 摇一摇容器ID |
方法名 | 说明 |
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() | 是否为模板广告 |
方法名 | 说明 |
void onClickRetry() | 点击重试回调 |
void onClick() | 点击回调 |
注意事项:
AdSlot.Builder().setMediationAdSlot(new MediationAdSlot.Builder().setBidNotify(true)后可触发receiveBidResult,开发者可在该方法中获取竞价结果、价格等信息。方法名 | 说明 |
boolean isReady() | 当前广告是否可以展示 |
MediationAdEcpmInfo getShowEcpm() | 为了确保数据的准确性,强烈建议在展示后获取展示广告的详细信息 |
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() | 获取价格,只能在show之后获取 |
int getReqBiddingType() | 获取bidding类型 |
String getErrorMsg() | 获取错误信息 |
String getRequestId() | 获取请求标识 |
String getRitType() | 获取代码位类型 |
String getSegmentId() | 获取流量分组ID,详细使用请参考>>> |
String getChannel() | 获取流量分组渠道,详细使用请参考>>> |
String getSubChannel() | 获取流量分组子渠道,详细使用请参考>>> |
String getAbTestId() | 获取AB测试ID |
String getScenarioId() | 获取场景ID |
已经展示过且不再使用的广告需要在合适的时机调用 destroy 方法及时对广告进行销毁,避免内存异常场景。
MediationDrawActivity.java
FeedAdUtils.java
Online Customer Service24/7 Online Customer Service Bot