Vpon – 記下來

Vpon CN在台灣地區請款動作說明

黃小蛙 — Sat, 30 Jun 2012 07:18:34 +0000

(2013-09-05 更新) 之前小蛙有寫過Vpon的教學文章<Google AdWhirl with Vpon @ 蛙齋>，Vpon與KuAd是台灣兩家比較有規模的行動廣告商，但Vpon在大陸也有相關業務，因此如果是要在對岸顯示廣告，可能就必須選擇在大陸也有該廣告業務的廠商才可以，小蛙並不太清楚Vpon CN的規模大不大、營運好不好，但從最近90天廣告填充率來看，填充率介於3.05% ~ 28.68%，(2013-08-25 在大陸芒果移動廣告的討論區中，Vpon CN 的填充率似乎已經低於小蛙當時的數字了)。不知道是小蛙設定方式有誤還是Vpon在大陸的廣告商並不多，但這種極低的填充率，實在不是一件好事 … 逼的小蛙只好以Admob為主，Vpon CN來塞塞Admob缺少的填充率 ~_~

由於遇到台灣對大陸的請款動作，Vpon CN請款真的是花了好長好長的時間才完成，希望這篇文章能幫助到有類似問題的開發者(應該很少吧！)，在這邊很感謝Alex的幫忙(恭喜升官囉!)以及後來接手的Jay。如果這篇文章不適合，請來信告知！
針對大陸匯款到台灣開發商部分小蛙跟Vpon反應過，Vpon表示這部分的不足，他們也已經著手進行，希望讓台灣開發商使用Vpon CN時的請款動作能夠更簡便，不用像小蛙一樣從今年初一直到五六月款項才入帳…這是漫長的等待。目前台灣開發者要從Vpon CN請款是非常麻煩的一件事，有要掛大陸當地廣告的開發者要先有個覺悟，但一回生二回熟，相信現在應該慢慢的會變得容易許多(在新平台、新策略還沒開放之前)，要注意Vpon TW跟Vpon CN是不一樣的，註冊供選擇，那 ~ 如果人在台灣，又沒有大陸帳戶該怎麼辦呢？這是個很弔詭的時候要確定是TW還是CN喔！下圖是Vpon CN後台請款帳號設定，明眼人應該一看就可以發現，只有「國內匯款」可的部分，經過了漫長的email往來之後才知道，付款資料設定並不會「完全」詳細檢查，也就是除了個人身分證號之外，其他匯款資料都填上，納稅方使選擇「提供收據」，唯獨個人身分證字號怎麼樣都不可能通過，台灣的身分證字號怎麼樣也都只有英文字+九碼呀！這該怎麼辦呢？了解到剛剛那句話的含義了嗎？『付款資料設定並不會「完全」詳細檢查』，小蛙心想應該這個制度要早點修改吧！不然也許有一天會出事情！

付款帳號設定完成之後，就沒什麼困難的地方了，接著進行請款動作，填上要請款的金額，最後把收據填寫完成後，附上以下資料傳真到Vpon TW(02-25469026)，再由Vpon TW協助傳遞給Vpon Cn進行出帳動作。

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在台灣地區請款動作說明最早出現於記下來。

Google AdWhirl with Vpon

黃小蛙 — Sun, 08 Jan 2012 12:21:03 +0000

(2012-07-20 更新)前面幾篇小蛙陸續介紹了Google AdWhirl串接kuAD, AdMob，以及單獨使用AdMob(單獨使用Vpon或kuAD只要直接下載匯入範例就可以囉！)，今天要來記錄Google AdWhirl with Vpon，算是三者之中最麻煩的。

由於Vpon會需要用到QRCode讀取套件，因此將Vpon導入Android App中會有比kuAD, AdMob更多步驟，小蛙在導入Vpon的時候發生了很多怪怪的問題，包括了type 17錯誤(已經分不清楚是AdWhirl還是Vpon的錯誤了)，就算直接用Sample Code修改adOnKey也還是沒辦法顯示(adOnKey在官網上的顯示是「版位ID」或是英文界面的叫「Banner ID」)，小蛙弄到三更半夜還是沒辦法顯示，即使官網上狀態已經顯示「運作中」。今天來記錄一下Google AdWhirl + Vpon。
Vpon註冊及設定部份由於都是中文也還蠻簡單的，這部份小蛙就跳過，如果在註冊上有遇到任何問題也可以直接留言給小蛙，Google AdWhirl設定也跟串接kuAD的時候差不多，只是Function name把它改成容易辨識的名稱，例如：kuAD小蛙取「showKuAD」，就以此類推地把Vpon取名叫做「showVpon」吧！(再次強調這篇使用的是Google AdWhirl)
Vpon AdWhirl比Google AdWhirl多了一個「地區判斷」的功能，因為Vpon是以在地化廣告為宣傳，因此Vpon團隊在AdWhirl中加入了台灣地區及大陸地區的判斷，如果使用者在台灣就會撥放台灣的廣告，反之亦然。由於剛開始串接Vpon的時候遇到了很多奇奇怪怪的問題，因此小蛙使用Google AdWhirl，但新版Vpon AdWhirl應該已經做了修正，如果有兩岸廣告撥放需求的朋友，可以直接使用Vpon AdWhirl來做串接，官方文件提供了詳細的說明。
強烈建議在串接AdWhirl之前，先下載Vpon官方範例程式，修改adOnKey之後跑跑看，如果廣告都沒出現的話，就不用串接了！是不會成功的！使用Vpon AdWhirl串接的朋友可以參考以下方法：

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

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

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

在AndroidManifest.xml中加入以下activity，要放在之間。

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

確定都沒有紅色叉叉後，加入呼叫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();
	    }
        });
    }
}

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

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

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