安裝好Web Server后，到管理后臺(tái)注冊(cè)應(yīng)用，填寫應(yīng)用的相關(guān)信息。App建立成功后，可獲得該App的Appkey。

導(dǎo)入Windows phone SDK到工程中：

下載最新版本的sdk的壓縮包，解壓將其中的UMSAgent.dll釋放到本地目錄。

VS用戶右鍵工程選“Reference”選項(xiàng)，然后選擇“Add Reference”選項(xiàng)，子目錄下選擇“Browse”,選擇指向UMSAgent.dll的路徑。最后，點(diǎn)擊OK，導(dǎo)入成功。

建議在所有頁(yè)面調(diào)用

UmsAgent. UMSApi.onPageBegin(“page_name”);

和

UmsAgent. UMSApi.onPageEnd("page_name ");

如果在某些頁(yè)面中不添加也可以，但會(huì)造成相應(yīng)頁(yè)面的使用時(shí)間等相關(guān)信息統(tǒng)計(jì)不到。

• 確認(rèn)AppKey正確。
• 在其他方法調(diào)用前最先調(diào)用UmsAgent.UMSApi.onAppstart(String appkey,string url)方法。
• SDK可以幫您捕捉用戶在使用應(yīng)用過(guò)程中出現(xiàn)的異常退出（FC），并將錯(cuò)誤報(bào)告發(fā)送給服務(wù)器，錯(cuò)誤報(bào)告包含應(yīng)用程序版本、操作系統(tǒng)版本和設(shè)備型號(hào)以及程序出現(xiàn)異常時(shí)的Stacktrace，這些數(shù)據(jù)將幫助您修改應(yīng)用程序的Bug。
• 不同的渠道AppKeys須不同。

UMSAgent.UMSApi.onAppStart(string appKey,string url);

Appkey: 服務(wù)器端生成的應(yīng)用的KEY。

url: 服務(wù)器的URL。

確認(rèn)在APP.xmal.cs 文件中的Application_Launching(object sender, LaunchingEventArgs e)方法中調(diào)用了該方法。否則，其他的方法將無(wú)法使用。

UMSAgent.UMSApi.setDebugMode(boolean  isDebugMode);

isDebugMode

true:輸出日志

false:不輸出

如果需要查看異常或者錯(cuò)誤報(bào)告，可以在任何地方調(diào)用該API，不過(guò)只能查看到那些在調(diào)用該API之后的異常和錯(cuò)誤。

UmsAgent.UMSApi.updateOnlineConfig();

在Application_Launching(object sender, LaunchingEventArgs e)方法中調(diào)用,SDK將聯(lián)網(wǎng)檢測(cè)您的在線配置，將這些信息保存在本地。否則，SDK將按照默認(rèn)發(fā)送策略上傳數(shù)據(jù)到服務(wù)器。

版本號(hào)為WMAppManifest.xml中的Version值。

UMSAgent.UMSApi.getNewVersion();

如果開(kāi)發(fā)了新的應(yīng)用，請(qǐng)?jiān)诜?wù)端創(chuàng)建新的應(yīng)用版本。 調(diào)用該方法應(yīng)用將會(huì)自動(dòng)檢測(cè)是否有更高版本的應(yīng)用。如果有新的版本會(huì)提示用戶更新，如果用戶選擇更新應(yīng)用，系統(tǒng)會(huì)自動(dòng)為用戶更新應(yīng)用（根據(jù)應(yīng)用的版本號(hào)檢查是否更新）。

UmsAgent. UMSApi.onPageBegin(string pagename);

pagename: 需要統(tǒng)計(jì)的頁(yè)面名

在頁(yè)面的OnNavigatedTo()方法中調(diào)用該方法，該方法將會(huì)記錄用戶進(jìn)入該頁(yè)面的時(shí)間。

UmsAgent. UMSApi.onPageEnd(“page name “)

在頁(yè)面的OnNavigatedFrom()方法中調(diào)用該方法，該方法將會(huì)記錄用戶離開(kāi)該頁(yè)面的時(shí)間。

注：上述兩個(gè)方法應(yīng)成對(duì)的調(diào)用。

除了基本統(tǒng)計(jì)分析功能外，我們還支持您自定義的事件統(tǒng)計(jì)分析，例如您可以統(tǒng)計(jì)廣告點(diǎn)擊次數(shù)或者視頻被播放的次數(shù)等等，這里我們將提供幾個(gè)簡(jiǎn)單而通用的接口。

UMSAgent.UMSApi.onEvent(string event_id,string pagename);

page：為當(dāng)前頁(yè)面的引用，

event_id：為當(dāng)前統(tǒng)計(jì)事件的ID。

在您需要發(fā)送事件報(bào)告的代碼段，調(diào)用如下方法就可以向服務(wù)器發(fā)送事件記錄，將統(tǒng)計(jì)event_id對(duì)應(yīng)事件發(fā)送次數(shù)，變化趨勢(shì)，例如廣告點(diǎn)擊，短信發(fā)送量等等。event_id在服務(wù)器后端定義。

比如，監(jiān)測(cè)應(yīng)用程序里“MainPage”頁(yè)面的廣告的點(diǎn)擊次數(shù)，事件ID為“ad_click”。那么需要在程序里每次廣告點(diǎn)擊時(shí)調(diào)用UMSAgent.UMSApi.onEvent(“ad_click“, “MainPage”)通知服務(wù)器一個(gè)廣告點(diǎn)擊事件發(fā)生。

UMSAgent.UMSApi.onEvent(string event_id, string pagename,string label);

這是UMSAgent.UMSApi. onEvent(string event_id,string pagename)的一個(gè)重載方法。

除了能夠統(tǒng)計(jì)event_id所對(duì)應(yīng)事件的發(fā)生次數(shù)，變化趨勢(shì)外，還能統(tǒng)計(jì)事件中具體標(biāo)簽所占的比例，label為當(dāng)前標(biāo)簽，同樣這里的event_id字符串中不能含有空格。例如：在應(yīng)用程序中省份對(duì)應(yīng)一個(gè)event_id，每個(gè)城市對(duì)應(yīng)一個(gè)label，這樣我們可以在生成的統(tǒng)計(jì)分析表中看到不同城市的比例。

UMSAgent.UMSApi.onEvent(string event_id, string pagename, int acc);

對(duì)于程序中的某些可能被頻繁觸發(fā)的事件，開(kāi)發(fā)者可以在程序中維護(hù)一個(gè)計(jì)數(shù)器，這樣事件被多次觸發(fā)只需要生成一個(gè)到服務(wù)器的消息，這個(gè)消息包括該事件被觸發(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：是對(duì)應(yīng)事件被觸發(fā)的次數(shù)。

UMSAget.UMSApi. bindUserIdentifier(string userid);

調(diào)用該方法可以把用戶的賬號(hào)，如社交網(wǎng)絡(luò)帳號(hào)，手機(jī)號(hào)等跟應(yīng)用進(jìn)行綁定。

UMSAgent.UMSApi.postTag(string tag);

綁定用戶的tag并發(fā)送至后臺(tái)。