Google Play 應用程式內評論 API

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

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

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

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

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

裝置需求

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

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

Play Core 程式庫要求

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

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

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

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

設計準則

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

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

配額

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

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

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

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

服務條款與資料安全性

存取或使用 Play 應用程式內評論資料庫,即表示您同意《Play Core 軟體開發套件服務條款》。存取程式庫前,請先詳閱並瞭解所有適用的條款和政策。

資料安全性

Play Core Library 是您應用程式與 Google Play 商店之間的執行階段介面。因此,在應用程式中使用 Play Core 時,Play 商店會執行自己的程序,包括依據《Google Play 服務條款》處理資料。以下資訊說明 Play Core 程式庫如何處理資料,以處理來自應用程式的特定要求。

應用程式內評論

收集到資料的使用情況 使用者輸入的資料 (評分和任意文字評論)
資料收集目的 收集到的資料會在 Play 商店留下評論。
資料加密 資料已加密。
資料分享 收集到的資料會用於 Play 商店的公開評論中;假如應用程式位於封閉式測試群組中,我們會與應用程式開發人員私下分享收集到的資料。
資料刪除 使用者可以在 Google Play 商店帳戶或 Google 帳戶中刪除自己的評論。

雖然我們力求盡可能維持公開透明,但您必須全權負責決定如何回應 Google Play 的「資料安全性」專區中針對應用程式的使用者資料收集、分享和安全性做法。