API的对话：检索并提交消费者生成的内容(CGC)，检索您的产品目录和关于CGC的统计信息。
真实性
对话API允许您以编程方式检索和提交Bazaarvoice对话数据以在应用程序中使用。要了解更多信息，请参阅对话API文档主页．
内容
在本教程中，开发人员将了解内容的真实性意味着什么，以及他们可以做些什么来增加他们的应用程序符合Bazaarvoice真实性政策的可能性。
简介
在Bazaarvoice，我们相信真实的消费者生成内容(CGC)代表了作者对产品或服务体验的真实、公正和透明的意见。以下是对正宗CGC的三个主要特征的总结:
- 免于欺诈和垃圾邮件，包括破坏性或“喷子”行为，商业消息，自动提交(例如机器人和脚本)，来自客户竞争对手的内容，和未公开的自我推广
- 不受编辑，分类，并由原作者以外的任何人更改-包括拼写或语法的更正
- 我们不允许公司直接要求正面评价。如果消费者提供金钱或促销材料(如折扣或优惠券)以换取提供公正的评论，那么评论必须注意到这一事实。此外，组织的员工和供应商不得提交内容而不披露他们与产品或服务的关系
请参阅我们的真实性的政策了解更多关于内容被视为真实的要求。
继续阅读，了解如何提高提交到我们平台的内容的真实性。
提交访问控制
为了被认为是真实的，Bazaarvoice客户端的竞争对手不能向该客户的网站提交内容。试图改变另一个网站上内容的总评级和/或情绪也被认为是不真实的。采用以下提交访问控制来防止这些情况:
API密钥管理
如果没有API密钥，使用对话API的内容可能无法提交给Bazaarvoice平台。我们提供自助服务流程，允许我们的客户控制发放活动密钥的人，以及随时启用和禁用密钥。这使我们的客户可以控制可能提交内容的应用程序。
阅读自助服务API密钥进程文档获取更多信息。
身份验证
身份验证是一种验证内容作者是否是他们所声称的人的方法。对话API支持两种身份验证方法:bazaarvoice - mastering和client - mastering。通过实现其中一种方法，可以确保每个作者都是唯一标识的，从而使欺诈提交更加难以执行，也更容易被捕获。
读取身份验证文档获取更多信息。
设备信誉管理
大规模的广告活动、恶意攻击和自动提交内容的尝试都是不真实内容的来源。为了应对这些问题，Bazaarvoice与设备声誉管理方面的行业领导者合作。
Bazaarvoice使用作者设备的信息，包括IP地址和设备指纹，并结合复杂的算法，使我们能够识别、标记和报告可疑内容。
作者IP地址
发起HTTP请求的计算机(客户端)的IP地址自动与接收请求的计算机(服务器)通信。如果您提交的对话API来自网络浏览器或移动应用程序，我们将自动收到作者的IP地址。
然而,如果您正在执行从您的服务器提交到我们的服务器，那么您必须使用X-Forwarded-For头将作者的IP地址传递给我们．否则，我们将收到您每次提交的服务器IP地址，这增加了您的提交将被标记为不真实的可能性。
下面以IP地址为例192.0.2.1表示内容作者的IP地址:
POST /数据/ submitreview。内容类型:application/x-www-form-urlencoded . json HTTP/1.1X-Forwarded-For: 192.0.2.1．.．评级= 5标题= + + +审查+ title&reviewtext = + +复习+文本。+ +是+复习+文本。+ +是+复习+文本。+ +是+复习+文本。+ +是+复习+文本。+ +是+复习+文本。+ +是+复习+文本。+ &UserNickname = bvtester&productId = io_bb_callback&userId = 1234567 &apiversion = 5.4行动= submit&passkey = hk5pv3pfasrrdjyq487m699s
上面例子中的省略号(…)表示你的应用程序可能会生成其他头文件。
设备的指纹
设备指纹是一个包含用户代理信息的编码字符串。生成设备指纹的技术因环境和设备信誉伙伴而异，但通常会涉及以下步骤:
- 在应用程序中配置和加载设备指纹库。
- 等待脚本分析用户代理并创建设备指纹。
- 将设备指纹传达给Bazaarvoice或我们的信誉管理合作伙伴之一。
读指纹识别设备有关演示如何执行设备指纹识别的详细信息和代码示例。
内容XML导入
Bazaarvoice可以导入在与我们建立合同关系之前收集的“遗留”内容。这是通过将内容转换为Bazaarvoice原生XML格式来实现的。这种格式确保以与我们平台的架构需求一致的方式正确地标记和标识内容。只有这样才能保证我们所需要的数据真实性的政策正确导入。
可以在下面看到几个演示原生XML格式的示例XML文件http://knowledge.bazaarvoice.com/wp-content/conversations/en_US/Collect/native_content_import.html#full-feed-examples．
新客户将与他们的Bazaarvoice实现团队一起执行转换和导入。现有客户可以联系我们的支援小组。
基于文本或图形的关系指示器
产品和服务的自我推广、代言和第三方内必威手机版本容都必须被清楚地识别出来，才能被认为是真实的。内容作者和内容主体之间的关系应该清楚地向读者披露。例如，一个图形徽章可以表明评论的作者是生产被评论产品的公司的员工，或者一个文本字符串可以表明评论的作者参与了包括撰写评论在内的促销活动。
使用对话API可以通过以下几种方式来指示作者/主题关系:
落款:徽章通常显示为指示内容作者和内容主题之间关系的可视符号。 
|
上下文数据值:上下文数据值向用户提供关于作者与内容主题之间关系的附加信息。 
|
有关此主题的其他文档，请参阅以下资源:必威投注网
按时间排序
用户可以选择按时间顺序查看CGC。
使用对话API，可以通过多种方式请求预先排序的内容，包括提交时间。该格式如下所示，适用于所有Bazaarvoice内容类型:
https:// (stg) api.bazaarvoice.com/data/ {contentType} . json ?万能钥匙= {yourPasskey} &ApiVersion = {latestApiVersion) &= SubmissionTime: {asc | desc}
| 这种后缀 | 显示顺序 |
|---|---|
desc |
最新的第一 |
asc |
古老的第一 |