插屏广告

1. 介绍

1.1 集成建议

(1) 展示广告：

• 展示前判断isAdReady是否准备好，准备好后再调用show进行广告展示；若未准备好则发起广告加载，等待广告加载成功；如果需要在加载成功的回调 onInterstitialAdLoaded 中展示广告，必须先判断当前应用在前台才能执行展示方法，否则有可能会引起广告在应用外展示或者无法正常展示的情况；

(2) 广告预加载：

• 请提前调用加载方法进行广告的请求（比如在应用启动就开始加载广告），以便需要触发广告时可以快速展示
• 在广告展示后，onInterstitialAdVideoStart的回调中无需isAdReady判断，直接调用load进行预加载 （有助于提升优先级比较高的广告源的展示量）

 

2. API说明

2.1 广告加载

ATInterstitial: Interstitial广告的加载类

广告加载：

//注意：广告对象必须要全局引用，如果广告对象是临时变量会导致广告加载过程中有可能被回收，无法接收广告事件回调
ATInterstitial mInterstitialAd;

private void loadAd() {
    if (mInterstitialAd == null) {
        mInterstitialAd = new ATInterstitial(this, interstitialTakuPlacementID);
    }
    mInterstitialAd.load();
}

 

2.2广告对象

ATInterstitial:

ATAdStatusInfo：广告位的状态对象

2.3广告展示

ATInterstitial:

广告展示：

private void showAd() {
   /*
     为了统计场景到达率，相关信息可查阅 "https://help.takuad.com/docs/1RWLAv"
     在满足广告触发条件时调用“进入广告场景”方法，比如：
     ** 广告场景是在清理结束后弹出广告，则在清理结束时调用；
     * 1、先调用 "entryAdScenario"
     * 2、在调用 "isAdReady" 是否可展示
     * 3、最后调用 "show" 展示
     * 4、scenario 传入场景id后台场景管理才会有数据显示
     */
    ATInterstitial.entryAdScenario("your iv placementID", "your scenarioID");
    if (mInterstitialAd.isAdReady()) {
        mInterstitialAd.show(activity，"your scenarioID");
    }
}

 

展示时传入自定义参数：

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

 

2.4 广告监听

ATInterstitial:

ATInterstitialListener： 是Interstitial广告的事件回调监听:

 

广告监听：

mInterstitialAd.setAdListener(new ATInterstitialListener() {
            @Override
            public void onInterstitialAdLoaded() {
            }

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

            @Override
            public void onInterstitialAdClicked(ATAdInfo atAdInfo) {
            }

            @Override
            public void onInterstitialAdShow(ATAdInfo atAdInfo) {
                //ATAdInfo可区分广告平台以及获取广告平台的广告位ID等
                //请参考 https://docs.takuad.com/#/zh-cn/android/android_doc/android_sdk_callback_access?id=callback_info
               //建议在此回调中调用load进行广告的加载，方便下一次广告的展示（不需要调用isAdReady()） 
                 mInterstitialAd.load();
            }

            @Override
            public void onInterstitialAdClose(ATAdInfo atAdInfo) {
            }

            @Override
            public void onInterstitialAdVideoStart(ATAdInfo atAdInfo) {
                
            }

            @Override
            public void onInterstitialAdVideoEnd(ATAdInfo atAdInfo) {
            }

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

 

2.5 其他监听

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

ATAppDownloadListener： （仅中国区SDK支持）下载状态的事件回调监听 

目前仅支持以下平台：穿山甲

 

3. 示例代码

//注意：广告对象必须要全局引用，如果广告对象是临时变量会导致广告加载过程中有可能被回收，无法接收广告事件回调
ATInterstitial mInterstitialAd;

private void loadAd() {
    if (mInterstitialAd == null) {
        mInterstitialAd = new ATInterstitial(this, interstitialTakuPlacementID);
        mInterstitialAd.setAdListener(new ATInterstitialListener() {
            @Override
            public void onInterstitialAdLoaded() {
            }

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

            @Override
            public void onInterstitialAdClicked(ATAdInfo atAdInfo) {
            }

            @Override
            public void onInterstitialAdShow(ATAdInfo atAdInfo) {
                //ATAdInfo可区分广告平台以及获取广告平台的广告位ID等
                //请参考 https://docs.takuad.com/#/zh-cn/android/android_doc/android_sdk_callback_access?id=callback_info
                //建议在此回调中调用load进行广告的加载，方便下一次广告的展示（不需要调用isAdReady()） 
                 mInterstitialAd.load();
            }

            @Override
            public void onInterstitialAdClose(ATAdInfo atAdInfo) {
            }

            @Override
            public void onInterstitialAdVideoStart(ATAdInfo atAdInfo) {
               
            }

            @Override
            public void onInterstitialAdVideoEnd(ATAdInfo atAdInfo) {
            }

            @Override
            public void onInterstitialAdVideoError(AdError adError) {
                //AdError，请参考 https://docs.takuad.com/#/zh-cn/android/android_doc/android_test?id=aderror
                Log.e(TAG, "onInterstitialAdVideoError:" + adError.getFullErrorInfo());
            }
        });
    }
    mInterstitialAd.load();
}
private void showAd() {
   /*
     为了统计场景到达率，相关信息可查阅 "https://docs.takuad.com/#/zh-cn/android/NetworkAccess/scenario/scenario"
     在满足广告触发条件时调用“进入广告场景”方法，比如：
     ** 广告场景是在清理结束后弹出广告，则在清理结束时调用；
     * 1、先调用 "entryAdScenario"
     * 2、在调用 "isAdReady" 是否可展示
     * 3、最后调用 "show" 展示
     * 4、scenario 传入场景id后台场景管理才会有数据显示
     */
    ATInterstitial.entryAdScenario("your iv placementID", "your scenarioID");
    if (mInterstitialAd.isAdReady()) {
        mInterstitialAd.show(activity，"your scenarioID");
    }
}

详细插屏广告示例代码请参考：Demo的InterstitialAdActivity类