Android SDK Developer Guide

Android SDK Developer Guide

• SDK相容性

目前SDK相容於下列Android系統版本

1. Android 2.2
2. Android 2.3
3. Android 3.x
4. Android 4.x

• 整合至應用程式

• 將adpmobile-lib.jar加入Android Project中
  將adpmobile-lib.jar檔案加入至Android Application Project當中。
  對Project點選右鍵點選Properties -> 點選 Java Build Path -> 點選Add External JARs
• 加入必要權限
  TWMAd服務需使用”存取網路狀態”、”讀取約略位置”、”網路”等權限，請在AndroidManifest.xml檔案當中進行下列權限的宣告。

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> 
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> <!-- optional -->
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> <!-- optional -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

• 加入必要Activity
  宣告TWMAdActivity。

<activity android:name="com.taiwanmobile.pt.adp.view.TWMAdActivity" />
<activity android:name="com.taiwanmobile.pt.adp.view.TWMAdViewActivity" />

• 宣告Banner廣告版位

• 透過layout.xml的方式進行宣告

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
   android:layout_width="fill_parent"
   android:layout_height="fill_parent"
   android:orientation="vertical" >
   <com.taiwanmobile.pt.adp.view.TWMAdView
       android:id="@+id/adview"
       android:layout_width="wrap_content"
       android:layout_height="wrap_content" >
   </com.taiwanmobile.pt.adp.view.TWMAdView>
</LinearLayout>

• 透過程式進行宣告

public class MainActivity extends Activity {
private TWMAdView adView = null;
@Override
   public void onCreate(Bundle savedInstanceState) {
       super.onCreate(savedInstanceState);
       setContentView(R.layout.main);
       adView = new TWMAdView(this); 
       LinearLayout root = (LinearLayout)findViewById(R.id.root);
       root.addView(adView); 
   }	
   @Override
   protected void onStart() {
       super.onStart();
       adView.activeAd("<Your Slot ID>","<Your name>","0",”640x100”);
   }
}

• 啟動Banner廣告服務

void com.taiwanmobile.pt.adp.view.TWMAdView.activeAd(String slotId, String vendorId, String testmark, String format)
Parameters: 
slotId 廣告版位Id 
vendorId 開發者Id 
testmark 是否測試標籤 , 0:表正式服務,1:表進行測試中
format 版位大小, 可選640x100, 320x320, 300x250, 1024x90, 728x90, 468x60, 110x700, 640x640

輸入相關參數啟動廣告服務

@Override
protected void onStart() {
   super.onStart();
   adView.activeAd("<Your Slot ID>","<Your name>","0",”640x100”);
}

• 宣告Interstitial廣告版位,
  請以下述方式進行Interstitial Ad版位的宣告
  注意：目前Interstitial廣告有相同版位ID在同一台裝置上，每天只會展示一次廣告的限制

twmAdViewInterstitial = new TWMAdViewInterstitial(this);
twmAdViewInterstitial.setTWMAdViewListener(new TWMAdViewListener() {
  @Override
  public void onReceiveAd(View view) { //call twmAdViewInterstitial show
 	twmAdViewInterstitial.show();
  }
  @Override
  public void onFailedToReceiveAd(View view) {  //onFailedToReceiveAd
  }
});

• 啟動Interstitial廣告服務

void com.taiwanmobile.pt.adp.view.TWMAdViewInterstitial.activeAd(String slotId, String vendorId, boolean testmark)
Parameters: 
slotId 廣告版位Id 
vendorId 開發者Id 
testmark 是否測試標籤 , false:表正式服務,true:表進行測試中

輸入相關參數啟動廣告服務

twmAdViewInterstitial.activeAd("<Your Slot ID>", "<Your name>", true);

• AdMob Mediation整合

請至https://mediation.admob.com。

登入AdMob(可能需要申請一個AdMob帳號或以Google帳號登入)，點選Sites & Apps > Ad Network Mediation。

• 新增Banner Ad

點擊Add Network Mediation Placement新增一個Mediation Placement。

輸入Mediation名稱，選擇Platform、Ad Size及Automatic Refresh。若您的Mediation Placement有2個以上的廣告時，AdMob SDK每5分鐘(300秒)會抽取(依聯播網分配比率)下一個Ad Network。Automatic Refresh的設定，是指這5分鐘內，更新同一個Ad Network內容。完成後按Save & Continue。

請在這一步直接按最下方continue(或是可以勾選您目前擁有的Ad Network)。

<呈現mediation設定畫面, 請將本畫面所提供的mediation_id紀錄下來>

按下Add Custom Event

Label：TAMedia (可自訂)

Class Name：com.taiwanmobile.pt.adp.mediation.TAMediaBanner

Parameter：請填入您的TAMedia Slot Id (可向您的TAMedia窗口詢問)

完成後按下Save

若有希望數個AdNetwork能均等投放廣告, 請將eCPM欄位填入同樣的數值

• 整合至應用程式

TAMedia對Mediation的支援採用外掛函式庫的方式，可輕易的整合。將外掛函式庫(可於下方連結取得madp-sdk-plugin-mediation-android-x.x.x.jar)加入專案的build path當中

Download Android SDK and Sample

加入必要的權限
TWMAd服務需使用”存取網路狀態”、”讀取約略位置”、”網路”等權限，請在AndroidManifest.xml檔案當中進行下列權限的宣告。

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> 
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> <!-- optional -->
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> <!-- optional -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

加入必要Activity

<activity android:name="com.taiwanmobile.pt.adp.view.TWMAdActivity" />
<activity android:name="com.taiwanmobile.pt.adp.view.TWMAdViewActivity" />
<!-- Google AdMob Activities -->
<activity
android:name="com.google.ads.AdActivity"
android:configChanges=
  "keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize"/>

在layout檔案中加入可放置廣告的LinearLayout(※僅供參考,開發者可依照自訂的layout進行配置使用)

<LinearLayout
android:id="@+id/Layout_AdView"
android:layout_width="wrap_content"
android:layout_height="wrap_content" />

在程式加入Ad的宣告

 public class MainActivity extends Activity {
  LinearLayout layout = null;
  @Override
  public void onCreate(Bundle savedInstanceState) {
   super.onCreate(savedInstanceState);
   setContentView(R.layout.main);
   layout = (LinearLayout) this.findViewById(R.id.Layout_AdView);
   adView = new AdView(activity, AdSize.BANNER, "<Mediation ID>");
   layout.addView(adView);
   adView.loadAd(new AdRequest());
  }

• 聯播網投放與維護

當APP設定好Mediation並且發佈出去後，可直接透過Mediation網頁進行版位管理與聯播網比率調整，此設定會在1小時後生效。

• 畫面展示

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