API的对话：检索并提交消费者生成的内容(CGC)，检索您的产品目录和关于CGC的统计信息。
自定义问题过滤器
对话API允许您以编程方式检索和提交Bazaarvoice对话数据以在应用程序中使用。要了解更多信息，请参阅对话API文档主页。
内容
（+显示
——隐藏）
简介
自定义问题过滤器是对话API中的一个功能，允许购物者根据过去对评论表单问题的回答找到最相关的评论。对于购物者来说，这是一种很好的方式，可以让他们关注其他购物者写的评论，这些购物者有共同的意图、偏好或特征。
配置自定义问题
在评审提交表单上配置问题是构建自定义问题过滤器的第一步。Bazaarvoice提供了各种类型的问题类型，可以在Configuration Hub中配置-单选、多项选择、自由文本或评分形式。点击添加或自定义提交表单问题想了解更多。
以下三种问题类型属于自定义问题过滤器的范围
- 背景数据值(CDV)或下拉选择是单选问题，以接收问题的单个回答。
- 标签组是多项选择题，以收到多于一个的回答的问题。
- 二次评级/滑块允许您以评分量表的形式收集响应。
创建自定义问题过滤器和过滤评论
评审API的响应模式保持不变。对象中的附加统计信息将返回ReviewStatistics和/或FilteredReviewStatistics部分。详情请参阅检查显示查看关于Reviews.json的更多信息。
对于您配置的问题，您将在API响应中收到以下附加属性
- 统计有多少消费者选择了一个特定的答案选项，即它出现的评论数量
- 本地化标签，以匹配您的本地化需求
背景信息数据值/下拉选择
1.在上下文数据上创建过滤器
数据值统计数字包括在包括= prod必威手机版本ucts&Stats =评论在API请求。如果没有对任何答案选择的评论，它将被跳过。
创建过滤器的API请求示例
https:// (stg) .api.bazaarvoice.com/data/reviews.json ? apiversion = 5.4 &passkey = {万能钥匙} &Filter = productId: {ProductID} &包括= prod必威手机版本ucts&Stats =评论
API响应示例
包括:{"Products"必威手机版本:{…"ReviewStatistics": {"ContextDataDistribution": {SkinType": {"Id": "SkinType"， "Values": [{"Count": 60， "Value": "Normal" "ValueLabel": "Normal"}， {"Count": 267， "Value": "Combination" "ValueLabel": "Combination"}， {"Count": 131， "Value": "DrySkinFace" "ValueLabel": "干皮脸"}，{"Count": 260， "Value": "DrySkinBody" "ValueLabel": "干皮体"}，{"Count": 29， "Value": "油性" "ValueLabel": "油性"}，{"Count": 114， "Value": "Value": "油性"}，{"Count": 114， "Value": "Value": "油性"“敏感”“ValueLabel”:“敏感”}],“标签”:“皮肤类型 " }, ... }, ... } ... } ... } ...
2.过滤内容评论
您可以过滤任何特定的评论“上下文数据值”使用过滤器= ContextDataValue_] [Id:情商:【价值】。
在上面的回答样本中，(Id)=SkinType,(价值)=正常，组合，干皮肤脸，干皮肤身体，油，敏感。
欲知更多过滤选项,点击在这里。
过滤评论的API请求示例:
https:// (stg) .api.bazaarvoice.com/data/reviews.json ? apiversion = 5.4万能钥匙={万能钥匙}过滤器= ProductId: {ProductId}包括= products必威手机版本&Stats =评论过滤器= ContextDataValue_SkinType:情商:油性
评审API的响应模式保持不变。响应现在将返回特定于所选上下文数据值的筛选过的评论。详情请参阅检查显示查看关于Reviews.json的更多信息
API响应模式(JSON格式):
api调用将返回带有以下键值对的Json数据。每个键值的重要性如下所示:
| 关键 | 价值 |
|---|---|
| ID | 问题的ID |
| 标签 | 用于显示目的的问题标签。这将是本地化的。 |
| 值 | 问题的答案选项数组。 |
| 价值 | 答案选项的ID。 |
| 值标签 | 用于显示目的的答案选项的标签。这将是本地化的。 |
| 数 | 使用特定答案选项的评论数。 |
标签组
1.在标签组上创建过滤器
标签组统计是一个基于标志的特性。它们包含在API响应中包括= prod必威手机版本ucts&Stats = Reviews&TagStats = true在请求中。如果没有对任何答案选择的评论，它将被跳过。
注意:只有十大标签将按与标签/答案选项相关的评论降序返回。
创建过滤器的API请求示例:
https:// (stg) .api.bazaarvoice.com/data/reviews.json ? apiversion = 5.4 &passkey ={万能钥匙}&Filter = productId: {productId} &包括= prod必威手机版本ucts&Stats = reviews&TagStats = true
API响应示例:
…包括":{"产品 ": { .必威手机版本.. " ReviewStatistics”:{" TagDistribution ":{“Pro”:{" Id ":“专业”,“值”:[{“价值”:“干性皮肤”,“数”:715},{“价值”:“健康老龄化”、“数”:478},{“价值”:“破裂,摩擦皮肤”,“数”:469},{“价值”:“皮肤瘙痒”,“数”:450},{“价值”:“粗糙和崎岖不平的皮肤”,“数”:360},{“价值”:“eczema-prone皮肤”,“数”:281},{“价值”:“防晒”,“数”:221},{“价值”:“暗疮皮肤”,“数”:200},{“价值”:“psoriasis-prone皮肤”,“数”:162}]“标签”:“Pro " } }, } ... } }
2.筛选标签组的评论
您可以过滤任何特定的评论的标签组使用过滤器= Tag_ [TAG_NAME]:情商:[TAG_VALUE]
在上面的回答样本中，(TAG_NAME)=箴,(TAG_VALUE)=干性皮肤;健康老龄化;皮肤皲裂、擦伤;皮肤瘙痒;皮肤粗糙粗糙;等。
欲知更多过滤选项,点击在这里。
过滤评论的API请求示例:
https:// (stg) .api.bazaarvoice.com/data/reviews.json ? apiversion = 5.4 &passkey ={万能钥匙}&Filter = productId: {productId} &am必威手机版本pInclude = products&Stats = reviews&TagStats = true&Filter = Tag_Pro:情商:% 20的皮肤干燥
评审API的响应模式保持不变。响应现在将返回特定于所选标签组的筛选过的评论。详情请参阅检查显示查看关于Reviews.json的更多信息。
API响应模式(JSON格式):
api调用将返回带有以下键值对的Json数据。每个键值的重要性如下所示:
| 关键 | 价值 |
|---|---|
| ID | Tag组问题ID |
| 标签 | 用于显示目的的问题标签。这将是本地化的。 |
| 值 | 问题的答案选项数组。 |
| 价值 | 用于标识符和显示目的的答案选项的标签。这将是本地化的。 |
| 数 | 有特定答案选择的评论数 |
二级评级或滑块:
1.在二级评级/滑块上创建过滤器
次要评级或滑块统计是一个基于标志的功能。它们包含在API响应中包括= prod必威手机版本ucts&Stats = Reviews&SecondaryRatingStats = true在请求中。如果没有对任何答案选择的评论，它将被跳过。
创建过滤器的API请求示例:
https:// (stg) .api.bazaarvoice.com/data/reviews.json ? apiversion = 5.4 &passkey ={万能钥匙}&Filter = productId: {productId} &包括= prod必威手机版本ucts&Stats = reviews&SecondaryRatingStats = true
API响应示例:
包括":{"产品 ": { 必威手机版本... " ReviewStatistics”:{" SecondaryRatingsDistribution ":{"质量":{Id”:“质量”、“值”:[{“价值”:5,“数”:417},{“价值”:4,“数”:63},{“价值”:1、“数”:20},{“价值”:3,“数”:15},{“价值”:2,“数”:11}],“标签”:“质量”},“适合”:{" Id ":“适合”,“值”:[{“价值”:4,“数”:240年,“ValueLabel”:“略大”},{“价值”:3,“数”:186年,“ValueLabel”:“真正的规模”},{“价值”:5,“数”:122年,“ValueLabel”:"运行大"}，{"Value": 1， "Count": 4， "ValueLabel": "运行小"}，{"Value": 2， "Count": 2， "ValueLabel": "略小"}]，"Label": "整体契合"}，…}…"SecondaryRatingsAverages":{"契合":{"Id": "契合"，" averageration ": 3.8555956678700363， "DisplayType": "滑块"，"ValueRange": 5， "MaxLabel": "运行大"，"MinLabel": "运行小"，"Label": "整体契合"，"ValueLabel":["运行小"，"大小匹配"，"略大"，"运行大"}，"质量":{"Id":"Quality"， " averageration ": 4.608365019011407， "ValueRange": 5， "DisplayType": "NORMAL"， "MaxLabel": null， "MinLabel": null， "Label": "Quality"}}，…}…
2.过滤审查二级评级/滑块
此外，您可以过滤任何特定的评论“二次评级”使用过滤器= SecondaryRating_] [Id:情商:价值
在上面的回答样本中，(Id)=质量、健康、而且(价值)=1 2 3 4 5
注意:所有高级操作符都可用于二级评级比较。例子:情商，lte，一种，lt，gt
欲知更多过滤选项,点击在这里。
过滤评论的API请求示例:
https:// (stg) .api.bazaarvoice.com/data/reviews.json ? apiversion = 5.4 &passkey ={万能钥匙}&Filter = productId: {productId} &am必威手机版本pInclude = products&Stats = reviews&SecondaryRatingStats = true过滤器= SecondaryRating_Quality:一种:3
评审API的响应模式保持不变。响应现在将返回特定于所选二级评级的筛选过的评论。详情请参阅检查显示查看关于Reviews.json的更多信息。
API响应模式(JSON格式):
| 关键 | 价值 |
|---|---|
| ID | 问题的ID |
| 标签 | 用于显示目的的问题标签。这将是本地化的。 |
| 值 | 问题的答案选项数组。 |
| 价值 | 答案选项的ID。 |
| 值标签 | 用于显示目的的答案选项的标签。这将是本地化的。 只存在滑块。 |
| 数 | 使用特定答案选项的评论数。 |
故障排除
即使发生错误，对话API也总是返回一个HTTP 200代码。如果有错误，我们会将其包含在响应体中，HasErrors = True。我们这样做是为了让应用程序使用JSONP可以访问错误。
附录
一个法语例子:
https:// (stg) .api.bazaarvoice.com/data/reviews.json ? apiversion = 5.4 &passkey ={万能钥匙}&Filter = productId: {productId} &am必威手机版本pInclude = products&Stats = reviews&SecondaryRatingStats = true
…"ReviewStatistics": {"ContextDataDistributionOrder": ["LengthOfOwnership"， "HauteurDeLaPersonne"， "Poids"]， "ContextDataDistribution": {"Id": "LengthOfOwnership"， "Values": [{"Count": 13， "Value": "1week"， "ValueLabel": "1 semaine"}， {"Count": 20， "Value": "1month"， "ValueLabel": "1 mois"}]， "Label": "J'ai ce product depuis environ"}， "HauteurDeLaPersonne": {"Id": "HauteurDeLaPersonne"， "Values": [{"Count": 10， "Value": "de155A159Cm"， "ValueLabel": "ValueLabel": "ValueLabel": "1 mois"}， "HauteurDeLaPersonne": {"Count": " 10 "， "Value": "de155A159Cm"， "ValueLabel": "ValueLabel": "1 semaine":“155一个159厘米”},{“计数”:12,“价值”:“de160A164Cm”,“ValueLabel”:“160 164厘米”},{“计数”:18岁的“价值”:“de165A169Cm”、“ValueLabel”:“165 169厘米”},{“计数”:6,“价值”:“de170A174Cm”、“ValueLabel”:“170 174厘米”}],“标签”:“身材:”},“重量”:{" Id ":“重量”、“价值观”:[{“计数”:14日“价值”:“de50A54Kg”、“ValueLabel”:“德50 54公斤”},{“计数”:12,“价值”:“de55A59Kg”,“ValueLabel”:“德55 59公斤”},{“计数”:8,“价值”:“de70A74Kg”,“ValueLabel”:“70 74公斤”}],“标签”:“重量 :" } }, ... " SecondaryRatingsDistributionOrder”:(“价值”、“Styleduproduit”、“Matire”,“Fit_22”),“SecondaryRatingsDistribution”:{" Fit_22 ": {" Id ":“Fit_22”、“价值观”:[{“价值”:3,“数”:12日“ValueLabel”:“一般”},{“价值”:4,“数”:12日“ValueLabel”:“稍微大”},{“价值”:5,“数”:10“ValueLabel”:“太大”}],“标签”:“身材ce产品评论?”},“Styleduproduit”:{" Id ":“Styleduproduit”、“价值观”:[{“价值”:5,“数”:13},{“价值”:4,“数”:10}],“标签”:“杜风格产品”},“Matire”:{" Id ":“Matire”、“价值观”:[{“价值”:5,“数”:3},{“价值”:4,“数”:6}],“标签”:“Matiere”},“价值”:{" Id ":“价值”、“价值观”:[{“价值”:5,“数”:4},{“价值”:4,“数”:1}],“标签”:“融洽qualite-prix " } }, ... " SecondaryRatingsAveragesOrder”:(“价值”、“Styleduproduit”、“Matire”,“Fit_22”),“SecondaryRatingsAverages”:{“价值”:{" Id ":“价值”,“AverageRating”:4.8， "DisplayType": "NORMAL"， "MaxLabel": null， "ValueRange": 5， "MinLabel": null， "Label": "Rapport qualité-prix"}， " styleduproducit ": {"Id": " styleduproducit "， " averageration ": 4.75， "DisplayType": "NORMAL"， "MaxLabel": null， "ValueRange": 5， "MinLabel": null， "Label": "Styledu producit "}， "Matire": {"Id": "Matire"， " averageration ": 4.75， "DisplayType": "NORMAL"， "MaxLabel": null， "ValueRange": 5， "MinLabel": null， "Label": "Matière"}， "Fit_22": {"Id": "Fit_22"， " averageration ": "Matière"}， "Fit_22": {"Id": "Fit_22"， " averageration ": "3.8， "DisplayType": "SLIDER"， "ValueRange": 5， "MaxLabel": "Grand"， "MinLabel": "Petit"， "Label": "Comment taille ce product ?"， "ValueLabel": ["Trop Petit"， "Un peu Petit"， "Normalement"， "Un peu Grand"， "Trop Grand"]}}，…