# 小程序隱私協(xié)議開(kāi)發(fā)指南

# 一、功能介紹

涉及處理用戶(hù)個(gè)人信息的小程序開(kāi)發(fā)者，需通過(guò)彈窗等明顯方式提示用戶(hù)閱讀隱私政策等收集使用規(guī)則。

為規(guī)范開(kāi)發(fā)者的用戶(hù)個(gè)人信息處理行為，保障用戶(hù)合法權(quán)益，微信要求開(kāi)發(fā)者主動(dòng)同步微信當(dāng)前用戶(hù)已閱讀并同意小程序的隱私政策等收集使用規(guī)則，方可調(diào)用微信提供的隱私接口。

特別注意：

2023.08.22更新：

以下指南中涉及的 getPrivacySetting、onNeedPrivacyAuthorization、requirePrivacyAuthorize 等接口目前可以正常接入調(diào)試。調(diào)試說(shuō)明：

在 2023年9月15日之前，在 app.json 中配置 __usePrivacyCheck__: true 后，會(huì)啟用隱私相關(guān)功能，如果不配置或者配置為 false 則不會(huì)啟用。

在 2023年9月15日之后，不論 app.json 中是否有配置 __usePrivacyCheck__，隱私相關(guān)功能都會(huì)啟用。

接口用法可參考下方完整示例demo

2023.09.14更新：

隱私相關(guān)功能啟用時(shí)間延期至 2023年10月17日。在 2023年10月17日之前，在 app.json 中配置 __usePrivacyCheck__: true 后，會(huì)啟用隱私相關(guān)功能，如果不配置或者配置為 false 則不會(huì)啟用。在 2023年10月17日之后，不論 app.json 中是否有配置 __usePrivacyCheck__，隱私相關(guān)功能都會(huì)啟用。

新增官方隱私授權(quán)彈窗功能，相關(guān)功能參考下方官方隱私彈窗功能說(shuō)明。

# 二、接入流程

# 1. 配置《小程序用戶(hù)隱私保護(hù)指引》

開(kāi)發(fā)者需在「小程序管理后臺(tái)」配置《小程序用戶(hù)隱私保護(hù)指引》，詳細(xì)指引可見(jiàn)：用戶(hù)隱私保護(hù)指引填寫(xiě)說(shuō)明。

需要注意的是，僅有在指引中聲明所處理的用戶(hù)信息，才可以調(diào)用平臺(tái)提供的對(duì)應(yīng)接口或組件。若未聲明，對(duì)應(yīng)接口或組件將直接禁用。隱私接口與對(duì)應(yīng)的處理的信息關(guān)系可見(jiàn)：小程序用戶(hù)隱私保護(hù)指引內(nèi)容介紹。

配置完成后，對(duì)于每個(gè)使用小程序的用戶(hù)，開(kāi)發(fā)者均需要同步微信當(dāng)前用戶(hù)已閱讀并同意小程序的隱私政策等收集使用規(guī)則后，才可以調(diào)用已聲明的接口或組件。同步的開(kāi)發(fā)方式見(jiàn)下文。

對(duì)于已經(jīng)同步過(guò)的用戶(hù)，后續(xù)若開(kāi)發(fā)者更新了配置，對(duì)于舊版本已經(jīng)有接口或組件，不需要重新同步；對(duì)于更新后產(chǎn)生的新的接口或組件，需要重新同步。例如，7月11日更新的版本中包含「收集你選擇的位置信息」，7月12日同步用戶(hù)同意狀態(tài)，7月13日更新后新增了「收集你的微信運(yùn)動(dòng)步數(shù)」，則在未再次同步的情況下，可以調(diào)用 wx.chooseLocation 接口，無(wú)法調(diào)用 wx.getWeRunData 接口。

# 2. 主動(dòng)查詢(xún)隱私授權(quán)同步狀態(tài)以及展示隱私協(xié)議

從基礎(chǔ)庫(kù) 2.32.3 開(kāi)始支持

開(kāi)發(fā)者可通過(guò) wx.getPrivacySetting 接口，查詢(xún)微信側(cè)記錄的用戶(hù)是否有待同意的隱私政策信息。該信息可通過(guò)返回結(jié)果 res 中的 needAuthorization 字段獲取。

同時(shí)，wx.getPrivacySetting 接口會(huì)返回開(kāi)發(fā)者在小程序管理后臺(tái)配置的《小程序用戶(hù)隱私保護(hù)指引》名稱(chēng)信息，開(kāi)發(fā)者可以調(diào)用 wx.openPrivacyContract 接口打開(kāi)該頁(yè)面。

