kuSOGI – 記下來

wayStorm 威數意動 (kuAD, kuSOGI) 請款流程

黃小蛙 — Sun, 25 Aug 2013 04:21:29 +0000

又是一次隔了好久才進行的請款 … 整個過程有點模糊了，每次要請款都要去翻以前的 email，邊看記錄邊回想，因為有些是透過電話聯絡！想說乾脆記下來好了，免得每次都要大費周章浪費不少時間。

首先，如果從來沒有請過款的開發者遇到要請款的情況，請務必先跟自己的服務人員聯絡！確定是否有新的請款流程，否則可能會浪費很多郵寄等待的時間，後台的範本也可能會有出錯的情況喔！小蛙上一次詢問過的問題是「財務帳本」跟「應用程式APP」兩邊統計的數字不一樣，經過詢問是以「應用程式APP」的為準。
請款單部分小蛙填錯好幾次，小蛙記得第一次寄去沒有跟任何服務人員聯絡，竟然就這樣石沉大海，什麼事情都沒有發生 … 款項也遲遲沒有下來，為了減少等待時間，還是跟服務人員確認過之後再進行動作！
倘若您從來不知道有服務人員這件事情的話，那也切記先 email 給 wayStorm 的客服信箱(pr@wayStorm.com)，讓客服人員安排一位服務人員跟您接洽！
請款流程圖，小蛙記錄一些要注意的部分。
1. 只有第一次請款必須要附上存摺影本跟身分證正反面影本，第二次以後只要請款單即可！
2. 最低請款金額 $3,000。
3. 請款單上交來 ________ 款項，把所有要請款的 APP 列上去，可以多個 APP 合併湊滿 $3,000。
4. 若合併申報多個 APP，務必在請款單上註明每個 APP 名稱、申請區間(一定要以完整的月份為單位)、金額。
5. 申請表請務必蓋章及簽名，缺一不可。
6. 一定要用郵寄的，不能用傳真或掃描 email。
7. 扣 10% 稅額的部分最容易搞混，小蛙的服務人員寄了一張下表，簡單說就是沒超過 $20,000 的話，那 10% 不用扣，沒超過 $5,000 的話也不用扣二代健保的 2%。

話說最近 kuad 廣告載入速度越來越慢，小蛙也轉向其他廣告商，讓 kuad 投放比例降低 … 希望 kuad 官方能早點重視這個問題！
參考資料：

wayStorm威數意動 – kuAD行動廣告媒體行銷

http://www.kusogi.com/index.htm

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

Google AdWhirl with kuAD

黃小蛙 — Sat, 07 Jan 2012 08:21:10 +0000

(2012-04-06 更新)接續上一篇，小蛙繼續記錄使用Google AdWhirl銜接kuAD，kuAD是由kuSOGI酷手機多媒體公司提供，有很多知名軟體都與kuSOGI合作，例如：休息一夏、ATM達人免費版、PlurkQ、台灣特賣會、台灣天氣資訊…等，更多資訊請到酷手機合作軟體查詢。

kuAD申請跟設定的方式跟AdMob其實差不多，不外乎註冊帳號、新增應用程式，輸入一些必要資訊，接著就會讓開發者下載kuAD套件。這裡有一個要注意的部分是如果要再下載一次套件，要連結到http://app.kusogi.com/sdk.html下載，或者是要編輯資料之後，才會在出現下載套件的選項(如下圖)。最重要的APID先記錄下來，等一下會使用到。

