API的对话:检索并提交消费者生成的内容(CGC),检索您的产品目录和关于CGC的统计信息。
R&R PDP组件
对话API允许您以编程方式检索和提交Bazaarvoice对话数据以在应用程序中使用。要了解更多信息,请参阅对话API文档主页.
内容
本教程描述了组成Bazaarvoice对话评分和评论(R&R)的标准产品显示页面(PDP)组件。
简介
R&R由三个PDP组件组成:
- 评价总结
- 内容摘要
- 内容区域
下面将对每个组件进行更详细的描述,并提供了一个线框,用于标识在典型PDP上应该放置组件的位置、推荐元素列表以及一个默认Bazaarvoice实现的屏幕截图作为示例。尽管不是必需的,但我们强烈建议在Conversations应用程序中包含这些组件。
评价总结
描述
评级摘要提醒消费者评论的存在,并提供阅读评论和撰写评论的链接。评级摘要应该显示在产品页面的顶部,在折叠的上方。它会显示产品的整体评级,以及会向朋友推荐该产品的客户数量等信息。
这个组件应该包含以下元素:
- 综合评分星级
- 总评论数
- 推荐的百分比
- 链接到阅读评论
- 链接来写一篇评论
用户界面
下面的图片显示了这个组件在审查被批准显示之前和之后的样子:
评级汇总数据
用于创建评级摘要的数据可以在ReviewStatistics
部分的API响应
{"HasErrors": false, "Includes": {"Pr必威手机版本oducts":{"1000001":{…“ReviewStatistics”:{…},……}}, "Comments":[…]),…},“抵消”:0,“TotalResults”:151年,“语言环境”:“en_US”、“错误”:[],“结果”:[…, "Limit": 1}
默认情况下,API响应中不包括评审统计信息。添加包括=产品必威手机版本
而且统计=评论
评论。Json请求ReviewStatistics
.
https:// (stg) api.bazaarvoice.com/data/reviews.json ? apiversion = 5.4万能钥匙= {API_KEY}过滤器= ProductId: 1000001包括=必威手机版本,评论统计=评论
内容摘要
描述
内容摘要为用户提供关于内容以及过滤和排序控件的摘要信息。内容摘要应该显示在内容区域的上方。它还可以显示在评分摘要中找到的任何元素。
该组件可能包含以下元素:
- 排序和筛选控件
- 标签云,评级维度,滑块
- 来自评分摘要的任何元素
用户界面
下图显示了这个组件的外观:
评论
如果没有审核被批准显示,则不需要显示该组件。
内容汇总数据
用于创建内容摘要的数据可以在ReviewStatistics
API响应的部分:
{"HasErrors": false, "Includes": {"Pr必威手机版本oducts":{"1000001":{…“ReviewStatistics”:{…},……}}, "Comments":[…]),…},“抵消”:0,“TotalResults”:151年,“语言环境”:“en_US”、“错误”:[],“结果”:[…, "Limit": 1}
默认情况下,API响应中不包括评审统计信息。在下面的请求中,包括=产品必威手机版本
而且统计=评论
指令API返回ReviewStatistics
对象。
https:// (stg) api.bazaarvoice.com/data/reviews.json ? apiversion = 5.4万能钥匙= {API_KEY}过滤器= ProductId: 1000001包括=必威手机版本,评论统计=评论
内容区域
描述
内容区域是显示使用者生成的内容的地方。内容区通常显示在产品信息下方,也可能位于标签后面。
- 评论
- 评论
- 排序和筛选控件
- 分页控件
用户界面
下面的图片显示了这个组件在几种情况下的样子:
内容区数据
用于创建内容区域的数据可以在结果
而且评论
API响应的部分:
{“HasErrors”:假的,“包括”:{"产品":{…必威手机版本},“评论”:[…]),…},“抵消”:0,“TotalResults”:151年,“语言环境”:“en_US”、“错误”:[],“结果”:[…, "Limit": 1}
默认情况下,API响应中不包括注释。在下面的请求中,评论
当添加到包括
指示API返回评论
数组中。
https:// (stg) api.bazaarvoice.com/data/reviews.json ? apiversion = 5.4万能钥匙= {API_KEY}过滤器= ProductId: 1000001包括=产品,必威手机版本评论统计=评论