Android Banner Ads 3.0

Banner 廣告支援格式

TAMedia Banner廣告支援下列數種形式：

廣告格式	大小(寬度x高度)	TWMAdSize 常數值
BANNER	320x50	TWMAdSize.BANNER
SMART_BANNER	自動對應裝置寬度, 並對應適當的高度	TWMAdSize.SMART_BANNER
IAB_MRECT	300x250	TWMAdSize.IAB_MRECT
IAB_BANNER	468x60	TWMAdSize.IAB_BANNER
IAB_LEADERBOARD	728x90	TWMAdSize.IAB_LEADERBOARD

實作方式

• 廣告初始設置

Activity XML(範例):

 <?xml version="1.0" encoding="utf-8"?>
 <RelativeLayout
 	android:id="@+id/ad_container"
 	android:layout_width="match_parent"
 	android:layout_height="wrap_content"
 	android:gravity="center_horizontal">
 </RelativeLayout>

Java:

 private TWMAdView adView = null;
 private static final String AD_UNIT_ID = "INSERT_YOUR_AD_UNIT_ID";
 
 // Other Implement ... 
 
 // 依序傳入Activity, TWMAdSize, 以及Ad Unit Id，TWMAdSize請參考頁首的TWMAdSize常數值
 adView = new TWMAdView(MainActivity.this,TWMAdSize.BANNER,AD_UNIT_ID ); 
 RelativeLayout root = (RelativeLayout) findViewById(R.id.ad_container);
 root.addView(adView); 

您也可以將TWMAdView宣告於佈局XML中，可省去上述兩個步驟

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
   android:layout_width="match_parent"
   android:layout_height="match_parent"
   android:orientation="vertical" >
   <com.taiwanmobile.pt.adp.view.TWMAdView
       xmlns:ad="http://schemas.android.com/apk/lib/com.taiwanmobile.pt.adp.view"
       android:id="@+id/adView"
       android:layout_width="wrap_content"
       android:layout_height="wrap_content"
       ad:adSize="BANNER"
       ad:adunitId="{AD_UNIT_ID}" >
   </com.taiwanmobile.pt.adp.view.TWMAdView>
</LinearLayout>

重要, 針對SDK 2.0後,請在Activity的生命週期中加入下述的呼叫,以便取得更好的服務經驗

 @Override
 protected void onDestroy() {
   if(twmAdView != null) {
     // 呼叫TWMAdView.destroy()
     twmAdView.destroy();
   }
   super.onDestroy();
 }
 @Override
 protected void onResume() {
   if(twmAdView != null) {
     // 呼叫TWMAdView.resume()
     twmAdView.resume();
   }
   super.onResume();
 }
 @Override
 protected void onPause() {
   if(twmAdView != null) {
     // 呼叫TWMAdView.pause()
     twmAdView.pause();
   }
   super.onPause();
 }

• 加入TWMAdViewListener監聽廣告投放情況

 public interface TWMAdViewListener {
   public abstract void onReceiveAd(TWMAd ad);
   public abstract void onFailedToReceiveAd(TWMAd ad, TWMAdRequest.ErrorCode errorCode);
   public abstract void onPresentScreen(TWMAd ad);
   public abstract void onDismissScreen(TWMAd ad);
   public abstract void onLeaveApplication(TWMAd ad);
 }

在使用TWMAdView的時候加入

 twmadView.setAdListener(new TWMAdViewListener(){
   public void onReceiveAd(TWMAd ad){
      // 成功收到廣告時通知
   }
   public void onFailedToReceiveAd(TWMAd ad, TWMAdRequest.ErrorCode errorCode){
      // 當請求廣告失敗時通知
   }
   public void onPresentScreen(TWMAd ad){
      // 當用戶點擊廣告時通知
   }
   public void onDismissScreen(TWMAd ad){
      // 用戶關閉因點擊廣告所產生的新Activity將要把控制權交給應用程式時通知
   }
   public void onLeaveApplication(TWMAd ad){
      // 用戶點擊廣告後,將要啟動新的應用程式時通知
   }   
 });

• 畫面展示

應用程式開啟	點擊Banner後開啟網頁	點擊Banner後撥打電話

接下來可以參考進階的 Interstitial Ads/Native Ads/Video Ads