跳到主要内容

1.0.0

注意

该门户网站正在开发中。文档的完整版本请看这里.

RuStore In-app Review SDK推出用户在不离开应用程序的情况下,在RuStore中给您的应用程序评分和评论。

用户可以在应用程序的整个使用流程中的任何时候启动评分和评论的用户流程。用户可以按照从 1 到 5 的等级对您的应用进行评分,并留下评论。评论是可选的。

用户流程示例

SDK 正确运作的条件

为了评分和评论应用程序 SDK 的正常运作,需要满足以下条件:

  1. Android操作系统版本7.0或更高。
  2. 用户的设备上安装了RuStore应用程序。
  3. 用户的设备上的 RuStoreApp 版本是最新的。
  4. 用户在RuStore应用程序中已授权。
  5. 应用程序必须在 RuStore 上发布。

何时请求评分和评论

遵循以下建议来决定何时向用户请求应用程序的评分和评论:

  • 在用户充分使用您的应用程序之后启动该流程。
  • 不要过于频繁地启动该流程 - 这会降低用户对您应用程序的体验并限制评分 SDK 的使用。
  • 不要使用行动号召,例如"评价应用程序"的按钮 - 用户可能已经达到了启动流程的限制。
  • 您的应用程序在启动或进行流程期间不应询问用户任何问题,包括关于他们的意见(例如,"您喜欢这个应用程序吗?")或预测性问题(例如,"您会给这个应用程序评5星吗?")。

设计建议

遵循以下建议来决定如何集成流程:

  • 保持流程原样显示,不对当前设计进行任何干预或更改,包括大小、不透明度、形状和其他属性。
  • 不要在流程的顶部或边缘添加任何内容。
  • 流程应在所有层上方打开。启动流程后不要关闭它。流程将在用户明确操作后自行结束。

在项目中集成

为了集成,您需要下载RuStore Review SDK并将其导入到项目中(Assets → Import Package → Custom Package)。依赖项将通过External Dependency Manager(包含在SDK中)自动集成。

Minimum API level应设置不低于24。目前不支持应用程序的缩减(ProGuard/R8),需要在项目设置中关闭它(File → Build Settings → Player Settings → Publishing Settings → Minify)。

创建RuStoreReviewManager

为了处理评分,需要使用RuStoreReviewManagerFactory创建RuStoreReviewManager:

RuStoreReviewManager.Instance.Init();

准备启动应用程序评价

提前调用RequestReviewFlow(),在调用LaunchReviewFlow()之前,以便准备显示屏幕所需的信息。

RuStoreReviewManager.Instance.RequestReviewFlow(    \`\`onFailure: (error) =\> {         \`\`// Handle error     \`\`},    \`\`onSuccess: () =\> {         \`\`// Handle success     \`\`});

果收到onSuccess响应,则可以在大约五分钟内启动请求评价和对应用程序的评论的流程LaunchReviewFlow()。

如果收到 onFailure 响应,建议不要自行向用户显示错误,因为用户没有启动这个流程。

可能的错误

启动应用程序评价

为了启动请求用户评价和评论的流程,请调用LaunchReviewFlow()方法。

RuStoreReviewManager.Instance.LaunchReviewFlow(    \`\`onFailure: (error) =\> {         \`\`// Handle error    \`\`},    \`\`onSuccess: () =\> {         \`\`// Handle success    \`\`});

待用户完成表单的通知,在 onSuccessonFailure 中,以继续应用程序的操作。

评价表单完成后,无论结果是onSuccess还是onFailure,我们都不建议显示任何与评价和评论相关的额外表单。

频繁调用launchReviewFlow不会导致用户看到评价表单,允许的显示由RuStore端调控。

错误处理

出现的错误会传递给SDK方法的onFailure处理程序。

错误结构:

public class RuStoreError {    \`\`public string name;    \`\`public string description;}
  • name - 错误名称;
  • description - 错误描述。
  • onFailure 中您可能接收的可能错误:
  • RuStoreNotInstalledException - 用户设备上未安装RuStore。
  • RuStoreOutdatedException - 用户设备上的RuStore不支持启动评分和评论的流程。
  • RuStoreUserUnauthorizedException - 用户未在RuStore中授权。
  • RuStoreRequestLimitReached - 自上次显示流程以来时间太短。
  • RuStoreReviewExists - 该用户已对您的应用程序进行了评价。
  • RuStoreInvalidReviewInfo - ReviewInfo出现问题。
  • RuStoreException(message: String) - RuStore的基本错误,其他错误均继承自此。