Cobub Razor
Cobub Toaster
其它鏈接
這是本文檔舊的修訂版!
安裝好Web Server后,到管理后臺注冊應(yīng)用,填寫應(yīng)用的相關(guān)信息。App建立成功后,可獲得該App的Appkey。
導(dǎo)入Windows phone SDK到工程中:
下載最新版本的sdk的壓縮包,解壓將其中的UMSAgent.dll釋放到本地目錄。
VS用戶右鍵工程選“Reference”選項,然后選擇“Add Reference”選項,子目錄下選擇“Browse”,選擇指向UMSAgent.dll的路徑。最后,點擊OK,導(dǎo)入成功。
建議在所有頁面調(diào)用
UmsAgent. UMSApi.onPageBegin(“page_name”);
和
UmsAgent. UMSApi.onPageEnd("page_name ");
如果在某些頁面中不添加也可以,但會造成相應(yīng)頁面的使用時間等相關(guān)信息統(tǒng)計不到。
UMSAgent.UMSApi.onAppStart(string appKey,string url);
Appkey: 服務(wù)器端生成的應(yīng)用的KEY。
url: 服務(wù)器的URL。
確認在APP.xmal.cs 文件中的Application_Launching(object sender, LaunchingEventArgs e)方法中調(diào)用了該方法。否則,其他的方法將無法使用。
UMSAgent.UMSApi.setDebugMode(boolean isDebugMode);
isDebugMode
true:輸出日志
false:不輸出
如果需要查看異常或者錯誤報告,可以在任何地方調(diào)用該API,不過只能查看到那些在調(diào)用該API之后的異常和錯誤。
UmsAgent.UMSApi.updateOnlineConfig();
在Application_Launching(object sender, LaunchingEventArgs e)方法中調(diào)用,SDK將聯(lián)網(wǎng)檢測您的在線配置,將這些信息保存在本地。否則,SDK將按照默認發(fā)送策略上傳數(shù)據(jù)到服務(wù)器。
版本號為WMAppManifest.xml中的Version值。
UMSAgent.UMSApi.getNewVersion();
如果開發(fā)了新的應(yīng)用,請在服務(wù)端創(chuàng)建新的應(yīng)用版本。 調(diào)用該方法應(yīng)用將會自動檢測是否有更高版本的應(yīng)用。如果有新的版本會提示用戶更新,如果用戶選擇更新應(yīng)用,系統(tǒng)會自動為用戶更新應(yīng)用(根據(jù)應(yīng)用的版本號檢查是否更新)。
UmsAgent. UMSApi.onPageBegin(string pagename);
pagename: 需要統(tǒng)計的頁面名
在頁面的OnNavigatedTo()方法中調(diào)用該方法,該方法將會記錄用戶進入該頁面的時間。
UmsAgent. UMSApi.onPageEnd(“page name “)
在頁面的OnNavigatedFrom()方法中調(diào)用該方法,該方法將會記錄用戶離開該頁面的時間。
注:上述兩個方法應(yīng)成對的調(diào)用。
除了基本統(tǒng)計分析功能外,我們還支持您自定義的事件統(tǒng)計分析,例如您可以統(tǒng)計廣告點擊次數(shù)或者視頻被播放的次數(shù)等等,這里我們將提供幾個簡單而通用的接口。
UMSAgent.UMSApi.onEvent(string event_id,string pagename);
page:為當(dāng)前頁面的引用,
event_id:為當(dāng)前統(tǒng)計事件的ID。
在您需要發(fā)送事件報告的代碼段,調(diào)用如下方法就可以向服務(wù)器發(fā)送事件記錄,將統(tǒng)計event_id對應(yīng)事件發(fā)送次數(shù),變化趨勢,例如廣告點擊,短信發(fā)送量等等。event_id在服務(wù)器后端定義。
比如,監(jiān)測應(yīng)用程序里“MainPage”頁面的廣告的點擊次數(shù),事件ID為“ad_click”。那么需要在程序里每次廣告點擊時調(diào)用UMSAgent.UMSApi.onEvent(“ad_click“, “MainPage”)通知服務(wù)器一個廣告點擊事件發(fā)生。
UMSAgent.UMSApi.onEvent(string event_id, string pagename,string label);
這是UMSAgent.UMSApi. onEvent(string event_id,string pagename)的一個重載方法。
除了能夠統(tǒng)計event_id所對應(yīng)事件的發(fā)生次數(shù),變化趨勢外,還能統(tǒng)計事件中具體標(biāo)簽所占的比例,label為當(dāng)前標(biāo)簽,同樣這里的event_id字符串中不能含有空格。例如:在應(yīng)用程序中省份對應(yīng)一個event_id,每個城市對應(yīng)一個label,這樣我們可以在生成的統(tǒng)計分析表中看到不同城市的比例。
UMSAgent.UMSApi.onEvent(string event_id, string pagename, int acc);
對于程序中的某些可能被頻繁觸發(fā)的事件,開發(fā)者可以在程序中維護一個計數(shù)器,這樣事件被多次觸發(fā)只需要生成一個到服務(wù)器的消息,這個消息包括該事件被觸發(fā)的次數(shù),這里我們做了重載:
UMSAgent.UMSApi.onEvent (string event_id,string pagename,int acc); UMSAgent.UMSApi.onEvent(string event_id, string pagename, string label, int acc);
label:該事件的label屬性。
acc:是對應(yīng)事件被觸發(fā)的次數(shù)。
UMSAget.UMSApi. bindUserIdentifier(string userid);
調(diào)用該方法可以把用戶的賬號,如社交網(wǎng)絡(luò)帳號,手機號等跟應(yīng)用進行綁定。
UMSAgent.UMSApi.postTag(string tag);
綁定用戶的tag并發(fā)送至后臺。