百度智能小程序 書架同步功能介紹

書架同步功能介紹

為什么要接入百度 APP-書架同步功能

小程序使用百度 APP-書架同步能力后，用戶可將小程序里的內(nèi)容添加至百度 APP-書架（下文簡稱“書架”），以通過書架便捷回訪小程序，使小程序與用戶的交互更高效，縮短內(nèi)容重訪路徑，提高服務(wù)轉(zhuǎn)化。

入口便捷，解決小程序內(nèi)容重訪難問題

• 入口便捷易培養(yǎng)用戶習(xí)慣：書架入口位于“百度 APP-我的”頁面，只需簡單的引導(dǎo)，即可實現(xiàn)新手教育、培養(yǎng)用戶習(xí)慣。
• 快速回訪小程序內(nèi)容： 用戶可以在書架頁面直接跳轉(zhuǎn)至小程序內(nèi)容落地頁，實現(xiàn)高效重訪。

及時沉淀用戶，從單次消費到持續(xù)轉(zhuǎn)化

• 沉淀用戶提升留存： 百度 APP-書架重訪可以提升小程序與用戶交互效率，持續(xù)引導(dǎo)新手用戶轉(zhuǎn)化成忠誠用戶，提升用戶留存。
• 更懂用戶實現(xiàn)持續(xù)轉(zhuǎn)化： 通過用戶對內(nèi)容添加至?xí)艿刃袨閿?shù)據(jù)，開發(fā)者能夠了解用戶訴求，更針對性地服務(wù)用戶，促成復(fù)購和持續(xù)轉(zhuǎn)化。

什么內(nèi)容可被加入到百度 APP-書架

• 難以被用戶單次瀏覽完、正在持續(xù)更新、具備重復(fù)瀏覽價值等用戶期望后續(xù)繼續(xù)瀏覽的小程序內(nèi)容，均可以被加入到書架。
• 目前支持 專欄、文檔、視頻、漫畫 4 種小程序內(nèi)容類型。

百度 APP-書架入口

1. 書架入口位于“百度 APP-我的-書架”，用戶可以在此處查看所有被添加到書架的小程序內(nèi)容，并可點擊回訪內(nèi)容。

   




2. 用戶將小程序內(nèi)容成功加入書架后，會彈出 toast 引導(dǎo)用戶查看。

   







3. 開發(fā)者在小程序內(nèi)添加書架調(diào)起 API（詳見 swan.navigateToBookshelf）后，用戶可在小程序內(nèi)直接喚起百度 APP-書架頁面。

書架同步簡要原理

開發(fā)者調(diào)用百度提供的小程序 API，向書架同步“用戶-內(nèi)容”的映射關(guān)系，并且提供書架內(nèi)容查詢接口，供百度獲取內(nèi)容的基本信息用作展示和跳轉(zhuǎn)

其中，由開發(fā)者自定義的內(nèi)容 ID（contentId）作為小程序每條內(nèi)容的唯一標(biāo)識，串聯(lián)映射關(guān)系創(chuàng)建、映射關(guān)系查詢、書架內(nèi)容查詢等整個鏈路

百度提供的 API

• 添加書架‘用戶-內(nèi)容’關(guān)系（swan.insertBookshelf）：在百度書架服務(wù)中建立用戶和可被加入書架的內(nèi)容的映射關(guān)系，調(diào)用成功則表示該內(nèi)容被此用戶成功加入書架
• 查詢書架‘用戶-內(nèi)容’關(guān)系（swan.queryBookshelf）：查詢某用戶和某內(nèi)容之間是否存在書架映射關(guān)系，即查詢此用戶書架內(nèi)是否包含該內(nèi)容
• 從小程序內(nèi)跳轉(zhuǎn)到書架（swan.navigateToBookshelf）：調(diào)用可實現(xiàn)從小程序內(nèi)直接跳轉(zhuǎn)到百度 App-書架，方便小程序用戶回訪書架內(nèi)容
• 更新用戶-內(nèi)容的最近閱讀時間（swan.updateBookshelfReadtime）：可將用戶書架內(nèi)某條內(nèi)容的最近閱讀時間更新為當(dāng)前系統(tǒng)時間，最近閱讀時間會用于書架內(nèi)的小程序內(nèi)容的排序

需要開發(fā)者實現(xiàn)的接口

• 書架內(nèi)容查詢接口：當(dāng)用戶打開百度 APP-書架頁面時，百度根據(jù)存儲的‘用戶-內(nèi)容’映射關(guān)系，查詢書架內(nèi)的小程序內(nèi)容對應(yīng)的基本信息（如內(nèi)容標(biāo)題、封面圖、跳轉(zhuǎn)地址等），這些信息用于書架的小程序內(nèi)容展示和跳轉(zhuǎn)

書架同步開發(fā)流程

1. 小程序內(nèi)調(diào)用 API 實現(xiàn)書架功能

（1）可調(diào)用 添加書架"用戶-內(nèi)容"關(guān)系實現(xiàn)"加入書架"，詳見swan.insertBookshelf。

（2）可調(diào)用 查詢書架"用戶-內(nèi)容"關(guān)系實現(xiàn)狀態(tài)判斷，詳見swan.queryBookshelf。

（3）可調(diào)用 從小程序內(nèi)跳轉(zhuǎn)到書架實現(xiàn)"去書架"，詳見swan.navigateToBookshelf。

（4）可調(diào)用 更新用戶-內(nèi)容的最近閱讀時間實現(xiàn)當(dāng)用戶瀏覽某條內(nèi)容時，更新書架記錄的當(dāng)前‘用戶-內(nèi)容’的最近閱讀時間，詳見swan.updateBookshelfReadtime。

添加書架‘用戶-內(nèi)容’關(guān)系（swan.insertBookshelf）API 需要開發(fā)者提前申請，開通對應(yīng)的鑒權(quán)能力后才可使用。

示例流程（開發(fā)者可結(jié)合業(yè)務(wù)自身需要自行設(shè)計交互邏輯）：

• 用戶首次在小程序內(nèi)觸發(fā) swan.insertBookshelf 時，需要先授權(quán)小程序?qū)?nèi)容同步到書架。此授權(quán)為永久授權(quán)，用戶允許后下次觸發(fā)不再彈出。

2. 開發(fā)并填寫書架內(nèi)容查詢接口

（1）參照書架內(nèi)容查詢接口文檔開發(fā)書架內(nèi)容查詢接口。

（2）在「開發(fā)者平臺-產(chǎn)品試驗室-百度 APP 書架同步」頁面填寫提交接口路徑，以供百度 APP-書架服務(wù)查詢并展示對應(yīng)內(nèi)容詳情。

百度 APP-書架同步頁面入口：

百度 APP-書架同步頁面：

3. 調(diào)試功能，小程序提包上線

功能調(diào)試無誤后即可提交小程序包，通過包體審核后書架同步功能上線。