开屏广告

1. 开屏广告介绍

1.1 集成建议

为了提高开屏广告的加载效率可以参考冷启动策略和SDK预置策略 ，详情请参考开屏广告接入最佳实践。

 

2. API说明

2.1广告加载

ATSplashAd: Splash广告的加载类

 

广告加载：

// 注：xxx需要替换为您的开屏广告超时时间，单位：毫秒
ATSplashAd splashAd = new ATSplashAd(context, placementId, listner, xxx);
splashAd.loadAd();

 

2.2广告展示

ATSplashAd:

 

广告展示：

  /*
     为了统计场景到达率，相关信息可查阅 "https://help.takuad.com/docs/1RWLAv"
     在满足广告触发条件时调用“进入广告场景”方法，比如：
     ** 广告场景是在清理结束后弹出广告，则在清理结束时调用；
     * 1、先调用 "entryAdScenario"
     * 2、在调用 "isAdReady" 是否可展示
     * 3、最后调用 "show" 展示
     * 4、scenario 传入场景id后台场景管理才会有数据显示（非必须）
     */
 ATSplashAd.entryAdScenario("your splash placementID", "your scenarioID");
//展示前需判断广告有缓存且当前Activity处于前台
if (splashAd.isAdReady() && inForeBackground) {
    //container大小至少占屏幕75%
    splashAd.show(activity, container，"your scenarioID");
}

 

展示时传入自定义参数：

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

 

2.3本地参数

ATSplashAd:

ATAdConst.KEY：LocalExtra本地参数预定义Key取值

2.4广告对象

ATSplashAd:

ATAdStatusInfo：广告位的状态对象

2.5广告监听

ATSplashAdListener: Splash广告的事件回调类

 

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

 

IATSplashEyeAd ：开屏点睛广告的控制类

ATSplashEyeAdListener：开屏点睛广告的事件回调类

ATSplashSkipInfo： 自定义SkipView功能类

 

ATSplashSkipAdListener：自定义SkipView事件监听类

 

3. 示例代码

// 注：xxx需要替换为您的开屏广告超时时间，单位：毫秒
ATSplashAd splashAd = new ATSplashAd(context, placementId, listner, xxx);
splashAd.loadAd();

 /*
     为了统计场景到达率，相关信息可查阅 "https://docs.takuad.com/#/zh-cn/android/NetworkAccess/scenario/scenario"
     在满足广告触发条件时调用“进入广告场景”方法，比如：
     ** 广告场景是在清理结束后弹出广告，则在清理结束时调用；
     * 1、先调用 "entryAdScenario"
     * 2、在调用 "isAdReady" 是否可展示
     * 3、最后调用 "show" 展示
     * 4、scenario 传入场景id后台场景管理才会有数据显示（非必须）
     */
 ATSplashAd.entryAdScenario("your splash placementID", "your scenarioID");
//展示前需判断广告有缓存且当前Activity处于前台
if (splashAd.isAdReady() && inForeBackground) {
    //container大小至少占屏幕75%
    splashAd.show(activity, container，"your scenarioID");
}

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

 

冷启动示例：

ATSplashExListener listener = new ATSplashExListener() {
    ......
    @Override
    public void onAdLoaded(boolean isTimeout) {
        //加载未超时时
        if(!isTimeout){
            //当前Activity处于前台时进行广告展示
            if(inForeBackground){
                //container大小至少占屏幕75%
                splashAd.show(activity, container);
            }else{
                //等待应用回到前台后再进行展示
                needShowSplashAd = true;
            }
        }
    }

    @Override
    public void onAdLoadTimeout() {
        //加载超时后，直接进入主界面
        jumpToMainActivity();
    }

    @Override
    public void onNoAdError(AdError adError) {
        //加载失败直接进入主界面
        jumpToMainActivity();
    }

    @Override
    public void onAdShow(ATAdInfo entity) {

    }

    @Override
    public void onAdDismiss(ATAdInfo entity, ATSplashAdExtraInfo splashAdExtraInfo) {
        //=1无区分 =2跳过结束 =3倒计时结束 =4点击广告结束 =99开屏展示失败
        if(splashAdExtraInfo.getDismissType()==ATAdConst.DISMISS_TYPE.SHOWFAILED){
    }
        //开屏广告展示关闭后进入主界面
        //注意：部分平台跳转落地页后倒计时不暂停，即使在看落地页，倒计时结束后仍然会回调onAdDismiss
        //因此在页面跳转时需要特殊处理，详情参考下方示例代码
        jumpToMainActivity();
    }
    ......
};

