「Android SDK Developer Guide」修訂間的差異

出自TAMedia
跳至導覽 跳至搜尋
imported>Wikiuser
imported>Wikiuser
（正在將頁面替換為 'Download Getting Started Banner Ads Interstitial Ads Android_Integeration wi...'）
行 1： 行 1：
== Android SDK Developer Guide ==
[[Download]]
*SDK相容性
:目前SDK相容於下列Android系統版本
:#Android 2.2
:#Android 2.3
:#Android 3.x
:#Android 4.x
*整合至應用程式
:*將adpmobile-lib.jar加入Android Project中<br/>將adpmobile-lib.jar檔案加入至Android Application Project當中。<br/>對Project點選右鍵點選'''Properties -> 點選 Java Build Path -> 點選Add External JARs''' [[檔案:1.png]]
:*加入必要權限<br/>TWMAd服務需使用”存取網路狀態”、”讀取約略位置”、”網路”等權限，請在AndroidManifest.xml檔案當中進行下列權限的宣告。
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> &lt;!-- optional --&gt;
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> &lt;!-- optional --&gt;
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
:*加入必要Activity<br/>宣告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=<nowiki>"http://schemas.android.com/apk/res/android"</nowiki>
    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廣告版位,<br/>請以下述方式進行Interstitial Ad版位的宣告<br/><b>注意：目前Interstitial廣告有相同版位ID在同一台裝置上，每天只會展示一次廣告的限制</b>
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整合
[[Android_Getting Started|Getting Started]]
::請至https://mediation.admob.com。
 
::登入AdMob(可能需要申請一個AdMob帳號或以Google帳號登入)，點選Sites & Apps > Ad Network Mediation。
[[Android_Banner Ads I|Banner Ads]]
::[[檔案:Android_5.png]]
 
::*新增Banner Ad
[[Android_Interstitial Ads|Interstitial Ads]]
:::點擊Add Network Mediation Placement新增一個Mediation Placement。
 
:::[[檔案:android_6.png]]
[[Android_Integeration with AdMob Mediation|Integration with AdMob Mediation]]
:::輸入Mediation名稱，選擇Platform、Ad Size及Automatic Refresh。若您的Mediation Placement有2個以上的廣告時，AdMob SDK每5分鐘(300秒)會抽取(依聯播網分配比率)下一個Ad Network。Automatic Refresh的設定，是指這5分鐘內，更新同一個Ad Network內容。完成後按Save & Continue。
:::[[檔案:android_7.png]]
:::請在這一步直接按最下方continue(或是可以勾選您目前擁有的Ad Network)。
:::[[檔案:android_8.png]]
:::<呈現mediation設定畫面, 請將本畫面所提供的mediation_id紀錄下來>
:::[[檔案:android_9.png]]
:::按下Add Custom Event
:::[[檔案:android_10.png]]
:::Label：TAMedia (可自訂)
:::Class Name：<b>com.taiwanmobile.pt.adp.mediation.TAMediaBanner</b>
:::Parameter：<b>請填入您的TAMedia Slot Id (可向您的TAMedia窗口詢問)</b>
:::完成後按下Save
:::若有希望數個AdNetwork能均等投放廣告, 請將eCPM欄位填入同樣的數值
:::[[檔案:android_11.png]]
::*整合至應用程式
::TAMedia對Mediation的支援採用外掛函式庫的方式，可輕易的整合。將外掛函式庫(可於下方連結取得madp-sdk-plugin-mediation-android-x.x.x.jar)加入專案的build path當中
::[[媒體:TAMedia Android SDK.zip|Download Android SDK and Sample]]
::加入必要的權限<br/>TWMAd服務需使用”存取網路狀態”、”讀取約略位置”、”網路”等權限，請在AndroidManifest.xml檔案當中進行下列權限的宣告。
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> &lt;!-- optional --&gt;
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> &lt;!-- optional --&gt;
<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" />
&lt;!-- Google AdMob Activities --&gt;
<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小時後生效。
 
*畫面展示
{| width="70%" border="1"
|-
| align="center" | 應用程式開啟
| align="center" | 點擊Banner後開啟網頁
| align="center" | 點擊Banner後撥打電話
|-
| align="center" | [[檔案:2.png]]
| align="center" | [[檔案:3.png]]
| align="center" | [[檔案:4.png]]
|}

於 2014年2月17日 (一) 02:27 的修訂

Download

Getting Started

Banner Ads

Interstitial Ads

Integration with AdMob Mediation

取自「https://wiki.tamedia.com.tw/wiki/index.php?title=Android_SDK_Developer_Guide&oldid=39」