百度APP調(diào)起SDK詳細(xì)設(shè)計標(biāo)準(zhǔn)文檔

1、一、背景在android和ios的設(shè)備上的某些瀏覽器以通過deeplink的鏈接調(diào)起相應(yīng)的app, 調(diào)起app之f，需要對調(diào)起的時叫長度進(jìn)行統(tǒng)計，以及從搜索結(jié)果頁到app內(nèi)的用戶在調(diào)起 p在app屮的停留時間，外通過這些統(tǒng)汁數(shù)裾來分析，從搜索結(jié)果分發(fā)的流:w:是否能夠給用 戶帶米更好的體驗(yàn)。二、調(diào)起的流程調(diào)起的整個過程簡單的來說，就是從網(wǎng)頁屮點(diǎn)擊調(diào)起的按鈕，然f打開對成的app。1、前端頁而屮，將點(diǎn)擊的url設(shè)置成調(diào)起的uri;2、打開對應(yīng)的應(yīng)用，應(yīng)用解析扣應(yīng)的調(diào)起uri參數(shù)；3、sdk獲取調(diào)起的統(tǒng)計參數(shù)，sdk發(fā)送統(tǒng)計字段。已t飲(4>正在下級(0)三、sdk設(shè)計figure 1 sd

2、k 處理邏輯*四、sdk的功能產(chǎn)品的需求是統(tǒng)計app從網(wǎng)頁中點(diǎn)擊到app打開的調(diào)起吋間，以及調(diào)起之后用戶在ap p屮停留的時叫。sdk的功能是統(tǒng)計調(diào)起時叫和用戶在調(diào)起的app屮的停留時間。調(diào)起時間的實(shí)現(xiàn)方式和計算規(guī)則。用戶點(diǎn)擊web頁曲中的按鈕，生成一個時間戳，app 打開后，將相應(yīng)的web的時間戳通過uri參數(shù)的形式帶入到app中，并解析，同吋生成一個 當(dāng)前的系統(tǒng)時i川戳，兩者的差值即為調(diào)起時長。調(diào)起時長=app打開時間戳一網(wǎng)頁上鏈接點(diǎn)擊時間戳app中的停留時間的實(shí)現(xiàn)方式和計算規(guī)則。停留的截止點(diǎn)存在兩種情況，一種是app 退出了，一種情況是app被用切換到后臺了，無論哪種情況，會在這兩個吋間

3、點(diǎn)中選擇一 個截止時悶點(diǎn)。停留時長=app到后臺或者退出的時間一 app打開的時間戳。五、sdk的兼界性sdk在設(shè)計的過程中已經(jīng)考慮了對現(xiàn)冇的調(diào)起生態(tài)的兼容，部分應(yīng)用已經(jīng)冇（m定義的s cheme, sdk不會改變現(xiàn)冇的調(diào)起的scheme,與scheme無失。sdk是通過在現(xiàn)有的應(yīng)川的s cheme后添加參數(shù)的方式新增字段來處理，理論上應(yīng)用開發(fā)者通過提取data中的值就可以 實(shí)現(xiàn)對有沒有新增參數(shù)進(jìn)行兼界，但部分開發(fā)者存在代碼屮的hardcode，或者考慮不全等 問題，因此新増參數(shù)也需要考慮新舊版本的兼容性。應(yīng)用中己經(jīng)在manifest中注冊的scheme,不會新增或省改變己有的調(diào)起scheme

4、,如 卜samp1ecode:activity android:name=z，com. example, android. recipeactivity" android: 1 abel=/zstring/title recipe" >intent-filter android:label二"string/filter title viewrecipe <action android:name=z/android. intent, action. view" />category android:name=android. intent

5、, category. default77 /> category android:nameandroid. intent, category. browsable" /><! accepts urts that begin with baidumusic:/hybrid ”>/產(chǎn)品線保持不變data android:scheme二"baidumusic,android: hosthybr id7>/intent-filter</activity>為了更好的突出代碼重點(diǎn)，例圖如下:< activity agp:物及捆廁g= &

6、quot;g姍ag禪賺!g'a照也9辿!曲?卜string/則虧也）兮">intent-filter gp愈gjjj j曼string/gj|grjjjg_yjgaction gq物j伽細(xì)/> 丄< category gq 電gj帥細(xì)/>1< category gq決碰;q疆"gq翻址城/>丄<!- accepts uris that begin with " baidumusic:/hybrid 11 ->/產(chǎn)品線保持不變，<data照也g j體撫臟="fe虛臘yjjg"各組無勛叉

7、爐"hybrid" /*</intent-filter>a /activitypapp調(diào)起后，請求中會新增調(diào)起參數(shù)，需要考慮到對新增uri的兼容性處理，以百度翻 譯app為例如下:舊uri為bai dutranslate:/home?query=such%20as&from=en&to=zhbaidutranslate:/home?query=such%20as&from=en&to=zh新uri為baidutranslate:/home?query=such%20as&from=en&to=zh&orig

8、in appsearch=xxxxx 1 &baiduid=xxxxxxx2&ts appsearch=xxxxx3baidutranslate:/home?query=such%20as&from=en&to=zh&origin_appsearch=xxxxxl &jdy0=xxxxxxx2&ts_appsearch=xxxxx3 psdk會忽略scheme的改變或者不一致帶來的變化，會將該部分的兼界性處理放在前端 進(jìn)行，從而保證sdk在盡nj能大的范圍內(nèi)對現(xiàn)有的app的scheme進(jìn)行兼容。cookie + t imespam, t

9、imespam本分也要川于調(diào)起吋長的處理；pv-id,沿川百度搜索現(xiàn)冇的處理方式。單用戶單次點(diǎn)擊的區(qū)分web的進(jìn)程空間和app的進(jìn)程空間是獨(dú)立的，如何將web屮的單個川戶的單次點(diǎn)擊和a pp中的單個川戶的該次調(diào)起行為進(jìn)行統(tǒng)一足sdk需要考慮的一個設(shè)計點(diǎn)。目前的單個用廣 的通過cookie進(jìn)行區(qū)分，多瀏覽器的多cookie,默認(rèn)當(dāng)做多個用戶進(jìn)行區(qū)分，單個用戶的 單次點(diǎn)擊通過點(diǎn)擊的timespam進(jìn)行區(qū)分。但搜索本身有單個用戶的單次點(diǎn)擊的統(tǒng)計字段pv -id,因此，前端在擴(kuò)展字段中傳入pv-id也是支持的。那么整體來說，有兩種區(qū)分辦法：1. cookie + time spam, timespam

10、本身也要用于調(diào)起時長的處理;2. pv-id,沿用百度搜索現(xiàn)冇的處理方式。六、防作弊策略r前sdk設(shè)計上，充分考慮吋能出現(xiàn)的作弊場景，依托成熟的商業(yè)化反作弊策略，完 成丫對于作弊行為的監(jiān)控。監(jiān)控到異常情況，會根據(jù)相關(guān)數(shù)據(jù)進(jìn)行遲查，確認(rèn)如果存在作弊行為，將會進(jìn)行嚴(yán)肅處理。七、android sdk接入方法1.在工程目錄下導(dǎo)入 appsearch-android-sdk. jar。2.在網(wǎng)貞鏈接調(diào)用app的activity文件下添加：.import com. baidu. appscarchlib. naslib; 在 oncreateo 函數(shù)屮添加涵數(shù) naslib. onclient (con

11、textcontext); demo：©overrideprotected void oncreate(bundle savedtnstancestate)super. oncreate(savedtnstancestate); setcontentview(r. layout. activity_main);naslib. onclient(this);為了更好的突出代碼重點(diǎn)，例圖如下： .pjjjggrt g遲，組i血收在 oncreate(函數(shù)中娥加函數(shù)齡從context context); o demo：overridevoid oncreate(bundlepnaslib

12、or?c lient(t hi s； 一 b即可完成sdk的調(diào)用。一八、ios sdk接入方法1.獲取 sdk： sdk 包含 libappsearch. a 靜態(tài)庫與 baiduappsearch. h 頭文件 2.將 libappsearch. a 和 baiduappsearch. h 拷貝到工程目錄下q搜索git一 statictest.xcodeprojstatictesth appdelegate.h m appdelegate.massets.xcassets h baiduappsearch.hlase.iprojinfo.plist § libappsearch.a

13、m main.m h viewcontroller.h m viewcontroller.m3將 libappsearch. a 和 baiduappsearch. h 加入丄程gj| oldlicieblrvikeystatictesth appdelegate.h m appdelegate.m h viewcontroller.h m viewcontroller.n main.storyboan assets.xcasseti launchscreen.;show in finderopen with external editoropen asshow file inspectora

14、dd files to “statictest”.info.plistdeletebrty i :iveers supporting filesm main.m productsjire inte jfil > ca facnew groupnew group from selectionsort by name sort by typefind in selected groupssource controlproject navigator help00favorites o recents a應(yīng)用程序 s desktop ®文稱 o下裁devices ©遠(yuǎn)程光盤

15、tags 紅色 參橙色黃色綠色 藍(lán)色ssih-statictestappoelegate.happdelegate.m5 libappsearch.amain.mviewcontroller.hviewcontroller.mnew folder options(s c3 q searchcancel add4. 査看項目->build phase->link binary with libraries-是否存在 libappsearch. a的依賴& statictestgeneral capabilities resource tags1+ target depende

16、ncies (0 items)info build settings build phases build rules® filteridectestctest compilo sources (3 items) link binary with libraries (1 item)i namelibappsearch.arequired $drag to reorder frameworkspropn copy bundle resources (3 items)soi如果不存在，請點(diǎn)擊左丁角+號并且添加靜態(tài)鏈接庫依賴5. 在 uiapplication 的委派對象(appdele

17、gate)中復(fù)寫 openurl 和 app 1 icationdident erbackground方法并在:k內(nèi)添加相夫的sdk代碼-(bool)application:(utapplicat ion *)application openurl: (nsurl *)url sourceapplication: (nsstring *)sourceapplicationannotation: (id)annotation baiduappsearch sharcdlnstance onclient: url absolutestring; return yes;(void)ppplicationdidenterbackground:(utapplication 氺)application baiduappsearch sharcdlnstance onexit;為了更好的突出代碼重點(diǎn)，例圖如下:-(bool)dpplication:(