插屏广告全自动加载

1. 全自动加载插屏广告介绍

全自动加载模式，是Taku推出的一站式请求维护方案，能够根据用户的使用状态和广告消耗进度，多节点智能判断下一条广告的预加载和缓存时机。在满足开发者运营策略的基础上，规避广告数据实时加载的失败风险和展示机会被浪费，减轻用户因为广告未加载或加载不流畅造成的负面情绪。通过全自动加载方案，开发者可以避免反复冗杂的人工干预请求方案，效率提升立竿见影。SDK开始支持全自动加载模式。

 

1.1 集成建议

(1) 初始化：在主Activity onCreate()里调用ATInterstitialAutoAd.init(mainActivity,placementIds,listener)并传入主Activity进行初始化，后续如需添加全自动加载广告位请调用addPlacementId(placementId)添加

(2) 建议进入可展示广告场景后调用entryAdScenario(placementId,scenarioId)统计当前广告位的缓存状态，具体的统计说明可查看广告场景区分不同业务场景的数据

(3) 展示广告：展示前判断isAdReady(placementId)是否准备好，准备好后再调用show(activity,placement,listener)进行广告展示

 

2. API说明

2.1 广告初始化

ATInterstitialAutoAd: 全自动加载插屏广告的管理类

 

初始化：

public class MainActivity extends Activity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        //建议在主Activity onCreate时传入Activity进行初始化
        ATInterstitialAutoAd.init(MainActivity.this, new String[]{"your iv placementID1", "your iv placementID2"},autoLoadListener);
    }
}

 

2.2 广告展示

ATInterstitialAutoAd:

 

广告展示：

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

 

2.3 广告对象

ATInterstitialAutoAd:

ATAdStatusInfo：广告位的状态对象

2.4 广告监听

ATInterstitialAutoLoadListener：ATInterstitialAutoAd广告的加载事件回调监听:

 

监听示例：

private static final ATInterstitialAutoLoadListener autoLoadListener = new ATInterstitialAutoLoadListener() {
@Override
        public void onInterstitialAutoLoaded(String placementId) {
           Log.i(TAG, "PlacementId:" + placementId + ": onInterstitialAutoLoaded");
        }
        @Override
        public void onInterstitialAutoLoadFail(String placementId, AdError adError) {
           Log.i(TAG, "PlacementId:" + placementId + ": onInterstitialAutoLoadFail:\n" + adError.getFullErrorInfo());
        }；

 

ATInterstitialAutoEventListener：ATInterstitialAutoAd广告的事件回调监听:

 

监听示例：

private static final ATInterstitialAutoEventListener autoEventListener = new ATInterstitialAutoEventListener() {
 @Override
        public void onInterstitialAdClicked(ATAdInfo adInfo) {
            Log.i(TAG, "onInterstitialAdClicked:" + adInfo.toString());
      
          @Override
        public void onInterstitialAdShow(ATAdInfo adInfo) {
            Log.i(TAG, "onInterstitialAdShow:" + adInfo.toString());
      
        }
          @Override
        public void onInterstitialAdClose(ATAdInfo adInfo) {
            Log.i(TAG, "onInterstitialAdClose:" + adInfo.toString());
          
        }
         @Override
        public void onInterstitialAdVideoStart(ATAdInfo adInfo) {
            Log.i(TAG, "onInterstitialAdVideoStart:" + adInfo.toString());
    
        }
          @Override
        public void onInterstitialAdVideoEnd(ATAdInfo adInfo) {
            Log.i(TAG, "onInterstitialAdVideoEnd:" + adInfo.toString());
         
        }
         @Override
        public void onInterstitialAdVideoError(AdError adError) {
            Log.i(TAG, "onInterstitialAdVideoError:" + adError.getFullErrorInfo());
         
        }
        }；

 

3示例代码

public class MainActivity extends Activity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        //建议在主Activity onCreate时传入Activity进行初始化
        ATInterstitialAutoAd.init(MainActivity.this, new String[]{"placementId1", "placementId2"},autoLoadListener);
    }
    private static final ATInterstitialAutoLoadListener autoLoadListener = new ATInterstitialAutoLoadListener() { 
    @Override 
    public void onInterstitialAutoLoaded(String placementId) { 
    Log.i(TAG, "PlacementId:" + placementId + ": onInterstitialAutoLoaded");
    } 
    @Override 
    public void onInterstitialAutoLoadFail(String placementId, AdError adError) { 
     Log.i(TAG, "PlacementId:" + placementId + ": onInterstitialAutoLoadFail:\n" + adError.getFullErrorInfo());
    }；
    /*
     为了统计场景到达率，相关信息可查阅 "https://docs.takuad.com/#/zh-cn/android/NetworkAccess/scenario/scenario"
     在满足广告触发条件时调用“进入广告场景”方法，比如：
     ** 广告场景是在清理结束后弹出广告，则在清理结束时调用；
     * 1、先调用 "entryAdScenario"
     * 2、在调用 "isAdReady" 是否可展示
     * 3、最后调用 "show" 展示
     * 4、scenario 传入场景id后台场景管理才会有数据显示
     */
ATInterstitial.entryAdScenario(placementId, "scenario");
//需判断广告位是否准备好
    if(ATInterstitialAutoAd.isAdReady("placementId1")){
    ATInterstitialAutoAd.show(activity, "placementId1","scenario"， autoEventListener);
}
 private static final ATInterstitialAutoEventListener autoEventListener = new ATInterstitialAutoEventListener() { 
  @Override 
 public void onInterstitialAdClicked(ATAdInfo adInfo) {
   Log.i(TAG, "onInterstitialAdClicked:" + adInfo.toString());
  @Override 
  public void onInterstitialAdShow(ATAdInfo adInfo) {
   Log.i(TAG, "onInterstitialAdShow:" + adInfo.toString()); }
   @Override 
   public void onInterstitialAdClose(ATAdInfo adInfo) { 
   Log.i(TAG, "onInterstitialAdClose:" + adInfo.toString()); }
   @Override 
    public void onInterstitialAdVideoStart(ATAdInfo adInfo) {
   Log.i(TAG, "onInterstitialAdVideoStart:" + adInfo.toString()); }
   @Override
     public void onInterstitialAdVideoEnd(ATAdInfo adInfo) { 
   Log.i(TAG, "onInterstitialAdVideoEnd:" + adInfo.toString()); } 
   @Override 
     public void onInterstitialAdVideoError(AdError adError) { 
   Log.i(TAG, "onInterstitialAdVideoError:" + adError.getFullErrorInfo());
     }
     };

}

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