// 注：xxx需要替换为您的开屏广告超时时间，单位：毫秒
ATSplashAd splashAd = new ATSplashAd(context, placementId, listner, xxx);

if (splashAd.isAdReady()) {
    //container大小至少占屏幕75%
    splashAd.show(activity, container);
}else{
    splashAd.loadAd();
}

 

onAdDismiss() 开屏广告页面跳转示例：

//是否需要进行页面跳转标记
boolean needJump;

@Override
protected void onResume() {
    super.onResume();
    if (needJump) {
        jumpToMainActivity();
    }
    needJump = true;
}

@Override
protected void onPause() {
    super.onPause();
    needJump = false;
}

public void jumpToMainActivity() {
    if (!needJump) {
        needJump = true;
        return;
    }
    Intent intent = new Intent(this, YourMainActivity.class);
    startActivity(intent);
    finish();
}

 

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

4.1 Admob

Admob的开屏广告不需要依赖container进行展示，只能全屏进行展示，广告展示后不会进行倒计时且不会自动跳过

 

4.2 百度

如果有接入百度SDK的Splash广告，需要在百度后台选择SkipView的展示样式（百度后台默认选择不展示SkipView）。

 

4.3 穿山甲

加载广告前需设置广告的宽高，示例如下：

// 注：xxx需要替换为您的开屏广告超时时间，单位：毫秒
splashAd = new ATSplashAd(this, placementId, atMediationRequestInfo, this, xxx); 
Map localMap = new HashMap<>(); 
localMap.put(ATAdConst.KEY.AD_WIDTH, width);//单位：px 
localMap.put(ATAdConst.KEY.AD_HEIGHT, height);//单位：px 
splashAd.setLocalExtra(localMap); 
splashAd.loadAd();

注意：如果设置的宽高与展示时的container宽高不一致，或者Taku后台的模板渲染选项与穿山甲后台不对应，将会导致广告显示不全或者模糊、失真。

 

5. 开屏点睛示例

注意：

① 因为不一定能加载到支持点睛的开屏广告，所以开屏广告点睛素材的填充率问题，请联系广告平台进行处理

② 以下示例代码，请参考Demo

 

5.1 开屏Activity与显示点睛广告的Activity不是同一个

(1) 新建SplashEyeAdHolder类用于缓存IATSplashEyeAd实例

public class SplashEyeAdHolder {
    public static IATSplashEyeAd splashEyeAd;
}

public class SplashAdShowActivity extends Activity implements ATSplashAdListener {
    ...
    @Override
    public void onAdDismiss(ATAdInfo entity, ATSplashAdExtraInfo splashAdExtraInfo) {
        Log.i(TAG, "onAdDismiss:\n" + entity.toString());

        //（1）当穿山甲、优量汇的开屏广告素材支持点睛时，splashEyeAd不为null
        //（2）当展示的是快手开屏广告时，splashEyeAd为非null值，但不一定表示此次快手开屏广告的素材支持点睛，不支持时调用IATSplashEyeAd#show()方法会直接回调ATSplashEyeAdListener#onAdDismiss()方法
        //（3）当splashEyeAd不为null，但是开发者不想支持点睛功能时，必须调用splashEyeAd.destroy()释放资源，然后跳转主页面或者移除开屏View

        SplashEyeAdHolder.splashEyeAd = splashAdExtraInfo.getAtSplashEyeAd();

        jumpToMainActivity();
    }
}

 

