Google Play 应用内评价 API

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

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

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

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

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

设备要求

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

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

Play Core 库要求

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

何时请求应用内评价

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

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

设计准则

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

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

配额

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

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

在应用中集成应用内评价

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

服务条款和数据安全

访问或使用 Play In-App Reviews Library 即表示您同意 Play Core 软件开发套件服务条款。请先阅读并了解所有适用的条款及政策,然后再访问该库。

数据安全

Play Core 库是您的应用与 Google Play 商店的运行时接口。 因此,当您在应用中使用 Play Core 时,Play 商店会运行自己的进程,其中包括根据 Google Play 服务条款处理数据。以下信息说明了 Play Core 库如何通过处理数据来处理从您的应用发来的特定请求。

应用内评价

收集的使用情况数据 用户输入的数据(评分和自由文本评价)
数据收集目的 我们会利用收集的数据在 Play 商店中发表评价。
数据加密 数据会加密。
数据分享 我们会利用收集的数据在 Play 商店中发表公开评价;或者,如果应用位于封闭式测试轨道中,我们会与应用开发者私下分享所收集的数据。
数据删除 用户可以在 Google Play 商店账号或 Google 账号中删除自己的评价。

虽然我们力求做到尽可能公开透明,但对于 Google Play 的“数据安全”部分针对您的应用的用户数据收集、分享和安全做法提供的表单,您需自行负责决定如何回应。