智能小程序平臺(tái)正式開放掃描普通鏈接二維碼跳轉(zhuǎn)小程序的能力,該功能充分兼容線下已部署的二維碼資源,為小程序開發(fā)者提供了更為便捷高效的推廣路徑,助力企業(yè)快速實(shí)現(xiàn)線上線下的流量互通與用戶觸達(dá)。
普通鏈接二維碼特指開發(fā)者通過專用工具對(duì)網(wǎng)頁鏈接進(jìn)行編碼處理后生成的二維碼標(biāo)識(shí)。線下商戶無需更換現(xiàn)有二維碼資源,僅需在智能小程序后臺(tái)完成簡(jiǎn)單配置,即可實(shí)現(xiàn)用戶掃描普通鏈接二維碼時(shí)自動(dòng)跳轉(zhuǎn)至小程序,并直接調(diào)用小程序內(nèi)的各項(xiàng)功能服務(wù)。目前,該功能已全面支持通過百度App“掃一掃”識(shí)別二維碼并完成小程序跳轉(zhuǎn)。
本功能面向企業(yè)、媒體、政府及其他組織類型的小程序開放,覆蓋多元化的應(yīng)用場(chǎng)景,滿足不同主體對(duì)小程序推廣與用戶服務(wù)的需求。
自2018年8月起,百度App支持二維碼規(guī)則基于“子路徑匹配”的跳轉(zhuǎn)邏輯。例如,若原有二維碼鏈接為`https://www.baidu.com/a/123456`(其中123456為業(yè)務(wù)參數(shù)),開發(fā)者可配置規(guī)則`https://www.baidu.com/a/`,實(shí)現(xiàn)用戶掃描時(shí)跳轉(zhuǎn)至對(duì)應(yīng)小程序。百度App掃碼跳轉(zhuǎn)需遵循以下匹配原則:二維碼鏈接的協(xié)議、域名與后臺(tái)配置的規(guī)則需完全一致;二維碼鏈接需屬于后臺(tái)配置規(guī)則的子路徑(支持子路徑匹配時(shí),后臺(tái)配置規(guī)則需以“/”結(jié)尾);若規(guī)則包含參數(shù),鏈接“?”后的參數(shù)部分需滿足前綴匹配條件。
常見匹配錯(cuò)誤類型包括:后臺(tái)配置規(guī)則與線下二維碼完整鏈接因協(xié)議(如http與https)或域名(如www.baidu.com與m.baidu.com)不一致導(dǎo)致匹配失敗;參數(shù)不滿足前綴匹配(如規(guī)則參數(shù)id=123與鏈接參數(shù)id=132);鏈接不屬于子路徑(如規(guī)則`https://www.baidu.com/a/b`與鏈接`https://www.baidu.com/a/bc`);規(guī)則未以“/”結(jié)尾導(dǎo)致不支持子路徑匹配。
開發(fā)者需完成以下操作獲取二維碼內(nèi)容:在智能小程序后臺(tái)配置二維碼跳轉(zhuǎn)小程序規(guī)則;使用百度App(客戶端版本10.12及以上)掃描二維碼打開小程序;二維碼鏈接內(nèi)容將以參數(shù)“q”的形式傳遞至頁面,開發(fā)者可在`onLoad`事件中提取該參數(shù),并通過`decodeURIComponent`方法解碼,即可獲取原二維碼的完整內(nèi)容。
登錄智能小程序后臺(tái),進(jìn)入“設(shè)置-開發(fā)設(shè)置-掃普通二維碼打開小程序”頁面,點(diǎn)擊“添加”配置二維碼規(guī)則。填寫規(guī)則時(shí)需注意:二維碼域名須通過ICP備案驗(yàn)證;支持http、https、ftp開頭的鏈接(如`https://www.baidu.com`、`https://www.baidu.com/mp/`);單個(gè)小程序賬號(hào)最多配置10個(gè)二維碼前綴規(guī)則。
完成規(guī)則填寫后,需下載隨機(jī)校驗(yàn)文件并上傳至服務(wù)器指定目錄:文件需放置于URL聲明的最后一級(jí)子目錄下,若無子目錄則放置于服務(wù)器頂層目錄。隨后填寫小程序功能頁面路徑(如`pages/index/index`),并選擇是否占用符合匹配規(guī)則的所有子規(guī)則(選擇占用后,其他賬號(hào)不可申請(qǐng)使用該前綴下的子規(guī)則)。
填寫測(cè)試鏈接(每個(gè)規(guī)則最多5個(gè),可修改多次)并驗(yàn)證:若二維碼與測(cè)試鏈接匹配,且用戶為小程序管理員或開發(fā)者,將打開指定版本小程序;測(cè)試僅對(duì)指定鏈接和測(cè)試用戶生效,其他用戶掃碼跳轉(zhuǎn)網(wǎng)頁。完成測(cè)試后,點(diǎn)擊“保存并提交”即可添加二維碼規(guī)則。
測(cè)試通過后,開發(fā)者可將二維碼跳轉(zhuǎn)規(guī)則發(fā)布至現(xiàn)網(wǎng),發(fā)布后所有符合匹配規(guī)則的掃碼行為將直接跳轉(zhuǎn)至指定小程序頁面。需注意:最多可添加10個(gè)二維碼規(guī)則地址;單個(gè)小程序賬號(hào)每月最多發(fā)布20次規(guī)則;小程序代碼需先發(fā)布方可發(fā)布二維碼跳轉(zhuǎn)規(guī)則,以確保用戶體驗(yàn)。