如果存在有待用戶(hù)同意的隱私政策信息，開(kāi)發(fā)者需要主動(dòng)提示用戶(hù)閱讀隱私政策等收集使用規(guī)則，對(duì)于提示方式，小程序開(kāi)發(fā)者可自行設(shè)計(jì)，同時(shí)需要在相關(guān)界面中使用 <button open-type="agreePrivacyAuthorization"> 組件，當(dāng)用戶(hù)輕觸該 <button> 組件后，表示用戶(hù)已閱讀并同意小程序的隱私政策等收集使用規(guī)則，微信會(huì)收到該同步信息，此時(shí)開(kāi)發(fā)者可以在該組件的 bindagreeprivacyauthorization 事件回調(diào)后調(diào)用已聲明的隱私接口。

代碼示例

從基礎(chǔ)庫(kù) 2.32.3 版本起，隱私同意按鈕支持與手機(jī)號(hào)快速驗(yàn)證組件、手機(jī)號(hào)實(shí)時(shí)驗(yàn)證組件耦合使用，調(diào)用方式為 <button open-type="getPhoneNumber|agreePrivacyAuthorization"> 或 <button open-type="getRealtimePhoneNumber|agreePrivacyAuthorization">。

也支持隱私同意按鈕與獲取用戶(hù)信息組件耦合使用，調(diào)用方式為<button open-type="getUserInfo|agreePrivacyAuthorization">

示例代碼

# 3. 被動(dòng)監(jiān)聽(tīng)隱私接口需要用戶(hù)授權(quán)事件

從基礎(chǔ)庫(kù) 2.32.3 開(kāi)始支持

小程序開(kāi)發(fā)者除了可以自行判斷時(shí)機(jī)，提示用戶(hù)閱讀隱私政策等收集使用規(guī)則外，也可以通過(guò) wx.onNeedPrivacyAuthorization 接口來(lái)監(jiān)聽(tīng)何時(shí)需要提示用戶(hù)閱讀隱私政策。當(dāng)用戶(hù)觸發(fā)了一個(gè)微信側(cè)未記錄過(guò)同意的隱私接口調(diào)用，則會(huì)觸發(fā)該事件。開(kāi)發(fā)者可在該事件觸發(fā)時(shí)提示用戶(hù)閱讀隱私政策。

需要注意的是，對(duì)于 <input type="nickname"> 組件，由于 <input> 的特殊性，如果用戶(hù)未同意隱私協(xié)議，則<input type="nickname"> 聚焦時(shí)不會(huì)觸發(fā) onNeedPrivacyAuthorization 事件，而是降級(jí)為 <input type="text"> 。

此外，微信還提供了 wx.requirePrivacyAuthorize 接口，可用于模擬隱私接口調(diào)用。

代碼示例

# 4. 清空歷史同步狀態(tài)

當(dāng)用戶(hù)從「微信下拉-最近-最近使用的小程序」中刪除小程序，將清空歷史同步狀態(tài)。下次訪(fǎng)問(wèn)小程序后，需要重新同步微信當(dāng)前用戶(hù)已閱讀并同意小程序的隱私政策等收集使用規(guī)則。

開(kāi)發(fā)者可通過(guò)此方式進(jìn)行調(diào)試，也可以在開(kāi)發(fā)者工具中「清除模擬器緩存-清除授權(quán)數(shù)據(jù)」清空歷史同步狀態(tài)。

# 三、其他說(shuō)明

低于 2.32.3 版本的基礎(chǔ)庫(kù)未集成隱私相關(guān)功能，也不會(huì)攔截隱私接口調(diào)用。

# 四、完整示例demo

demo1: 演示使用 wx.getPrivacySetting 和 <button open-type="agreePrivacyAuthorization"> 在首頁(yè)處理隱私彈窗邏輯 https://developers.weixin.qq.com/s/gi71sGm67hK0

demo2: 演示使用 wx.onNeedPrivacyAuthorization 和 <button open-type="agreePrivacyAuthorization"> 在多個(gè)頁(yè)面處理隱私彈窗邏輯，同時(shí)演示了如何處理多個(gè)隱私接口同時(shí)調(diào)用。 https://developers.weixin.qq.com/s/hndZUOmA7gKn

demo3: 演示 wx.onNeedPrivacyAuthorization、wx.requirePrivacyAuthorize、<button open-type="agreePrivacyAuthorization"> 和 <input type="nickname"> 組件如何結(jié)合使用 https://developers.weixin.qq.com/s/jX7xWGmA7UKa

demo4: 演示使用 wx.onNeedPrivacyAuthorization 和 <button open-type="agreePrivacyAuthorization"> 在多個(gè) tabBar 頁(yè)面處理隱私彈窗邏輯 https://developers.weixin.qq.com/s/g6BWZGmt7XK9

