Fully automatic loading

1. Introduction to fully automatic loading of interstitial ads

Fully automatic loading mode is a one-stop request maintenance solution launched by Taku. It can intelligently determine the preloading and caching of the next advertisement based on the user's usage status and advertisement consumption progress. opportunity. On the basis of satisfying the developer's operation strategy, it avoids the risk of failure in real-time loading of advertising data and wasted display opportunities, and alleviates users' negative emotions caused by ads not loading or loading not smoothly. Through fully automatic loading of solutions, developers can avoid repeated and cumbersome manual intervention request solutions, and efficiency improvements are immediate. SDK begins to support fully automatic loading mode.

1.1 Integration Suggestions

1. Initialization: Call ATInterstitialAutoAd.init(mainActivity,placementIds,listener) in the main Activity onCreate() and Pass in the main Activity for initialization. If you need to add a fully automatic loading ad slot later, please call addPlacementId(placementId) to add
2. It is recommended to call entryAdScenario(placementId,scenarioId) after entering the scene where ads can be displayed to count the cache status of the current ad slot. For detailed statistical instructions, please see Advertising scenarios Distinguish data from different business scenarios
3. Display advertising: pre-display judgmentisAdReady(placementId)Are you ready? When ready, call show(activity, placement, listener) for ad display

2. API Description

2.1 Advertisement Initialization

ATInterstitialAutoAd: Management class for fully automatic loading of interstitial ads

Initialization:

public class MainActivity extends Activity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        //It is recommended to pass in the activity for initialization when creating the main activity onCreate
        ATInterstitialAutoAd.init(MainActivity.this, new String[]{"your iv placementID1", "your iv placementID2"},autoLoadListener);
    }
}

2.2Advertising display

ATInterstitialAutoAd:

Advertising display：

/*
   In order to calculate the scene arrival rate, relevant information can be consulted“ https://docs.toponad.com/#/zh -CN/android/NetworkAccess/scenario/scenario“

Call the "Enter Advertising Scene" method when the advertising triggering conditions are met, for example:

**If an advertisement pops up after the cleaning is completed, it will be called at the end of the cleaning;

*1. First call "entryAdScenario"

*2. Can calling "isAdReady" display

*3. Finally, call "show" to display

*4. Scenario ID is passed in to the backend scene management for data display
     */
ATInterstitial.entryAdScenario("your iv placementID1", "your scenarioID"");
//Need to determine if the advertising space is ready

 

if(ATInterstitialAutoAd.isAdReady("your iv placementID1")){
    ATInterstitialAutoAd.show(activity, "your iv placementID1","your scenarioID"， autoEventListener);
}

2.3Advertising target

ATInterstitialAutoAd:

ATAdStatusInfo：Status object of advertising space

ATInterstitialAutoLoadListener：ATInterstitialAutoAd Callback listening for loading events of advertisements:

Listening Example：

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 Event callback monitoring for advertisements:

Listening Example：

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());
         
        }
        }；
        

3sample code

public class MainActivity extends Activity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        //It is recommended to pass in the activity for initialization when creating the main activity onCreate
        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());
    }；
    /*
     In order to calculate the scene arrival rate, relevant information can be consulted“ https://docs.toponad.com/#/zh -CN/android/NetworkAccess/scenario/scenario“

Call the "Enter Advertising Scene" method when the advertising triggering conditions are met, for example:

**If an advertisement pops up after the cleaning is completed, it will be called at the end of the cleaning;

*1. First call "entryAdScenario"

*2. Can calling "isAdReady" display

*3. Finally, call "show" to display

*4. Scenario ID is passed in to the backend scene management for data display
     */
ATInterstitial.entryAdScenario(placementId, "scenario");
//Need to determine if the advertising space is ready
    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());
     }
     };

}

Please refer to the following for detailed example code of screen insertion advertisements:InterntialAdActivity class for Demo

4. Special configuration instructions for advertising platforms

• If developers need to pass in local parameters (ATInterstialAutoAd. setLocalExtra), please set the ad space to fully automatic loading after passing in the local parameters

4.1sigmob

• Developers can choose whether to use this configuration at their own discretion。

The incentive video should be used as a screen insert (calling Sigmab's incentive video API), and the Sigmab advertising source for the Taku backend insertion advertising space needs to be configured with Sigmab's incentive video advertising space ID

...
//Only for the Sigmab platform
Map localMap = new HashMap<>();
localMap.put(SigmobATConst.IS_USE_REWARDED_VIDEO_AS_INTERSTITIAL, true);
ATInterstitialAutoAd.setLocalExtra("placementA",localMap);

ATInterstitialAutoAd.init(context,"placementA",autoLoadListener);
//ATInterstitialAutoAd.placementNameToPlacementIds("placementA");

4.2 Pangolin inset image advertisement

Developers can set the width of the insert image advertisement on the pangolin platform using the following code. The SDK will automatically calculate the height based on the proportion configured in the background and the width passed in by the developer

...
int width = ;
Map localMap = new HashMap<>();
localMap.put(ATAdConst.KEY.AD_WIDTH, width);//unit：px
ATInterstitialAutoAd.setLocalExtra("placementA",localMap);

ATInterstitialAutoAd.init(context,"placementA",autoLoadListener);
//ATInterstitialAutoAd.placementNameToPlacementIds("placementA");

Developers can control the width and height of the insert image advertisement on the pangolin platform through the following code. Developers need to ensure that the width and height ratio are consistent with the advertising space ratio (when ATAdConst.KEY.AD_HEIGHT is not passed, pangolin's adaptive height display advertisement will be used)

int width = ;
int height = ;
Map localMap = new HashMap<>();
localMap.put(ATAdConst.KEY.AD_WIDTH, width);//unit：px
localMap.put(ATAdConst.KEY.AD_HEIGHT, height);//unit：px
ATInterstitialAutoAd.setLocalExtra("placementA",localMap);

ATInterstitialAutoAd.init(context,"placementA",autoLoadListener);
//ATInterstitialAutoAd.placementNameToPlacementIds("placementA");