(2) 设置开屏相关信息（SplashZoomOutManager请参考Demo），同时跳转首页Activity并取消页面跳转动画，关闭当前页面

public class SplashAdShowActivity extends Activity implements ATSplashAdListener {
    ...
    public void jumpToMainActivity() {
        if (!hasHandleJump) {
            hasHandleJump = true;

            if (SplashEyeAdHolder.splashEyeAd != null) {
                try {
                    SplashZoomOutManager zoomOutManager = SplashZoomOutManager.getInstance(getApplicationContext());
                    zoomOutManager.setSplashInfo(container.getChildAt(0),
                            getWindow().getDecorView());
                } catch (Throwable e) {
                    Log.e(TAG, "jumpToMainActivity: ------------------------------------------ error");
                    e.printStackTrace();
                }

                Intent intent = new Intent(this, TestMainActivity.class);
                startActivity(intent);

                overridePendingTransition(0, 0);
            }

            finish();
            Toast.makeText(this, "start your MainActivity.", Toast.LENGTH_SHORT).show();
        }
    }
}

 

(3) 在首页Activity中，创建showSplashEyeAd()方法

public class TestMainActivity extends Activity {
    ...
    private void showSplashEyeAd() {

        if (SplashEyeAdHolder.splashEyeAd == null) {
            return;
        }

        SplashEyeAdHolder.splashEyeAd.show(TestMainActivity.this, null, new ATSplashEyeAdListener() {
            @Override
            public void onAnimationStart(View splashView) {
                //执行缩放动画
                SplashZoomOutManager zoomOutManager = SplashZoomOutManager.getInstance(getApplicationContext());

                //建议优先使用IATSplashEyeAd#getSuggestedSize()返回的大小作为缩放动画的目标大小
                int[] suggestedSize = SplashEyeAdHolder.splashEyeAd.getSuggestedSize(getApplicationContext());
                if (suggestedSize != null) {
                    zoomOutManager.setSplashEyeAdViewSize(suggestedSize[0], suggestedSize[1]);
                }
                zoomOutManager.startZoomOut((ViewGroup) getWindow().getDecorView(),
                        findViewById(android.R.id.content), new SplashZoomOutManager.AnimationCallBack() {

                            @Override
                            public void animationStart(int animationTime) {

                            }

                            @Override
                            public void animationEnd() {
                                Log.i(TAG, "animationEnd---------: eye ad");

                                //当缩放动画完成时必须调用IATSplashEyeAd#onFinished()通知SDK
                                SplashEyeAdHolder.splashEyeAd.onFinished();
                            }
                        });

            }

            @Override
            public void onAdDismiss(boolean isSupportEyeSplash, String errorMsg) {
                Log.i(TAG, "onAdDismiss---------: close eye ad");

                //建议在此回调中调用IATSplashEyeAd#destroy()释放资源以及释放其他资源，以免造成内存泄漏
                SplashZoomOutManager zoomOutManager = SplashZoomOutManager.getInstance(getApplicationContext());
                zoomOutManager.clearStaticData();

                SplashEyeAdHolder.splashEyeAd.destroy();
                SplashEyeAdHolder.splashEyeAd = null;
            }
        });
    }

}

 

(4) 在首页Activity中，调用showSplashEyeAd()展示点睛广告（建议在onAttachedToWindow()回调中调用showSplashEyeAd()）

 public class TestMainActivity extends Activity {
     ...
     @Override
    public void onAttachedToWindow() {
        super.onAttachedToWindow();

        showSplashEyeAd();
    }
}

 

5.2 开屏Activity与显示点睛广告的Activity是同一个

