檢視 Android Banner Ads I 2.0 的原始碼

:*宣告Banner廣告版位
TAMedia Banner廣告支援下列數種形式
{| width="80%" border="1"
|-
| align="center" | 廣告格式
| align="center" | BANNER
| align="center" | IAB_MRECT
| align="center" | IAB_BANNER
| align="center" | IAB_LEADERBOARD
|-
| align="center" | 大小(寬度x高度)
| align="center" | 320x50
| align="center" | 300x250
| align="center" | 468x60
| align="center" | 728x90
|-
| align="center" | TWMAdSize 常數值
| align="center" | TWMAdSize.BANNER
| align="center" | TWMAdSize.IAB_MRECT
| align="center" | TWMAdSize.IAB_BANNER
| align="center" | TWMAdSize.IAB_LEADERBOARD
|}

::*透過程式進行宣告
    public class MainActivity extends Activity {
    private TWMAdView adView = null;
    private static final String AD_UNIT_ID = "INSERT_YOUR_AD_UNIT_ID";
    private String deviceId;    
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        
        // 依序傳入Activity, TWMAdSize, 以及Ad Unit Id
        // TWMAdSize 包括TWMAdSize.BANNER,TWMAdSize.IAB_MRECT,TWMAdSize.IAB_BANNER,TWMAdSize.IAB_LEADERBOARD
        adView = new TWMAdView(this,TWMAdSize.BANNER,AD_UNIT_ID ); 
        LinearLayout root = (LinearLayout)findViewById(R.id.root);
        root.addView(adView); 
        // 載入廣告
        adView.loadAd(new TWMAdRequest());	
        // 若需要設定為測試模式, 則改以下述的方式進行廣告的請求
        
        deviceId = getDeviceId(getBaseContext());
        // adView.loadAd(new TWMAdRequest().addTestDevice(deviceId));
    }    
    private String getDeviceId(final Context context) {
        String deviceId = null;
        try {
                deviceId = android.provider.Settings.Secure.getString(
                                context.getContentResolver(), Secure.ANDROID_ID);
                if (deviceId!= null) {
                   return convertToMD5ID(deviceId);
                }
        } catch (Exception e) {
                Log.e("getDeviceId", e.getMessage(), e);
        }
        return deviceId;
    }
    private String convertToMD5ID(final String string) {
        if (string == null) {
                return null;
        }
        try {
            MessageDigest md = MessageDigest.getInstance("MD5");
              md.update(string.getBytes());
              BigInteger number = new BigInteger(1, md.digest());
              String md5 = number.toString(16);
              while (md5.length() < 32)
            md5 = "0" + md5;
            return md5;
        } catch (NoSuchAlgorithmException e) {
            return null;
        }
    }
 }
::*或將TWMAdView宣告於佈局XML中, 程式碼只需執行loadAd()載入廣告
 <?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_Video_Ads_2.0|Video Ads]]