移动sdk:将Bazaarvoice集成到您的原生Android和iOS应用程序中。
鼓励评论
内容
本教程将向开发者介绍Android SDK中的奖励性徽章和奖励性评论计数。
简介
真实是Bazaarvoice的核心价值观。这意味着在用户生成内容(UGC)上注明或标记作者获得了奖励。联邦贸易委员会关于消费者生成内容的法规，以及Bazaarvoice真实性政策在美国，每当消费者因为写评论而收到或得到实质性补偿时，评论就会显示一个通知(以图形徽章或纯文本的形式)。这包括但不限于，提供给消费者的任何以下内容，以换取撰写评论:
- 进入抽奖
- 优惠券或折扣
- 忠诚奖励点数
- 免费产品，必威手机版本无论是在抽样计划之前或之后，作为感谢礼物
除了标记奖励性评论外，您还可以显示每个产品或作者的奖励性评论计数，这可能需要根据当地法规。这个计数被称为奖励性评论计数．
先决条件
在提交和呈现奖励徽章之前，你的实现必须配置为支持这些选项。请联络支持查询是否启用此选项。
展示奖励性评论徽章
如何为Android SDK客户端显示奖励性评论徽章则取决于创造性的解释。Bazaarvoice在显示徽章信息时有几个建议。
- 奖励性评论必须始终被识别出来。
- 可以使用图标或文本。在使用图标的情况下，其含义或定义应该很容易获得。这可能意味着包含alt文本、实现工具提示或将在鼠标悬停事件上显示的弹出窗口。
内容的标记不需要在联合站点中显示相同，但必须存在。例如，源站点上的图形图标和目标站点上的文本标签是可以接受的。
下面的例子演示了几种显示徽章的方法:
图标只
文本只
图标和文本
图标和工具提示
显示激励评审计数
Android SDK返回每个产品或作者的奖励性评论计数。使用这一计数向消费者展示，有多少对产品或作者所写的评论是通过抽奖、优惠券、抽样计划等来激励的。Bazaarvoice认为，如果一篇评审在提交过程中被标记为激励性评审(如本主题前面部分所述)，或者评审内容表明存在激励性评审，那么该评审就是激励性评审。
使用激励性评审计数:
- 向消费者展示一个徽章或信息信息，突出显示对产品的奖励性评论的数量。
- 增加消费者对你的业务的信任。
- 遵守全球消费者法律法规。
下图演示了如何在评分显示下面显示奖励评论计数。
根据我们的用户体验研究和真实性合规指南，Bazaarvoice建议使用以下文本来描述激励评论数:
奖励性评论计数的评审总数评论者收到样品产品或参加促销活动
使用细节
要检索激励评审数据，请调用addIncentivizedStats(真正的)在Android SDK中。将此方法与下面描述的其他参数一起使用，以返回所需的数据。
必威手机版本
申请批量产品的激励统计数据必威手机版本
BulkProductRequest request = new BulkProductRequest. builder (productId) .addIncludeStatistics(PDPContentType.Reviews)// . addincentive vizedstats (true)// .build();final BVConversationsClient客户端= new BVConversationsClient. builder (BVSDK.getInstance()).build();client.prepareCall(请求)。loadAsync(new ConversationsDisplayCallback() {@Override public void onSuccess(BulkProductResponse response) {for(Product Product: response. getresults ()) {int incentive vizedcount = Product . getreviewstatistics (). getincentive vizedreviewcount ();//检查reviewStatistics的激励计数if (incentive vizedcount > 0) {List DistributionValue = product.getReviewStatistics().getContextDataDistribution().get(" incentive vizedreview ").getValues();//使用distributionValue对象检查激励评审的上下文数据值属性}}}@Override public void onFailure(ConversationsException异常){// HANDLE ERROR}});
请求产品详细信息页的激励统计信息
ProductDisplayPageRequest request = new ProductDisplayPageRequest. builder (productId) .addIncludeStatistics(PDPContentType.Reviews)// . addincentive vizedstats (true)// .build();final BVConversationsClient客户端= new BVConversationsClient. builder (BVSDK.getInstance()).build();client.prepareCall(请求)。loadAsync(new ConversationsDisplayCallback() {@Override public void onSuccess(ProductDisplayPageResponse response) {for(Product Product: response. getresults ()) {int incentive vizedcount = Product . getreviewstatistics (). getincentive vizedreviewcount ();//检查reviewStatistics的激励计数if (incentive vizedcount > 0) {List DistributionValue = product.getReviewStatistics().getContextDataDistribution().get(" incentive vizedreview ").getValues();//使用distributionValue对象检查激励评审的上下文数据值属性}}}@Override public void onFailure(ConversationsException异常){// HANDLE ERROR}});
评论
为评审申请激励统计数据
ReviewsRequest request = new ReviewsRequest。Builder("ProductId"， limit, offset) . addinclecontent (reviewincludettype必威手机版本 . products)//响应中包含产品的附加参数。addincludettype . authors)//响应中包含作者的附加参数。addcustomdisplayparameter ("FilteredStats"，"Reviews")//添加到请求过滤统计。addincentive vizedstats (true) //请求奖励评论数据。build();final BVConversationsClient客户端= new BVConversationsClient. builder (BVSDK.getInstance()).build();client.prepareCall(请求)。loadAsync(new ConversationsDisplayCallback() {@ Override public void onSuccess(ReviewResponse response) {for(Review Review: response. getresults ()) {Map reviewBadges = Review . getbadges ();if(reviewbadge .get("incentivizedReview") != null){//评审包含" incentive vizedreview "徽章，检查属性badge badge = reviewbadge .get(" incentive vizedreview ");//检查徽章属性' for(Product Product: review.getIncludedIn().getProducts()){//检查review必威手机版本Statistics int incentive vizedcount = Product . getreviewstatistics (). getincentive vizedreviewcount ();if(incentivizedCount > 0) {List DistributionValue = product.getReviewStatistics().getContextDataDistribution().get(" incentive vizedreview ").getValues();//使用distributionValue对象检查激励评审的上下文数据值属性}}}}}@Override public void onFailure(ConversationsException异常){// HANDLE ERROR}});
大部分评级
请求批量评级的激励统计数据
BulkRatingsRequest请求=新的BulkRatingsRequest。Builder(productIds, bulkratingoptions . statstye . all) . addincentive vizedstats (true) //请求激励评论数据.build();final BVConversationsClient客户端= new BVConversationsClient. builder (BVSDK.getInstance()).build();client.prepareCall(请求)。loadAsync(new ConversationsDisplayCallback() {@Override public void onSuccess(BulkRatingsResponse response) {for (Statistics stats: response. getresults ()) {Pr必威手机版本oductStatistics productStats = stats. getproductstatistics ();//Review Statistics reviewStats必威手机版本 = productStats.getReviewStatistics();//Review Statistics reviewStats nativeStats = productStats.getNativeReviewStatistics();//获取激励计数nativestats . getincentive vizedreviewcount ();//获取激励计数}}@覆盖公共无效onFailure(ConversationsException异常){//处理错误}});
上下文数据值
的ContextDataValues对象和随后的键/值对可以为开发人员提供关于激励评审的附加信息。与激励评审相关联的额外元数据可以帮助对评审类型进行分类。例如，DimensionLabel键/值可以用来区分其他类型的激励，也可以显示为标签。为了使用ContextDataValues，请联系技术支持。
徽章
的review.badges对象包含徽章名称(‘incentive vizedreview’)、id、徽章类型(“Custom”)以及与徽章相关的内容类型(评论、问题、答案)。