1. wayStorm威數意動 – kuAD行動廣告媒體行銷
   
   http://www.kusogi.com/index.htm

這篇文章 wayStorm 威數意動 (kuAD, kuSOGI) 請款流程 最早出現於 記下來。

Beneficiary's Bank : HSBC Bank (Taiwan) Limited
Bank Addres : 13F and 14F., No.333, Sec. 1, Keelung Rd., Xinyi District, Taipei City 110
Swift Code : HSBCTWTP
Account No. : 美金帳戶帳號
Beneficiary’s Name : 美金帳戶名稱(英文)

這邊要注意的是請款時間為每月的1~5日，出帳時間為每月的20日，在請款過程中最好先跟Vpon CN服務人員聯絡，免得卡在某個環節失敗又要等下個月才能再次申請 … Good Luck!! HSBC Direct相關文章-<Google Admob透過HSBC Direct電匯方式請款>。
2013-08-06
Vpon 的客服人員 email 又開始遲遲不回應了！小蛙來看看要等多久才會有回應！寫完信的當天下午收到 Vpon TW 服務人員的 email。
2013-08-21
Vpon 告知後台已經請 FAE 人員協助處理完畢，小蛙這邊再送一次請款單。
2013-09-05
收到一封信被告之要補齊資料，詢問 Jay 後，Jay 請小蛙再提供一次資料給 Vpon CN 的 Pharaoh，那之前的資料來往耗時到底在做什麼？因為這些資料早就已經給過 Jay 了 … 整個感覺非常非常差，還寫了一封信來說其實請款沒那麼複雜，只要把資料填齊就可以了，小蛙當然知道這件事，沒填齊要怎麼申請，問題是後台根本沒有可以給小蛙填資料的部份，信中提到納稅方式小蛙勾選了”提供發票”，這個小蛙要怎麼說呢？因為表單上只有這個選項，而且預設就選定了，也無法取消 … 這部份在幾個月前也已經反應給客服過了！到現在也還是一樣。要補齊證件號碼(護照號，台胞證，回鄉證)，這三個小蛙沒有，之前 Alex 說使用”特殊方法”取得 … 上次申請不用 20% 稅，這次個人戶要扣掉 20% 稅，哀 ~ Vpon 加油，如果不願意讓台灣人申請 Vpon CN，就把規則講清楚 …

這篇文章 Vpon CN在台灣地區請款動作說明 最早出現於 記下來。

android.permission.WRITE_EXTERNAL_STORAGE

當使用者要下載這個軟體的時候，就會看到以下資訊來告訴使用者，這個軟體可能會對自己的手機做哪些事情(大概想像成使用Facebook應用程式的時候，會跳出一個視窗詢問使用者是否允許該應用程式執行以下動作，如果點選取消就一番兩瞪眼，沒有辦法使用，想用就只能點接受…)。

儲存空間
修改/刪除 USB 儲存裝置內容和 SD 卡內容
允許應用程式寫入 USB 儲存裝置和 SD 卡。

權限說明寫的就是軟體可以對手機做的「完整動作」，但並不代表軟體「一定」會去做這些動作，面對使用者的質疑，開發者也是很為難的，小蛙也是被問一次解釋一次，後來決定寫一篇文章直接連結 … (沒辦法，小蛙太懶了…)，上面那個例子感覺還蠻合理的，來看下一個也是大家關心的GPS的部分。

約略位置 (以網路為基準)
在可能的情況下，存取約略的位置來源資訊 (例如：行動網路資料庫)，
以計算裝置的大概位置。請注意，惡意應用程式可能會利用這項功能得知您的約略位置。
精確定位 (GPS)
在可能的情況下，接收精確的位置來源資訊 (例如：裝置 GPS)。
請注意，惡意應用程式可能會利用這項功能得知您的位置，並消耗更多電量。

面對許多使用者的質疑小蛙也要替自己的軟體講幾句話，
第一、如果GPS沒有開啟的情況下，並不會「自動開啟」，還是會先詢問使用者。
第二、小蛙的軟體也只是套用了廣告商(例如：kuAD、Vpon、Admob…等)，而現在LBS正夯，廣告商也希望可以把廣告在地化，做更有效的播送，對廣告主、廣告公司以及開發商都是有利的。
以下是節錄自wiki對LBS的說明。

位基服務可以被應用與不同的領域，例如：健康、工作、個人生活等。此服務可以用來辨認一個人或物的位置，例如發現最近的提款機或朋友同事的目前的位置，也能透過客戶目前所在的位置提供直接的手機廣告，並包括個人化的天氣訊息提供，甚至提供在地化的遊戲。

再來一個更嚇人的吧！

手機通話
讀取手機狀態和識別碼
允許應用程式存取裝置的電話功能資料。具備此權限的應用程式不論是否在通話中，
皆可取得手機的號碼和序號，以及通話對象的電話號碼等資料。

有些人可能心裡大罵「搞什麼鬼，我看個股票 / 玩個明星臉，也要我的所有資訊，連手機機碼都要？我跟哪個妹聊天的電話號碼也不放過，真是天殺的太機車了。」關於這個權限小蛙也不知道該怎麼解釋才好，總總的原因就在kuAD官方說明文件中：

在AndroidManifest.xml中加入以下必要權限:
<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"/>

上面的android.permission.READ_PHONE_STATE就是「讀取手機狀態和識別碼」的權限，所以說開發者也是相當無奈，如果要放廣告就必須要加入這個權限，不加入廣告公司就不鳥開發者，但是加了這個權限就導致使用者有更多疑慮與恐懼，害怕自己的資料會被竊取(小蛙以前也會這樣子)，所以咧！開發者也只能「保證」自己絕對不會竊取使用者的資料，也不會隨意散佈或使用這些資料，像小蛙是根本就沒有去讀取這些資料，只是要讓程式可以正常運行，就必須要有這個權限(越講越複雜了，不知道大家有沒有聽懂)。如此一來如果真的遇到無良開發者，也防不慎防阿！因此才會有些使用者看到這些權限就卻步(搞不好看完這篇文章把軟體刪掉的使用者更多?!)，不過這也沒辦法，相信小蛙的就會相信，不相信的就還是會刪掉，大概就像如果今天下載的是Facebook for Android, Line, WhatsApp, AngryBird，可能使用者就沒有這種疑慮，開玩笑，這麼大的公司一定不會做這種缺德事(?!)相對於一些小的開發者，像是小蛙這種，就會有使用者「懷疑」自己的資料會不會被竊取，但說實話，這些懷疑是合理的！
不知道經過小蛙這樣混亂的介紹之後，大家有沒有對這些疑慮比較消除一些(如果是加重的話，小蛙也沒辦法了…^^”)

這篇文章 Android權限列表(Manifest.permission)及使用者疑慮 最早出現於 記下來。

<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 最早出現於 記下來。