揭開全新 Play 應用內(nèi)評價 API 的神秘面紗

#11WeeksOfAndroid期間，全新的Play應用內(nèi)評價API正式登場。通過Play Core開發(fā)庫，Play團隊推出了這項眾人期盼已久的功能。

#11WeeksOfAndroid

https://developer.android.google.cn/11weeksofandroid

Play應用內(nèi)評價API正式登場

https://developer.android.google.cn/guide/playcore/in-app-review

盡管我們收到的大多為正面反饋，但一些開發(fā)者也表達了他們的擔憂，稱需要調(diào)整自己的UI流程適應新API的要求。為打消這些疑慮，我們將向各位解釋說明團隊做出的一些決策，并提供進一步指導，幫助大家充分利用該API。

"為什么該API不提供任何信息？"

鑒于API的重要性與潛在濫用風險，或會暴露用戶的評論，甚至獲悉評分面板是否顯示，團隊設計了這款API將用戶隱私和體驗放在首位。

雖然看上去這增加了開發(fā)者的工作難度，但我認為實際情況并非如此。該API操作簡單(只需調(diào)用兩個方法！)，在設計上符合開發(fā)者的利益，同時平衡了用戶隱私問題，并避免誘發(fā)不必要行為。要點在于明確"何時使用該API"。

"突然顯示的評分面板"

該API并非"隨機"顯示評分面板，而是由開發(fā)者確定啟動評分流程的最佳位置和時機。

誠然，該API的設計(如上所述)目的在于保護用戶。為此，該API不會提供有關(guān)評論顯示與否的信息，并且不會頻繁啟動/彈出評分流程(詳情請參閱"配額")。

配額

https://developer.android.google.cn/guide/playcore/in-app-review#quotas

這樣能夠有效避免可能出現(xiàn)的濫用問題，例如，應用強迫用戶對其打分，或者誤導用戶，僅在界面中顯示"5星"評論(詳情請參閱"何時請求應用內(nèi)評論")。

何時請求應用內(nèi)評論

https://developer.android.google.cn/guide/playcore/in-app-review#when-to-request

"能否將該API用于'打分'按鈕"

如上所述，該API不應由call-to-action(即"打分"按鈕)觸發(fā)，而應作為用戶流程的一部分觸發(fā)。

若不滿足顯示評分對話框的條件(如下面鏈接中列舉的狀況)，用戶在點擊按鈕后可能不會觸發(fā)任何操作。

無法顯示出評分對話框的常見情況

https://developer.android.google.cn/guide/playcore/in-app-review/test#troubleshooting

"我的應用沒有任何'成功'頁面，因此我沒有觸發(fā)評分的時機"

實際上還有其他很多適合啟動評分流程的情景。例如，如果用戶已經(jīng)使用應用一定次數(shù)或時間，您可以在他下一次打開應用時啟動評分流程，只要確保不過度觸發(fā)用戶評價，且在用戶評價完成后繼續(xù)執(zhí)行原有流程即可。

"此行為將導致用戶給我的應用打差評"

一些早期使用者表示，有些用戶可能永遠不會給應用評分，而如果將該API放置在正確的位置，就能夠幫助他們，使其在收到請求時愿意撰寫評論。

當然，如果濫用該API，那效果必然適得其反。

"我可以使用一些變通的方法來確定評分面板顯示與否"

恭喜！盡管一些變通的方法看似可行，但我們并不推薦大家去做這樣的嘗試，如果一款正式發(fā)布的應用是基于系統(tǒng)內(nèi)部實現(xiàn)細節(jié)而實現(xiàn)的，那它本身也存在一定風險。此外，這種做法也違反了設計初衷，反而可能產(chǎn)生負面影響。

"該API不可靠且無法正常工作"

如"測試應用內(nèi)評價"部分所述，該API有嚴苛的使用要求。最常見的錯誤包括:

未使用已發(fā)布到Google Play的應用；

使用從未通過Google Play安裝這款應用的帳號或已評價過應用的帳號；

當設備中有多個賬戶時，未選擇主賬戶(以及安裝了應用的賬戶)。

測試應用內(nèi)評價

https://developer.android.google.cn/guide/playcore/in-app-review/test

如需獲取詳情，請參閱問題排查部分。

問題排查

https://developer.android.google.cn/guide/playcore/in-app-review/test#troubleshooting

"我需要了解具體的配額！我該怎樣知道多久請求一次用戶評價？"

根據(jù)我們的設計，該API并不會提供完成度/結(jié)果反饋，因此配額機制旨在幫助開發(fā)者避免濫用API和過度觸發(fā)評論請求。確切的配額屬于實現(xiàn)細節(jié)問題，并且未來可能會發(fā)生變化。

應用不應試圖確定配額的具體情況，而應嘗試添加自己的邏輯(何時/何處是請求評論的最佳時間)，并在合適的條件通過該API啟動評論。

所以，該API的最佳使用方式是什么？

沒有唯一或"最佳"的使用方式，而且每款應用的用例和用戶群也各不相同。不過，以下建議可能會對您有所幫助:

確保用戶在啟動評分流程之前已經(jīng)體驗過該應用。

在界面過渡后啟動評分流程。例如，執(zhí)行完某些操作并引導用戶返回"主"界面后。

避免在用戶點擊任何功能運行(call-to-action)按鈕之后調(diào)用該API，防止此處顯示用戶不希望看到的對話框/面板。

啟動評論時，請通過提前預加載評分流程(requestReviewFlow)來防止阻塞用戶，如果請求未按時加載，則跳過啟動流程(參閱ReviewViewModel示例)。

不要過度觸發(fā)評價(避免每次啟動應用都觸發(fā))。即使已預先加載，啟動用戶評價也可能導致UI輕微延遲。

requestReviewFlow

https://developer.android.google.cn/reference/com/google/android/play/core/review

/ReviewManager.html#requestReviewFlow()

ReviewViewModel

https://github.com/android/app-bundle-samples/blob/master/PlayCoreKtx/app/src/main/java/com/google/android

/samples/dynamicfeatures/state/ReviewViewModel.kt

PlayCoreKtx示例應用為一個手電筒應用，您可選擇其背景顏色。該應用以簡化方式說明了上文給出的一些建議。

ReviewViewModel負責"預熱"評分流程，確保ReviewInfo對象準備就緒，并在滿足評論條件的情況下提供。

PaletteFragment請求ReviewViewModel在評分流程啟動后立即對其進行"預熱"。

當用戶從PaletteFragment中選擇背景、返回主界面并關(guān)閉手電筒后，MainFragment會請求ReviewViewModel獲取ReviewInfo。

PlayCoreKtx

https://github.com/android/app-bundle-samples/tree/master/PlayCoreKtx

ReviewViewModel

https://github.com/android/app-bundle-samples/blob/master/PlayCoreKtx/app/src/main/java/com

/google/android/samples/dynamicfeatures/state/ReviewViewModel.kt

PaletteFragment

https://github.com/android/app-bundle-samples/blob/c32d75fc267440b8da8387429c6315528254c379

/PlayCoreKtx/features/picture/src/main/java/com/google/android/samples/dynamicfeatures

/ondemand/PaletteFragment.kt#L114

獲取ReviewInfo

https://github.com/android/app-bundle-samples/blob/c32d75fc267440b8da8387429c6315528254c379/PlayCoreKtx

/app/src/main/java/com/google/android/samples/dynamicfeatures/ui/MainFragment.kt#L126

注:為了簡化示例，應用沒有保存最近一次觸發(fā)評分流程的時間，并且使用了簡單邏輯而可能多次觸發(fā)評分邏輯。正式的應用應使用更為復雜的邏輯。

希望這篇文章能幫助您理清一些概念，并讓您順利實現(xiàn)新的應用內(nèi)評價API。如有任何疑問，歡迎您在留言區(qū)提問交流。