編輯完資料後才會再出現下載SDK選項(之前小蛙不知道可以到http://app.kusogi.com/sdk.html下載)，同時也有kuAD說明文件但沒有提到如何串接AdWhirl(也可能有只是小蛙沒找到)。

偷懶很快地跳過kuAD註冊流程 … 要透過AdWhirl串接的話，還需要到Google AdWhirl設定與kuAD的關聯。到AdWhirl中設定Networks，由於Google官方的AdWhirl並沒有內建對kuAD的串接方法，所以這邊我們必須新增一個讓AdWhirl可以知道要做什麼的事件，Add Custom Event –> 名字輸入自己可以辨認得就好，Function Name輸入等一下要從Android程式中呼叫的函式。設定好之後把kuAD Ad Serving打開，% of Traffic設成100%，別忘記最下方的Save Changes。

接下來進行Android程式的部份，將剛剛下載的kuAD_android.zip(如果解壓縮有遇到錯誤，請參考WinRAR解壓縮亂碼)，解壓縮完可以看到kuADSample資料夾, kuAD 1.3.1a.jar, kuAD 1.3.1.jar，kuADSample資料夾可以直接import到Eclipse中(不知道怎麼匯入專案，請參考Eclipse匯入專案)，小蛙在這邊建議要用AdWhirl串接kuAD之前先使用kuADSample看看能不能正常顯示，免得串接之後卻發生一堆讓人摸不著頭緒的問題，而執行kuADSample也很容易，依照Eclipse匯入專案這篇文章操作後就已經完成匯入了，最後一個步驟只需要修改com.sample套件中的kuADSample.java，把banner.setAPID(“ZZZZZ0100”);的ZZZZZ0100改成自己的APID就可以運行了。如果連這個範例都沒辦法顯示出廣告的話，更別提串接AdWhirl，小蛙在這邊卡了很久，如果改了還是沒辦法顯示出廣告，小蛙建議可以直接寫信去問技術人員，也許是哪裡出了問題(Vpon就遇到完全無法顯示，小蛙弄到三更半夜卡了好久還是出不來，問了技術人員才得到「我們技術上出了一些問題，已修正！」的答案…)確定這邊可以呈現出廣告之後，再繼續下面的步驟。
串接AdWhirl來說，小蛙覺得kuAD算是最簡單的了(Vpon最複雜，步驟也多)，首先先將kuAD 1.3.1.jar加入到專案的Java Build Path –> libraries中。在AndroidManifest.xml中加入必要的user permission。官方文件。

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

最後程式碼的部份。

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 with AdMob by Google

黃小蛙 — Sat, 07 Jan 2012 05:59:22 +0000

AdWhirl是一套廣告輪播平台，開發者如果同時有許多廣告商，例如：AdMob, Vpon, KuAD …等等，就可以透過AdWhirl依照自己的需求來設定百分比輪播廣告，這篇文章小蛙要記錄使用Google AdWhirl來播放AdMob廣告。

可能有些人會覺得如果只用AdMob就依照上一篇文章使用AdMob就好啦！為什麼還要用到AdWhirl，如果只是要放AdMob的確不需要用到AdWhirl，小蛙會用到AdWhirl的原因是想比較各家廣告商在同一期間內可以獲得的收益狀況，還有一個原因是對於台灣地區來說，由於在地化的關係，Vpon及KuAD撥放出來的廣告會比AdMob的廣告更容易吸引使用者。
千萬注意，這邊小蛙用的AdWhirl是Google AdWhirl by AdMob(https://www.adwhirl.com/)，由於AdWhirl是Google Project中的Open Source，所以各家廣告商為了吸引開發商或廣告主，都會打著「整合AdWhirl平台，可以輪播自己想要的廣告」的名號，像Vpon自己的AdWhirl就增加了「自動判斷地區」的服務，由於Vpon服務的客戶有台灣地區及大陸地區，如果能在台灣地區撥放台灣當地的廣告，大陸地區撥放大陸當地的廣告，這樣會使的廣告的投放更有效率(我們會去擊點不相關廣告的機率應該很低吧！比如說在台灣卻去點廣州車商的特惠活動，不小心點到另當別論)；kuSOGI也推出自己的AdWhirl，其中強調的就是可以「同時」(也就是設定比例自動輪播)自家的kuAD以及上面提到的Vpon與AdMob廣告。下面三張圖是三家廣告商的AdWhirl，除了網址列之外，網頁外觀一模一樣，不小心就會搞錯。
Google AdWhirl

kuSOGO AdWhirl

Vpon AdWhirl

如同Android一般，AdWhirl由於是Open Source，意味著各家廠商可以依照自己的需求更改程式碼，也使得各家的AdWhirl可能會有不同的行為模式，Google AdWhirl的使用方法未必會與Vpon AdWhirl或kuSOGI AdWhirl相同，小蛙還是要強調這篇文章記錄的是Google AdWhirl，接下來進入正題。

AdWhirl申請及設定

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

在Android程式中加入AdWhirl + AdMob

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

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

程式碼的部份。

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

這時候會遇到一個錯誤。解決辦法就是把專案的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

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

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