檢視 Android Banner Ads 3.0 的原始碼

== <b>Banner 廣告支援格式</b> ==
:TAMedia Banner廣告支援下列數種形式：
{| class="wikitable" style="width:50%" 
|-
! 廣告格式 !! 大小(寬度x高度) !! TWMAdSize 常數值
|-
| align="center"|BANNER || align="center"|320x50 || align="center"|TWMAdSize.BANNER
|-
| align="center"|SMART_BANNER || align="center"|自動對應裝置寬度, 並對應適當的高度 || align="center"|TWMAdSize.SMART_BANNER
|-
| align="center"|IAB_MRECT || align="center"|300x250 || align="center"|TWMAdSize.IAB_MRECT
|-
| align="center"|IAB_BANNER || align="center"|468x60 || align="center"|TWMAdSize.IAB_BANNER	
|-
| align="center"|IAB_LEADERBOARD || align="center"|728x90 || align="center"|TWMAdSize.IAB_LEADERBOARD
|}

== <b>實作方式</b> ==
<ul><li>廣告初始設置</li></ul> 
:<b>Activity XML(範例):</b> 
  <?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>
:<b>Java:</b>
  private TWMAdView adView = null;
  private static final String AD_UNIT_ID = "INSERT_YOUR_AD_UNIT_ID";
  
  // Other Implement ... 
  
  <b>// 依序傳入Activity, TWMAdSize, 以及Ad Unit Id，TWMAdSize請參考頁首的TWMAdSize常數值</b>
  adView = new TWMAdView(MainActivity.this,TWMAdSize.BANNER,AD_UNIT_ID ); 
  RelativeLayout root = (RelativeLayout) findViewById(R.id.ad_container);
  root.addView(adView); 
<br>

:您也可以將TWMAdView宣告於佈局XML中，可省去上述兩個步驟
 <?xml version="1.0" encoding="utf-8"?>
 <LinearLayout xmlns:android=<nowiki>"http://schemas.android.com/apk/res/android"</nowiki>
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical" >
    <com.taiwanmobile.pt.adp.view.TWMAdView
        xmlns:ad=<nowiki>"http://schemas.android.com/apk/lib/com.taiwanmobile.pt.adp.view"</nowiki>
        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>



<b><span style="color:#ff0000">重要, 針對SDK 2.0後,請在Activity的生命週期中加入下述的呼叫,以便取得更好的服務經驗</span></b>

  @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){
       // 用戶點擊廣告後,將要啟動新的應用程式時通知
    }   
  });
 
*畫面展示
{| width="70%" border="1"
|-
| align="center" | 應用程式開啟
| align="center" | 點擊Banner後開啟網頁
| align="center" | 點擊Banner後撥打電話
|-
| align="center" | [[檔案:2.png]]
| align="center" | [[檔案:3.png]]
| align="center" | [[檔案:4.png]]
|}

: 接下來可以參考進階的 [[Android_Interstitial_Ads_2.0|Interstitial Ads]]/[[Android_NativeAds|Native Ads]]/[[Android_Video_Ads_2.0|Video Ads]]