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

實作方式

• 廣告初始設置

Layout (XML範例)	Activity(Java)
<?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>	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(YourActivity.this, TWMAdSize.BANNER, AD_UNIT_ID); RelativeLayout root = (RelativeLayout) findViewById(R.id.ad_container); root.addView(adView);

您也可以將TWMAdView宣告於佈局XML中，在Java程式內透過findViewById取得TWMAdView

<?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(adView != null) {
     // 呼叫TWMAdView.destroy()
     adView.destroy();
   }
   super.onDestroy();
 }
 @Override
 protected void onResume() {
   if(adView != null) {
     // 呼叫TWMAdView.resume()
     adView.resume();
   }
   super.onResume();
 }
 @Override
 protected void onPause() {
   if(adView != null) {
     // 呼叫TWMAdView.pause()
     adView.pause();
   }
   super.onPause();
 }

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

 adView.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){
      // 用戶點擊廣告後,將要啟動新的應用程式時通知
   }   
 });

• 建立 TWMAdRequest

請求廣告前，你需要創建一個TWMAdRequest物件

 TWMAdRequest request = new TWMAdRequest();

若額外設置使用者生日，可讓您的APP獲得更多元的廣告內容

使用Date	使用Calendar
TWMAdRequest request = new TWMAdRequest(); try { //定義好時間字串的格式 SimpleDateFormat sdf = new SimpleDateFormat("yyyy/MM/dd", Locale.getDefault()); //將字串轉成Date型 Date birthDate = sdf.parse("1992/01/01"); // 將生日加入request request.setBirthday(birthDate); }catch (Exception e) {}	// 創建Calerdar並設定生日 (注意! 月份的編號是由0至11) Calendar birthDate = Calendar.getInstance(); // 設定生日為1992/01/01 birthDate.set(1992, 0, 1); // 將生日加入request TWMAdRequest request = new TWMAdRequest(); request.setBirthday(birthDate);

• 請求廣告

請將TWMAdReqeust物件傳入loadAd

 adView.loadAd(request);	

• 測試模式

如有需要，您可開啟測試模式來獲取測試廣告

 String 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;
    }
 }

畫面展示

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

回首頁