| 类型 | 简介 | 适用场景 |
|---|---|---|
| 开屏广告 | 开屏广告以APP启动作为曝光时机的模板广告，需要将开屏广告视图添加到承载的广告容器中，提供5s可感知广告展示 | APP启动界面常会使用开屏广告 |
| Banner广告 | Banner广告是横向贯穿整个可视页面的模板广告，需要将Banner广告视图添加到承载的广告容器中 | 任意界面的固定位置，不建议放在RecyclerView、List这种滚动布局中当item |
| 信息流自渲染广告 | 信息流自渲染广告，可自行设计样式，以满足不同的样式需求 | 信息流列表，轮播控件，固定位置都是较为适合 |
| 信息流模板广告 | 信息流模板广告，支持上文下图、下图上文、左图右文、右图左文、纯图 | 信息流列表，轮播控件，固定位置都是较为适合 |
| 插屏广告 | 插屏广告是移动广告的一种常见形式，在应用流程中弹出，当应用展示插屏广告时，用户可以选择点击广告，访问其目标网址，也可以将其关闭并返回应用 | 在应用执行流程的自然停顿点，适合投放这类广告 |
| 激励视频广告 | 将短视频融入到APP场景当中，用户观看短视频广告后可以给予一些应用内奖励 | 常出现在游戏的复活、任务等位置，或者网服类APP的一些增值服务场景 |
| 创新广告 | 将广告悬浮在页面上 |
PS ：AppId通过后台配置生成，初始化必须在主线程中进行。
### 6.2 开屏广告 开屏广告建议在闪屏页进行展示，开屏广告的宽度和高度取决于容器的宽高，会撑满广告容器；**开屏广告的高度必须大于等于屏幕高度（手机屏幕完整高度，包括状态栏之类）的75%**，否则onAdFailed方法会被回调。 #### 6.2.1 开屏广告主要 API **SplashAd** com.tianmu.ad.SplashAd | 方法名 | 介绍 | | ------------ | ---- | | SplashAd(Context context) | 构造方法。参数说明：context（加载广告的上下文对象）。| | SplashAd(Context context, View skipView) | 构造方法。参数说明：context（加载广告的上下文对象）、skipView（自定义跳过按钮）。| | setImmersive(boolean isImmersive) | 设置沉浸效果。参数说明：isImmersive（true：沉浸，false：不沉浸， 目前仅影响默认跳过按钮位置）。| | setCountDownTime(long countDownTime) | 设置倒计时跳过时长。参数说明：countDownTime（[3000ms~5000ms]，默认5000ms）。| | setListener(SplashAdListener listener) | 设置广告相关状态。参数说明：listener（广告状态监听器）。| | setSensorDisable(boolean isSensorDisable) | 是否禁用传感器（可禁用摇一摇、扭一扭）。参数说明：isSensorDisable（true：禁用，false：启用，默认false）。| | setMute(boolean isMute) | 视频静音设置。参数说明：isMute（true：静音、false：不静音，默认：true）。| | loadAd(String posId) | 请求广告。参数说明：posId（广告位ID）。| | release() | 释放广告。| **SplashAdListener** com.tianmu.ad.listener.SplashAdListener | 方法名 | 介绍 | | ------------ | ---- | | onAdTick(long millisUntilFinished) | 广告倒计时剩余时长回调。参数说明：millisUntilFinished（剩余时间，单位：秒））。| | onAdReceive(SplashAdInfo adInfo) | 广告加载成功回调。| | onRenderSuccess(SplashAdInfo adInfo) | （V3.1.1.4新增）广告渲染成功回调（素材渲染成功，非真正展示）。| | onRenderFailed(SplashAdInfo adInfo, int code, String msg) | （V3.1.1.4新增）广告渲染失败回调。参数说明：adInfo（广告对象）、code（错误码）、msg（错误原因）| | onAdExpose(SplashAdInfo adInfo) | 广告展示回调。| | onAdClick(SplashAdInfo adInfo) | 广告点击回调。| | onAdSkip(SplashAdInfo adInfo) | 广告跳过回调，用户点击跳过按钮时触发。| | onAdClose(SplashAdInfo adInfo) | 广告关闭回调，用户点击跳过按钮、触发落地页后返回开屏页、倒计时结束，则触发。| | onAdFailed(TianmuError error) | 广告失败回调。参数说明：error（广告错误信息）。| **SplashAdInfo** com.tianmu.ad.bean.SplashAdInfo | 方法名 | 介绍 | | ------------ | ---- | | sendLossNotice(int price, @BidLossNotice int reason) | 竞败上报。参数说明：price（回传竞赢价格（ecpm），单位：分）、reason（竞败原因）。| | getBidPrice() | 获取竞价价格（ecpm），单位：分。| | getBidFloor() | 获取底价（ecpm），单位：分。| | isOvertime() | 广告是否超时（广告需要在10分钟内展示）。| | getSplashAdView() | 获取广告视图。| | render() | 渲染广告，请在上述方法最后调用。| #### 6.2.2 开屏广告接入示例 ```java SplashAd splashAd = new SplashAd(Context context); splashAd.setListener(new SplashAdListener() { @Override public void onAdTick(long millisUntilFinished) { // 倒计时剩余时长（单位：秒） } @Override public void onAdReceive(SplashAdInfo splashAdInfo) { // 广告获取成功回调，在此回调中展示广告 // 获取开屏广告视图 View view = splashAdInfo.getSplashAdView(); // 将广告视图添加到容器中，注意容器高度要大于屏幕75% flContainer.addView(view); // 渲染广告，一定要最后调用 splashAdInfo.render(); } @Override public void onRenderSuccess(SplashAdInfo splashAdInfo) { // 广告渲染成功回调 } @Override public void onRenderFailed(SplashAdInfo splashAdInfo, int code, String msg) { // 广告渲染失败回调，可在此处进入应用首页 } @Override public void onAdExpose(SplashAdInfo splashAdInfo) { // 广告展示回调 } @Override public void onAdClick(SplashAdInfo splashAdInfo) { // 广告点击回调 } @Override public void onAdSkip(SplashAdInfo splashAdInfo) { // 广告跳过回调 } @Override public void onAdClose(SplashAdInfo splashAdInfo) { // 广告关闭回调，可在此处进入应用首页 } @Override public void onAdFailed(TianmuError error) { // 广告失败回调，可在此处进入应用首页 } }); splashAd.loadAd(String posId); ``` > [开屏广告示例详情](https://gitee.com/admobile/tianmu-advertising-sdk-android/blob/master/app/src/main/java/com/tianmu/demo/ad/SplashAdActivity.java) ### 6.3 横幅广告 Banner横幅广告建议放置在 **固定位置**，而非ListView、RecyclerView、ViewPager等控件中充当Item，Banner广告支持多种尺寸比例，可在后台创建广告位时配置，Banner广告的宽度将会撑满容器，高度自适应，建议Banner广告容器高度也为自适应。 #### 6.3.1 横幅广告主要 API **BannerAd** com.tianmu.ad.BannerAd | 方法名 | 介绍 | | ------------ | ---- | | BannerAd(Context context, ViewGroup container) | 构造方法。参数说明：context（加载广告的上下文对象）、container（横幅广告展示容器）。| | BannerAd(Context context) | 构造方法，加载展示分离使用。参数说明：context（加载广告的上下文对象）。| | setListener(BannerAdListener listener) | 设置广告相关状态。参数说明：listener（广告状态监听器）。| | loadAd(String posId) | 请求广告。参数说明：posId（广告位ID）。| | release() | 释放广告。| **BannerAdListener** com.tianmu.ad.listener.BannerAdListener | 方法名 | 介绍 | | ------------ | ---- | | onAdReceive(BannerAdInfo adInfo) | 广告加载成功回调。| | onAdExpose(BannerAdInfo adInfo) | 广告展示回调。| | onAdClick(BannerAdInfo adInfo) | 广告点击回调。| | onAdClose(BannerAdInfo adInfo) | 广告关闭回调。| | onAdFailed(TianmuError error) | 广告失败回调。参数说明：error（广告错误信息）。| **BannerAdInfo** com.tianmu.ad.bean.BannerAdInfo | 方法名 | 介绍 | | ------------ | ---- | | getAdView() | 获取广告视图。| | render() | 渲染广告，请在上述方法最后调用。| #### 6.3.2 横幅广告接入示例 ```java BannerAd bannerAd = new BannerAd(Context context, ViewGroup container); bannerAd.setListener(new BannerAdListener() { @Override public void onAdExpose(BannerAdInfo bannerAdInfo) { // 广告展示回调 } @Override public void onAdClick(BannerAdInfo bannerAdInfo) { // 广告点击回调 } @Override public void onAdClose(BannerAdInfo bannerAdInfo) { // 广告关闭回调 } @Override public void onAdReceive(BannerAdInfo bannerAdInfo) { // 广告获取成功回调 } @Override public void onAdFailed(TianmuError error) { // 广告失败回调 } }); bannerAd.loadAd(String posId); ``` >[Banner广告示例详情](https://gitee.com/admobile/tianmu-advertising-sdk-android/blob/master/app/src/main/java/com/tianmu/demo/ad/BannerAdActivity.java) ### 6.4 信息流自渲染广告 信息流自渲染广告，可根据NativeAdInfo返回的素材自定义样式。 **注意，信息流广告点击关闭时，开发者需要在onAdClose回调中将广告容器隐藏或移除** #### 6.4.1 信息流自渲染广告主要 API **NativeAd** com.tianmu.ad.NativeAd | 方法名 | 介绍 | | ------------ | ---- | | NativeAd(Context context) | 构造方法。参数说明：context（加载广告的上下文对象）。| | setMute(boolean isMute) | 视频静音设置。参数说明：isMute（true：静音、false：不静音，默认：true）。| | setListener(NativeAdListener listener) | 设置广告相关状态。参数说明：listener（广告状态监听器）。| | loadAd(String posId) | 请求广告。参数说明：posId（广告位ID）。| | release() | 释放广告。| **NativeAdListener** com.tianmu.ad.listener.NativeAdListener | 方法名 | 介绍 | | ------------ | ---- | | onAdReceive(List\