横幅广告

1. 横幅广告介绍

1.1 集成建议

1.1.1 宽高设置

• 可以自定义宽高，但需要与在TopOn后台配置的宽高比一致，并根据实际效果进行调整，具体实现请参考Demo。

1.1.2 自动刷新

• 默认情况下不开启，可以在TopOn后台的广告位高级设置中配置刷新时间开启或者禁止刷新。
• 横幅广告的View必须添加到窗口并可见，才会触发自动刷新。
• 如果广告平台有提供自动刷新功能，则建议关闭广告平台的自动刷新，只需要用TopOn提供的自动刷新就行，避免冲突导致一些不可预知的问题。
• 开启自动刷新功能后，将ATBannerView添加到布局中，并保证其处于可见状态后调用一次load()方法，之后的展示和刷新都会由SDK自动执行。

1.1.3 销毁资源

• 当不再需要展示横幅广告时，从布局中移除ATBannerView，并调用ATBannerView#destroy()方法销毁当前的广告资源。

2. API说明

2.1 广告加载展示

ATBannerView: Banner广告的加载类，同时也是一个显示Banner广告的View

广告加载展示：

ATBannerView mBannerView = new ATBannerView(BannerAdActivity.this); 
mBannerView.setPlacementId(bannerTakuPlacementID); 
mBannerView.loadAd();

2.2 广告场景

ATBannerView:

场景示例：

mBannerView.setScenario("your scenarioID");

展示时传入自定义参数：

Taku SDK v6.3.10及以上开始支持开发者在展示时传入自定义参数，展示时传入的自定义参数跟Load时传入的自定义参数相互独立。展示时传入自定义参数可以在Taku SDK回调信息中返回。

2.3 横幅广告大小设置

ATBannerView:

(1) Banner广告位下的各个广告源尺寸最好选择一样或者比例接近的

(2) 在调用load方法加载广告之前，需要通过setLocalExtra()传入宽高大小

ATBannerView mBannerView = new ATBannerView(BannerAdActivity.this); 
mBannerView.setPlacementId(bannerTakuPlacementID); 
int width = getResources().getDisplayMetrics().widthPixels;//定一个宽度值，比如屏幕宽度 
int height = (int) (width / (320 / 50f));//按照比例转换高度的值 
Map localMap = new HashMap<>(); 
localMap.put(ATAdConst.KEY.AD_WIDTH, width); 
localMap.put(ATAdConst.KEY.AD_HEIGHT, height); 
mBannerView.setLocalExtra(localMap); 
mBannerView.loadAd();

如果使用上面代码，出现Banner有时高、有时低的情况，请使用以下示例代码对高度进行限制：

int width = getResources().getDisplayMetrics().widthPixels;//定一个宽度值，比如屏幕宽度 
int height = (int) (width / (320 / 50f));//必须跟Taku后台配置的Banner广告源宽高比例一致，假设尺寸为320x50 
mBannerView.setLayoutParams(new FrameLayout.LayoutParams(width, height)); 
...

2.4 横幅广告移除说明

ATBannerView:

Banner可在以下情况进行移除

• 回调onBannerClose()时，手动调用代码将ATBannerView从父布局中移除
• 根据开发者需要，手动调用代码将ATBannerView从父布局中移除

注意：回调OnBannerClose()时，如果不手动调用代码进行移除，将会自动刷新一次Banner广告

2.5 广告对象

ATBannerView:

checkValidAdCaches

ATAdStatusInfo：广告位的状态对象

2.6 广告监听

ATBannerView:

ATBannerListener: 是Banner广告的事件回调监听

监听示例：

mBannerView.setBannerAdListener(new ATBannerListener() {
    @Override
    public void onBannerLoaded() { 
    }

    @Override
    public void onBannerFailed(AdError adError) {
        //注意：禁止在此回调中执行广告的加载方法进行重试，否则会引起很多无用请求且可能会导致应用卡顿
        //AdError，请参考 https://docs.takuad.com/#/zh-cn/android/android_doc/android_test?id=aderror
        Log.e(TAG, "onBannerFailed:" + adError.getFullErrorInfo());
    }

    @Override
    public void onBannerClicked(ATAdInfo atAdInfo) {
    }

    @Override
    public void onBannerShow(ATAdInfo atAdInfo) {
        //ATAdInfo可区分广告平台以及获取广告平台的广告位ID等
        //请参考 https://docs.takuad.com/#/zh-cn/android/android_doc/android_sdk_callback_access?id=callback_info

    }

    @Override
    public void onBannerClose(ATAdInfo atAdInfo) {
          if (mBannerView != null && mBannerView.getParent() != null) {
                ((ViewGroup) mBannerView.getParent()).removeView(mBannerView);
          }
    }

    @Override
    public void onBannerAutoRefreshed(ATAdInfo atAdInfo) {
    }

    @Override
    public void onBannerAutoRefreshFail(AdError adError) {
        //AdError：https://docs.takuad.com/#/zh-cn/android/android_doc/android_test?id=aderror
        Log.e(TAG, "onBannerAutoRefreshFail:" + adError.getFullErrorInfo());
    }
});

ATBannerExListener： 继承自ATBannerListener，方法同ATBannerListener，额外回调说明如下：

ATAppDownloadListener： （仅中国区SDK支持）下载状态的事件回调监听
目前仅支持以下平台：穿山甲

3. 示例代码

ATBannerView mBannerView = new ATBannerView(BannerAdActivity.this);
mBannerView.setPlacementId(bannerTakuPlacementID);

int width = getResources().getDisplayMetrics().widthPixels;//定一个宽度值，比如屏幕宽度
int height = ViewGroup.LayoutParams.WRAP_CONTENT;

//如果出现Banner有时高、有时低的情况，请使用此代码
//float ratio = 320/50f;//必须跟Taku后台配置的Banner广告源宽高比例一致，假设尺寸为320x50
//int width = getResources().getDisplayMetrics().widthPixels;//定一个宽度值，比如屏幕宽度
//int height = (int) (width / ratio);

mBannerView.setLayoutParams(new FrameLayout.LayoutParams(width, height));

frameLayout.addView(mBannerView);
mBannerView.setBannerAdListener(new ATBannerListener() {
    @Override
    public void onBannerLoaded() { 
    }

    @Override
    public void onBannerFailed(AdError adError) {
        //注意：禁止在此回调中执行广告的加载方法进行重试，否则会引起很多无用请求且可能会导致应用卡顿
        //AdError，请参考 https://docs.takuad.com/#/zh-cn/android/android_doc/android_test?id=aderror
        Log.e(TAG, "onBannerFailed:" + adError.getFullErrorInfo());
    }

    @Override
    public void onBannerClicked(ATAdInfo atAdInfo) {
    }

    @Override
    public void onBannerShow(ATAdInfo atAdInfo) {
        //ATAdInfo可区分广告平台以及获取广告平台的广告位ID等
        //请参考 https://docs.takuad.com/#/zh-cn/android/android_doc/android_sdk_callback_access?id=callback_info

    }

    @Override
    public void onBannerClose(ATAdInfo atAdInfo) {
          if (mBannerView != null && mBannerView.getParent() != null) {
                ((ViewGroup) mBannerView.getParent()).removeView(mBannerView);
          }
    }

    @Override
    public void onBannerAutoRefreshed(ATAdInfo atAdInfo) {
    }

    @Override
    public void onBannerAutoRefreshFail(AdError adError) {
        //AdError：https://docs.takuad.com/#/zh-cn/android/android_doc/android_test?id=aderror
        Log.e(TAG, "onBannerAutoRefreshFail:" + adError.getFullErrorInfo());
    }
});
//scenario 传入场景id后台场景管理才会有数据显示
mBannerView.setScenario("your scenarioID");
mBannerView.loadAd();

详细横幅广告示例代码请参考：Demo的BannerAdActivity类

4. 广告平台特殊配置说明

4.1 Admob自适应横幅

Taku SDK支持Admob的自适应横幅，包括自适应锚定横幅、自适应大尺寸横幅，推荐使用自适应锚定横幅。开发者需用以下代码设置自适应横幅的类型、根据哪种屏幕方向自适应以及横幅的宽度（单位：px）

...

Map localExtra = new HashMap<>();

//since v5.7.0, Admob Adaptive banner（自适应锚定横幅、自适应大尺寸横幅）
localExtra.put(AdmobATConst.ADAPTIVE_TYPE, AdmobATConst.ADAPTIVE_ANCHORED);//自适应锚定横幅
//localExtra.put(AdmobATConst.ADAPTIVE_TYPE, AdmobATConst.ADAPTIVE_INLINE);//自适应大尺寸横幅

localExtra.put(AdmobATConst.ADAPTIVE_ORIENTATION, AdmobATConst.ORIENTATION_CURRENT);
//localExtra.put(AdmobATConst.ADAPTIVE_ORIENTATION, AdmobATConst.ORIENTATION_PORTRAIT);
//localExtra.put(AdmobATConst.ADAPTIVE_ORIENTATION, AdmobATConst.ORIENTATION_LANDSCAPE);

localExtra.put(AdmobATConst.ADAPTIVE_WIDTH, width);

mBannerView.setLocalExtra(localExtra);

mBannerView.loadAd();

...
mBannerView.setLayoutParams(new FrameLayout.LayoutParams(width, ViewGroup.LayoutParams.WRAP_CONTENT));

mBannerView.loadAd();

5. 关于广告平台的合规应用下载弹窗

5.1 穿山甲

//初始化Taku SDK之前调用此方法
TTATInitManager.getInstance().setIsOpenDirectDownload(false)