public class SplashAdShowActivity extends Activity implements ATSplashAdListener {
    ...
    @Override
    public void onAdDismiss(ATAdInfo entity, IATSplashEyeAd splashEyeAd) {
        Log.i(TAG, "onAdDismiss:\n" + entity.toString());

        //（1）当穿山甲、优量汇的开屏广告素材支持点睛时，splashEyeAd不为null
        //（2）当展示的是快手开屏广告时，splashEyeAd为非null值，但不一定表示此次快手开屏广告的素材支持点睛，不支持时调用IATSplashEyeAd#show()方法会直接回调ATSplashEyeAdListener#onAdDismiss()方法
        //（3）当splashEyeAd不为null，但是开发者不想支持点睛功能时，必须调用splashEyeAd.destroy()释放资源，然后跳转主页面或者移除开屏View


        if (container != null) {
            container.removeAllViews();
            container.setVisibility(View.GONE);
        }  

        //展示点睛广告
        showSplashEyeAd(splashEyeAd);
    }

     private void showSplashEyeAd(IATSplashEyeAd splashEyeAd) {
        if (splashEyeAd == null) {
            return;
        }

        splashEyeAd.show(SplashAdShowInCurrentActivity.this, null, new ATSplashEyeAdListener() {
            @Override
            public void onAnimationStart(View splashView) {
                //执行缩放动画
                SplashZoomOutManager zoomOutManager = SplashZoomOutManager.getInstance(getApplicationContext());

                ////建议优先使用IATSplashEyeAd#getSuggestedSize()返回的大小作为缩放动画的目标大小
                int[] suggestedSize = splashEyeAd.getSuggestedSize(getApplicationContext());
                if (suggestedSize != null) {
                    zoomOutManager.setSplashEyeAdViewSize(suggestedSize[0], suggestedSize[1]);
                }

                zoomOutManager.setSplashInfo(splashView, getWindow().getDecorView());
                ViewGroup content = findViewById(android.R.id.content);
                zoomOutManager.startZoomOut(splashView, content, content, new SplashZoomOutManager.AnimationCallBack() {

                    @Override
                    public void animationStart(int animationTime) {

                    }

                    @Override
                    public void animationEnd() {
                        Log.i(TAG, "animationEnd---------: eye ad");

                        //当缩放动画完成时必须调用IATSplashEyeAd#onFinished()通知SDK
                        splashEyeAd.onFinished();
                    }
                });


            }

            @Override
            public void onAdDismiss(boolean isSupportEyeSplash, String errorMsg) {
                Log.i(TAG, "onAdDismiss---------: eye ad");

                //建议在此回调中调用IATSplashEyeAd#destroy()释放资源以及释放其他资源，以免造成内存泄漏
                SplashZoomOutManager zoomOutManager = SplashZoomOutManager.getInstance(getApplicationContext());
                zoomOutManager.clearStaticData();
                splashEyeAd.destroy();
            }
        });
    }
}

 

6. 首次安装开屏加载效率提升方案

背景：应用安装时首次加载开屏广告，Taku需先从后台拉取配置的广告位信息缓存在本地，然后才会去请求广告平台的广告，这期间涉及了两次网络请求（串行）影响了开屏广告加载效率，下面提供了两种方式去提高应用安装后首次开屏加载效率。

 

6.1（v6.1.78及以后版本）预置策略设置（建议使用）

为提高首次冷启动的广告加载效果，在开屏广告位上创建SDK预置策略的流量分组，然后在这个流量分组配置瀑布流，同时建议您增加一个兜底广告源，最后导出SDK预置策略并预置到应用中。具体接入文档见SDK预置策略使用说明。

配置效果： 可以实现SDK预置开屏策略，同时实现开屏兜底广告源的兜底功能。即：此兜底广告源会和广告位下的整体瀑布流并行发起请求。并且用户不会在首次请求时必定使用兜底广告，而是正常走瀑布流和兜底广告源的并行请求。可以实现变现价值最大化。

注意： 预置策略的使用时机是只有在本地没有缓存策略的情况下才会调用。