# 五、常見(jiàn)錯(cuò)誤說(shuō)明

{ "errMsg": "A:fail api scope is not declared in the privacy agreement", "errno": 112 } 使用到了 A 隱私接口，但是開(kāi)發(fā)者未在「MP后臺(tái)-設(shè)置-服務(wù)內(nèi)容聲明-用戶(hù)隱私保護(hù)指引」中聲明收集 A 接口對(duì)應(yīng)的隱私類(lèi)型。補(bǔ)充的隱私類(lèi)型聲明, 將在5分鐘后生效。

{ "errMsg": "A:fail appid privacy api banned" } 使用到了 A 隱私接口，但是開(kāi)發(fā)者在 mp 提審時(shí)勾選了“未采集隱私”，或者未聲明隱私協(xié)議，被平臺(tái)回收了接口調(diào)用權(quán)限。

# 六、官方隱私彈窗功能說(shuō)明

為了讓開(kāi)發(fā)者能更便利地完成小程序隱私合規(guī)要求，除了通過(guò)以上指引進(jìn)行隱私協(xié)議開(kāi)發(fā)外，平臺(tái)還提供了官方隱私授權(quán)彈窗。此彈窗在隱私相關(guān)功能啟用后（2023年10月17日后或開(kāi)發(fā)者在 app.json 中配置 __usePrivacyCheck__: true 后），無(wú)需開(kāi)發(fā)者適配開(kāi)發(fā)，自動(dòng)向 C 端用戶(hù)展示。具體邏輯為：

當(dāng)開(kāi)發(fā)者調(diào)用隱私相關(guān)接口時(shí)，微信會(huì)判斷此次調(diào)用是否需要觸發(fā) wx.onNeedPrivacyAuthorization 事件，若觸發(fā)后開(kāi)發(fā)者未進(jìn)行響應(yīng)，微信將主動(dòng)彈出官方彈窗。若用戶(hù)同意，該接口將正常執(zhí)行后續(xù)調(diào)用邏輯；若用戶(hù)拒絕，將進(jìn)行報(bào)錯(cuò)。

需要注意的是，用戶(hù)可能拒絕官方隱私授權(quán)彈窗，為了避免過(guò)度彈窗打擾用戶(hù)，開(kāi)發(fā)者再次調(diào)用隱私相關(guān)接口時(shí)，若距上次用戶(hù)拒絕不足10秒，將不再觸發(fā)彈窗，直接給到開(kāi)發(fā)者用戶(hù)拒絕隱私授權(quán)彈窗的報(bào)錯(cuò)。

官方隱私彈窗將有兩種樣式：

與授權(quán)彈窗耦合樣式：用戶(hù)在此彈窗下需要勾選隱私協(xié)議才可以進(jìn)行允許操作，若用戶(hù)在彈窗中拒絕，報(bào)錯(cuò)信息為用戶(hù)拒絕（錯(cuò)誤碼為 103）。

直接彈窗樣式：用戶(hù)側(cè)直接針對(duì)隱私協(xié)議的授權(quán)，若用戶(hù)在彈窗中拒絕，報(bào)錯(cuò)信息為用戶(hù)未同意隱私協(xié)議（錯(cuò)誤碼為 104）。

與授權(quán)彈窗耦合樣式將會(huì)在后續(xù)版本的基礎(chǔ)庫(kù)中支持（支持版本將在后續(xù)更新），在低版本基礎(chǔ)庫(kù)中所有彈窗均將采用直接彈窗樣式。

相關(guān)知識(shí)

健康碼的隱私政策還有哪些改進(jìn)空間？
美年健康隱私政策
華為運(yùn)動(dòng)健康拒絕數(shù)據(jù)濫用，多方位保障用戶(hù)隱私安全
隱私條款
隱私政策
醫(yī)療健康云平臺(tái)，保障個(gè)人隱私與提供高效服務(wù)的平衡
麥當(dāng)勞中國(guó)隱私政策
衛(wèi)健委印發(fā)電子病歷規(guī)范，明確要求存儲(chǔ)加密，保護(hù)患者隱私
健康醫(yī)療可穿戴設(shè)備數(shù)據(jù)安全與隱私保護(hù)問(wèn)題研究
BMJ：隨著移動(dòng)健康app越來(lái)越普及，健康和隱私關(guān)系值得被關(guān)注！@MedSci

網(wǎng)址: 健康運(yùn)營(yíng)指引 / 用戶(hù)隱私保護(hù) / 小程序隱私協(xié)議開(kāi)發(fā)指南 http://www.u1s5d6.cn/newsview649530.html