Google Play 应用内评价 API

借助 Google Play 应用内评价 API,您可以提示用户提交 Play 商店的评分和评价,而无需退出您的应用或游戏。

通常,应用内评价流程(参见图 1)可能会在用户使用您应用的整个过程中随时触发。在该流程中,用户可以使用 1 到 5 星系统对您的应用进行评分,还可以选择添加评论。评价提交后将发送到 Play 商店并最终显示。

为了保护用户隐私并避免 API 滥用,您的应用需要遵循有关何时请求应用内评价评价提示设计的严格的准则。

针对用户的应用内评价工作流程

图 1. 针对用户的应用内评价流程

设备要求

应用内评价只适用于以下设备:

  • 搭载 Android 5.0(API 级别 21)或更高版本的 Android 设备(手机和平板电脑),且安装了 Google Play 商店。
  • 安装了 Google Play 商店的 Chrome 操作系统设备。

Play Core 库要求

如需在您的应用中集成应用内评价,应用必须使用 1.8.0 或更高版本的 Play Core 库

何时请求应用内评价

请遵循以下准则,这些准则有助您确定何时向用户请求应用内评价:

  • 在用户已充分您的体验应用或游戏内容并给出实用反馈后,触发应用内评价流程。
  • 请不要过度提示用户进行评价。此方法有助于最大限度地减少用户不满并限制 API 使用情况(请参阅配额)。
  • 在系统显示评分按钮或卡片之前或之后,您的应用不应询问用户任何问题,包括有关用户意见的问题(例如,“您是否喜欢这款应用?”)或预测性问题(例如,“您会给这款应用打 5 星吗”)。

设计准则

确定如何在应用中集成应用内评价时,请遵循以下准则:

  • 按原样显现卡片,且不得以任何方式篡改或修改现有设计,包括尺寸、不透明度、形状或其他属性。
  • 请勿在卡片顶部或片周围添加任何叠加层。
  • 卡片和卡片背景应位于顶层。卡片显现后,请不要以编程方式移除该卡片。系统会根据用户的明确操作或内部 Play 商店机制自动移除该卡片。

配额

为了提供优质用户体验,Google Play 会强制执行一个限时配额,用于规定系统向用户显示评价对话框的频率。由于存在此配额,在短时间内(例如,不到一个月内)多次调用 launchReviewFlow 方法时可能不会始终显示对话框。

由于配额可能会发生变化,因此请务必应用自己的逻辑并瞄准最佳时机申请审核。例如,您不得采用旨在触发 API 的号召性用语选项(例如按钮),因为用户可能已经达到其配额,而该流程无法显示,这会导致无法向用户提供流畅的体验。对于此使用场景,请将用户重定向到 Play 商店。

在应用中集成应用内评价

了解如何根据您的开发环境将应用内评价集成到您的应用中: