Google Play 應用程式內評論 API

您可以透過 Google Play 應用程式內評論 API 提示使用者提交 Play 商店的評分和評論,無需退出應用程式或遊戲。

一般來說,在應用程式的整個使用者歷程中,隨時都可以觸發應用程式內評論流程 (見圖 1)。在流程中,使用者可透過 1 至 5 顆星系統為您的應用程式評分,還可以選擇新增評論。評論提交後就會傳送至 Play 商店最後顯示出來。

為保護使用者隱私並避免 API 濫用,您的應用程式必須遵守 要求應用程式內評論的時機 以及評論提示設計 的相關嚴格準則。

使用者的應用程式內評論作業流程

圖 1. 使用者的應用程式內評論流程

裝置需求

應用程式內評論僅適用於下列裝置上:

  • 搭載 Android 5.0 (API 級別 21) 以上版本的 Android 裝置 (手機和平板電腦)。
  • 已安裝 Google Play 商店的 Chrome OS 裝置。

Play Core 程式庫要求

如要將應用程式內評論整合至應用程式中,請務必使用 1.8.0 以上版本的 Play Core 程式庫

要求應用程式內評論的時機

遵守以下準則,有助於判斷何時向使用者要求應用程式內評論:

  • 在使用者已充分體驗您的應用程式或遊戲後,觸發應用程式內評論流程,即可獲得實用的意見回饋。
  • 請勿過度提示使用者進行評論。這個做法有助於盡量減少使用者不滿並限制 API 使用量 (請參閱 配額章節)。
  • 在系統顯示評分按鈕或資訊卡之前或之後,您的應用程式不應詢問使用者任何問題,包括有關使用者意見的問題 (例如,「您是否喜歡這個應用程式?」) 或預測性問題 (例如,「您是否會給這個應用程式 5 顆星評分」)。

設計準則

如要判斷如何將應用程式內評論整合至應用程式中,請遵循下列準則:

  • 資訊卡依原樣顯示,不得以任何方式篡改或修改現有設計,包括大小、不透明度、形狀或其他屬性。
  • 請勿在資訊卡上方或資訊卡周圍新增任何重疊元素。
  • 資訊卡和資訊卡背景應該位於最頂層。資訊卡顯示後,請勿以程式輔助方式移除資訊卡。系統會根據使用者的明確動作或 Play 商店內部機制自動移除資訊卡。

配額

為了提供絕佳的使用者體驗,Google Play 會強制執行時限配額,限制使用者可以看見評論對話方塊的頻率。由於這個配額,如果在短時間內多次呼叫 launchReviewFlow 方法 (例如,不到一個月),系統可能不一定顯示對話方塊。

由於配額隨時可能變動,因此請務必套用自己的邏輯,並盡鎖定要求評論的可能最佳時機。舉例來說,「不應該有觸發 API 的行動號召選項」 (例如按鈕),因為使用者可能已達到其配額,系統也不會顯示該流程,因此導致中斷使用者體驗。以這個用途來說,請改為將使用者重新導向至 Play 商店。

將應用程式內評論整合至應用程式中

瞭解如何依據您的開發環境,將應用程式內評論整合至應用程式中: