1. 註冊Vpon帳號及Vpon AdWhirl帳號(這跟Google AdWhirl不同)
2. 在Vpon AdWhirl中新增應用程式(參考AdWhirl with AdMob by Google步驟5)
3. 下載最新版的Vpon套件及範例程式。可以在Vpon + AdWhirl SDK中找到。
4. 解壓縮後，把專案匯入到Eclipse中(匯入方式請參考Eclipse匯入專案)。小蛙測試時的版本為「android-sdk-adwhirl-3.0.3n」，匯入時選擇「adOnSample_withAdapters」資料夾。
5. 將com.android.vpon.addon.AdOnSampleActivity.java中的String adWhirlKey = “ChangeMe“;修改成步驟2得到的SDK Key
6. 直接在手機或模擬器上測試就完成了！

上面測試沒有問題才繼續以下部份。下面的步驟紀錄串接Google AdWhirl + Vpon。

1. 將上面專案中res/values下的attrs.xml, colors.xml, ids.xml, strings.xml複製到自己專案下，要注意檔案覆蓋問題，保險起見可以開啟這些檔案，例如：開啟strings.xml並複製裡面內容貼到自己的strings.xml。途中有錯誤都先別理它，最後再處理。(2012-07-20 更新)感謝網友ws提醒，要把layout下的capture.xml也複製到自己專案下的layout資料夾裡。
   
2. 用WinRAR分別開啟Google AdWhirl及Vpon AdWhirl，這個目的是要把Vpon的adapter抓到Google AdWhirl中使用(直接把com\adwhirl\adapters\AdOnCNAdapter.class, AdOnTWAdapter.class拉到Google AdWhirl中)。
   
3. 將必須的JAR加入Java Build Path中(kuAD, GoogleAdMobAdsSdk如果沒使用可以不用理它們)。
   
4. 在AndroidManifest.xml中加入以下user permission。

   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
   <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
   <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
   <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
   <uses-permission android:name="android.permission.CAMERA"/>
   <uses-feature android:name="android.hardware.camera" />
   <uses-feature android:name="android.hardware.camera.autofocus" />

5. 在AndroidManifest.xml中加入以下activity，要放在<application></application>之間。

   <activity android:name="com.vpon.adon.android.WebInApp"
       android:configChanges="orientation|keyboardHidden|navigation|keyboard"
       android:label="@string/app_name"/>
       <activity android:name="com.vpon.adon.android.CrazyAdRun"
           android:configChanges="orientation|keyboardHidden|navigation|keyboard"
           android:label="@string/app_name"
           android:theme="@android:style/Theme.Translucent" />
       <activity android:name="com.vpon.adon.android.webClientHandler.QRActivity"
           android:finishOnTaskLaunch = "true"
           android:clearTaskOnLaunch = "true"
           android:configChanges="keyboardHidden|navigation|keyboard" />
       <activity android:name="com.vpon.adon.android.webClientHandler.ShootActivity"
           android:finishOnTaskLaunch = "true"
           android:clearTaskOnLaunch = "true"
           android:configChanges="keyboardHidden|navigation|keyboard" />
       <activity android:name="com.google.zxing.client.android.HelpActivity"
           android:finishOnTaskLaunch = "true"
           android:clearTaskOnLaunch = "true"
           android:configChanges="keyboardHidden|navigation|keyboard" />
       <activity android:name="com.google.zxing.client.android.CaptureActivity"
           android:finishOnTaskLaunch = "true"
           android:clearTaskOnLaunch = "true"
           android:configChanges="orientation|keyboardHidden"
           android:screenOrientation="landscape"
           android:theme="@android:style/Theme.NoTitleBar.Fullscreen"
           android:windowSoftInputMode="stateAlwaysHidden">
               <intent-filter>
                   <action android:name="com.google.zxing.client.android.SCAN"/>
                   <category android:name="android.intent.category.DEFAULT"/>
               </intent-filter>
       </activity>
       <!-- kuad 的，沒用到kuad的話要拿掉 -->
       <activity android:name="com.kuad.ADDisplay"/>
       <!-- AdMob的 -->
       <activity android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize"
           android:name="com.google.ads.AdActivity" />

6. 將上面專案中src下除了com.android.vpon.adon以外的package全部複製下來。
   
7. 在自己專案中的src下貼上。
   
8. 有幾個package及檔案會出現紅色叉叉。
   
9. 開啟有紅色叉叉的檔案，置換.R檔的正確位置(自己主要專案的package)

   //import com.android.vpon.adon.R; //change import
   import com.hans.adwhirl.R;

10. 確定都沒有紅色叉叉後，加入呼叫AdWirl程式碼。

    package com.hans.adwhirl;
    import com.adwhirl.AdWhirlLayout;
    import com.adwhirl.AdWhirlManager;
    import com.adwhirl.AdWhirlTargeting;
    import com.adwhirl.AdWhirlLayout.AdWhirlInterface;
    import com.adwhirl.AdWhirlLayout.ViewAdRunnable;
    import com.adwhirl.util.AdWhirlUtil;
    import com.kuad.KuBanner;
    import com.kuad.kuADListener;
    import com.vpon.adon.android.AdListener;
    import com.vpon.adon.android.AdOnPlatform;
    import com.vpon.adon.android.AdView;
    import android.app.Activity;
    import android.os.Bundle;
    import android.util.Log;
    import android.widget.LinearLayout;
    import android.widget.LinearLayout.LayoutParams;
    public class TestAdWhirlActivity extends Activity implements AdWhirlInterface {
        AdWhirlLayout adWhirlLayout;
        private static final String ADWHIRL_KEY		= "換成自己的Google AdWhirl Key";
        @Override
        public void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setContentView(R.layout.main);
            // 預留放置廣告的layout
            LinearLayout layout = (LinearLayout)findViewById(R.id.mainLayout);
            // 初始化 adwhirl layout
            adWhirlLayout = new AdWhirlLayout(this, ADWHIRL_KEY);
            AdWhirlManager.setConfigExpireTimeout(1000 * 60);
            // 年齡
            AdWhirlTargeting.setAge(23);
            // 性別
        	AdWhirlTargeting.setGender(AdWhirlTargeting.Gender.MALE);
        	// 郵遞區號
        	AdWhirlTargeting.setPostalCode("115");
        	// 是否為測試模式，上架時要改成false
        	AdWhirlTargeting.setTestMode(true);
        	// 這行千萬不可以漏掉
        	adWhirlLayout.setAdWhirlInterface(this);
        	// 將 adwhirl layout 放入我們預留的顯示廣告的 layout 中
        	layout.addView(adWhirlLayout);
        }
        @Override
        public void adWhirlGeneric() {
    	// TODO Auto-generated method stub
        }
        public void showVpon(){
    	AdView adView = new AdView(this);
    	adView.setLicenseKey("Vpon Banner ID 輸入在這邊(版面ID)", AdOnPlatform.TW, false);
    	adView.setAdListener(new AdListener() {
        	    @Override
                public void onRecevieAd(AdView adView) {
        	        Log.d(AdWhirlUtil.ADWHIRL, "Vpon ad success");
                    adWhirlLayout.adWhirlManager.resetRollover();
    	        adWhirlLayout.handler.post(new ViewAdRunnable(adWhirlLayout, adView));
    	        adWhirlLayout.rotateThreadedDelayed();
    	    }
    	    @Override
    	    public void onFailedToRecevieAd(AdView adView) {
                    Log.d(AdWhirlUtil.ADWHIRL, "Vpon ad failure");
    	        adView.setAdListener(null);
    	        adWhirlLayout.rollover();
    	    }
            });
        }
        // for kuAD
        /*
        public void showKuAD(){
            Log.e("showKuAD", "showKuAD()");
    	final KuBanner banner = new KuBanner(this);
    	banner.setAPID("如果有用kuAD的話，kuAD的APID");
    	banner.setLayoutParams(new LayoutParams(LayoutParams.FILL_PARENT, LayoutParams.WRAP_CONTENT));
    	banner.setkuADListener(new kuADListener() {
    	    @Override
    	    public void onRecevie(String arg0) {
    	        Log.e("onRecevie", "onRecevie -> " + arg0);
    		adWhirlLayout.adWhirlManager.resetRollover();
    		adWhirlLayout.handler.post(new ViewAdRunnable(adWhirlLayout, banner));
    		adWhirlLayout.rotateThreadedDelayed();
    	    }
    	    @Override
    	    public void onFailedRecevie(String arg0) {
    		Log.e("onFailedRecevie", "showKuAd -> " + arg0);
    		banner.setkuADListener(null);
    		adWhirlLayout.rollover();
    	    }
            });
        }
    }

11. 可以丟到模擬器或手機上執行囉！

這篇文章 Google AdWhirl with Vpon 最早出現於 記下來。

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

在AndroidManifest.xml中新增一個Activity(要放在<application></application>之間)。

<activity android:name=\"com.kuad.ADDisplay\"/>

最後程式碼的部份。

package com.hans.adwhirl;
import com.adwhirl.AdWhirlLayout;
import com.adwhirl.AdWhirlManager;
import com.adwhirl.AdWhirlTargeting;
import com.adwhirl.AdWhirlLayout.AdWhirlInterface;
import com.adwhirl.AdWhirlLayout.ViewAdRunnable;
import com.kuad.KuBanner;
import com.kuad.kuADListener;
import android.app.Activity;
import android.os.Bundle;
import android.util.Log;
import android.widget.LinearLayout;
import android.widget.LinearLayout.LayoutParams;
public class TestAdWhirlActivity extends Activity implements AdWhirlInterface {
    AdWhirlLayout adWhirlLayout;
    private static final String ADWHIRL_KEY		= "改成自己的AdWhirl Key";
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        // 預留放置廣告的layout
        LinearLayout layout = (LinearLayout)findViewById(R.id.mainLayout);
        // 初始化 adwhirl layout
        adWhirlLayout = new AdWhirlLayout(this, ADWHIRL_KEY);
        AdWhirlManager.setConfigExpireTimeout(1000 * 60);
        // 年齡
        AdWhirlTargeting.setAge(23);
        // 性別
    	AdWhirlTargeting.setGender(AdWhirlTargeting.Gender.MALE);
    	// 郵遞區號
    	AdWhirlTargeting.setPostalCode("115");
    	// 是否為測試模式，上架時要改成false
    	AdWhirlTargeting.setTestMode(true);
        // 這行如果漏掉會一直出現type 17的錯誤
    	adWhirlLayout.setAdWhirlInterface(this);
    	// 將 adwhirl layout 放入我們預留的顯示廣告的 layout 中
    	layout.addView(adWhirlLayout);
    }
    @Override
    public void adWhirlGeneric() {
        // TODO Auto-generated method stub
    }
    // 這個方法的名稱必須要跟上面AdWhirl設定的一模一樣
    public void showKuAD(){
        Log.e("showKuAD", "showKuAD()");
	final KuBanner banner = new KuBanner(this);
	banner.setAPID("改成上面申請的kuAD APID");
	banner.setLayoutParams(new LayoutParams(LayoutParams.FILL_PARENT, LayoutParams.FILL_PARENT));
        adWhirlLayout.pushSubView(banner);
	banner.setkuADListener(new kuADListener() {
	    @Override
	    public void onRecevie(String arg0) {
	        Log.e("onRecevie", "onRecevie -> " + arg0);
		adWhirlLayout.adWhirlManager.resetRollover();
		adWhirlLayout.rotateThreadedDelayed();
	    }
	    @Override
	    public void onFailedRecevie(String arg0) {
	        Log.e("onFailedRecevie", "showKuAd -> " + arg0);
		banner.setkuADListener(null);
		adWhirlLayout.rollover();
	    }
	});
    }
}

快上傳到手機或模擬器上試試看吧！

後記：
2012-04-06
小蛙今天在「我的股票精算師」中加入選單鍵可以讓使用者選擇要設定投資金額上限、備份、還原或是匯出成交資料…等等功能，卻發現一個驚人的事實，小蛙的做法是在TabHost上方加上kuAD banner，在某些情況下menu鍵會完整失效，試了一個下午，還以為是哪裡實作有問題，最後發現只要把kuAD banner註解掉，menu鍵就可以完整運作，目前只好先把kuAD banner移到軟體最下方…之後比較有時間再來想辦法，這裡很詭異的是把kuAD banner移到軟體下方就又可以正常使用，放在軟體上方時好時壞，從DDMS中看到在”某些情況”下，menu鍵的主控權會回到TabHost Activity中，而非個別Tab上造成，至於為什麼會有這種情況，今天小蛙還沒有找到答案。
2012-01-23
剛剛發現kuSOGI官網已經把SDK更新到1.3.5囉！而這一版本已經改掉了執行緒多開的問題！
2012-01-14
kuAD技術人員已經更改了新版的給小蛙測試，的確已經把跨頁會造成執行緒大開的情況修正掉，由於如果軟體一開始設計是以Activity為單位跳頁面，而非像fragment, activitygroup或tabactivity這種可以把廣告固定在每一頁下方，上述程式碼在新版的1.3.4+ kuAD.jar中是可以正常運作的，運作的結果跟Vpon一樣，只會有timed-wait的thread，而不會爆出大量native thread，看來要避掉這個問題只能用上述的三個方法了(activitygroup, tabactivity已經過期了)。上面的Code為修改過可以使用的，注意必須要搭配1.3.4+ kuAD.jar。今天測試Google AdWhirl當成全域變數嵌入頁面的方法，看起來Thread只會開一次，唯一的缺點只有跳頁的時候會閃爍一下，但廣告不用重新Loading，先memo一下要寫的東西「banner點擊後無法全螢幕顯示」、「繼承Application做法」。
2012-01-09
上面的 code 確定是有問題的，adWhirlLayout.handler.post(new ViewAdRunnable(adWhirlLayout, banner)); 這行在跨頁面的時候會造成背景開啟一大堆執行緒無法關閉，這個問題就算使用kuad官方的adwhirl也還是存在，小蛙已經回報給kuad技術人員，小蛙也還在等待kuad的回覆。確定可以執行後，小蛙會在這邊繼續記錄後續狀況。
2012-01-08
kuAD後來發現如果使用Google AdWhirl來執行，上面的範例會出錯，造成kuAD廣告快速撥放。
2012-01-07
小蛙的DDMS持續報以下錯誤，後來才發現是漏掉adWhirlLayout.setAdWhirlInterface(this);這行造成的。

01-07 16:24:54.564: D/AdWhirl SDK(2931): Showing ad:
01-07 16:24:54.564: D/AdWhirl SDK(2931): 	nid: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
01-07 16:24:54.564: D/AdWhirl SDK(2931): 	name: event
01-07 16:24:54.564: D/AdWhirl SDK(2931): 	type: 17
01-07 16:24:54.564: D/AdWhirl SDK(2931): 	key: kuAD|;|showKuAD
01-07 16:24:54.564: D/AdWhirl SDK(2931): 	key2:
01-07 16:24:54.574: D/AdWhirl SDK(2931): Valid adapter, calling handle()
01-07 16:24:54.574: D/AdWhirl SDK(2931): Event notification request initiated
01-07 16:24:54.574: W/AdWhirl SDK(2931): Event notification would be sent, but no interface is listening
01-07 16:24:54.574: E/AdWhirl SDK(2931): nextRation is null!

這篇文章 Google AdWhirl with kuAD 最早出現於 記下來。

• AdWhirl申請及設定

1. 到https://www.adwhirl.com/註冊一個Google AdWhirl帳號。
2. 認證完成功登入後進入「Apps」頁籤，點選「Add Application」。
3. 填入應用程式相關資訊，軟體名稱、應用程式URL(market連結)、廣告平台，其他的小蛙都是直接用預設值。(如果要取得地區資訊，把Allow Location Access改成ON)
   
4. 新增完成後就可以在程式列表中看到剛剛新增的應用程式，點選進去。
5. 點選AdMob旁邊的「Edit Settings」，將AdMob的發佈商ID填入(Google AdMob for Android步驟6)。並且將Ad Serving選擇成ON，% of Traffic設定成100%。每次更動都別忘了點選最下方有個「Save Changes」。到這邊AdWhirl就設定完畢了。接下來介紹在Android程式的部份。
   

• 在Android程式中加入AdWhirl + AdMob

1. 到「Dev Resources」頁面的「Download the lastest version」下載最新版的AdWhirl套件。
2. 下載「AdWhirlSDK_Android_3.1.1.zip」(視當時版本，總之選擇_Android就是了)
3. 解壓縮zip檔後得到AdWhirlSDK_Android_3.1.1.jar，與Google AdMob for Android步驟4得到的GoogleAdMobAdsSdk-4.3.1.jar加入到Eclipse中(加入的方法請參考Google AdMob for Android步驟10)。加入成功會在Eclispe專案中看到如下圖。
4. 先設定需要擺放廣告的layout，小蛙在主layout main.xml中新增了一個@+id/mainLayout來放置AdWhirl輪播的廣告。

   <?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" >
       <!-- 用來放置AdWhirl輪播的區塊 -->
       <LinearLayout
              android:id="@+id/mainLayout"
              android:layout_width="fill_parent"
              android:layout_height="wrap_content"
              android:paddingBottom="10dp">
       </LinearLayout>
   </LinearLayout>

5. 接著在AndroidManifest.xml加入user permission，並且加入一個新的Activity。。

   <?xml version="1.0" encoding="utf-8"?>
   <manifest xmlns:android="http://schemas.android.com/apk/res/android"
       package="com.hans.adwhirl"
       android:versionCode="1"
       android:versionName="1.0" >
       <uses-sdk android:minSdkVersion="8" />
       <!-- 必要 -->
       <uses-permission android:name="android.permission.INTERNET" />
       <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
       <!-- adwhirl 選用，如果有開啟地區偵測 -->
       <uses-permission android:name="android.permission.READ_PHONE_STATE" />
       <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
       <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
       <application
           android:icon="@drawable/ic_launcher"
           android:label="@string/app_name" >
           <activity
               android:label="@string/app_name"
               android:name=".TestAdWhirlActivity" >
               <intent-filter >
                   <action android:name="android.intent.action.MAIN" />
                   <category android:name="android.intent.category.LAUNCHER" />
               </intent-filter>
           </activity>
           <!-- 一定要新增用來播放廣告的Activity -->
           <activity
               android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize"
               android:name="com.google.ads.AdActivity" />
       </application>
   </manifest>

6. 程式碼的部份。

   package com.hans.adwhirl;
   import com.adwhirl.AdWhirlLayout;
   import com.adwhirl.AdWhirlManager;
   import com.adwhirl.AdWhirlTargeting;
   import com.adwhirl.AdWhirlLayout.AdWhirlInterface;
   import android.app.Activity;
   import android.os.Bundle;
   import android.widget.LinearLayout;
   public class TestAdWhirlActivity extends Activity implements AdWhirlInterface {
       AdWhirlLayout adWhirlLayout;
       private static final String ADWHIRL_KEY		= "換上自己的adwhirl_key";
       @Override
       public void onCreate(Bundle savedInstanceState) {
           super.onCreate(savedInstanceState);
           setContentView(R.layout.main);
           // 預留放置廣告的layout
           LinearLayout layout = (LinearLayout)findViewById(R.id.mainLayout);
           // 初始化 adwhirl layout
           adWhirlLayout = new AdWhirlLayout(this, ADWHIRL_KEY);
           AdWhirlManager.setConfigExpireTimeout(1000 * 60);
           // 年齡
           AdWhirlTargeting.setAge(23);
           // 性別
       	AdWhirlTargeting.setGender(AdWhirlTargeting.Gender.MALE);
       	// 郵遞區號
       	AdWhirlTargeting.setPostalCode("115");
       	// 是否為測試模式，上架時要改成false
       	AdWhirlTargeting.setTestMode(true);
       	// 將 adwhirl layout 放入我們預留的顯示廣告的 layout 中
       	layout.addView(adWhirlLayout);
       }
       @Override
       public void adWhirlGeneric() {
           // TODO Auto-generated method stub
       }
   }

7. 這時候會遇到一個錯誤。解決辦法就是把專案的SDK Version設定成3.2+(設定方法請參考Google AdMob for Android步驟11)

   Description	Resource	Path	Location	Type
   error: Error: String types not allowed (at 'configChanges' with value 'keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize').	AndroidManifest.xml	/TestAdWhirl	line 26	Android AAPT Problem

8. 如果錯誤還是存在，可以考慮Project –> Clean –> 選擇要清除的專案，執行完畢之後錯誤就消失了！
9. 趕快運行看看，就可以在模擬器或手機上看到Admob廣告囉！
   

這篇文章 AdWhirl with AdMob by Google 最早出現於 記下來。