文本饲料
您还可以使用文本提要提供目录数据。这种产品提要类型的主要好处是，对于拥有较小目录的客户来说，手动创建相对容易。然而，也有一些限制，将在下一节中描述。
创建一个文本产品目录提要
Bazaarvoice支持在文本文件中接收目录数据。虽然此格式可用于提供主目录提要，Bazaarvoice建议您使用文本格式补充提要文件因为文本格式有以下限制:
- 缺乏本地化—您无法提供本地化的目录属性，如产品名称、类别名称和url。
- 简单的类别层次结构——尽管文本格式支持类别信息，但文本文件中只能提供非本地化的类别名称。唯一类别标识符不能在文本文件中发送到Bazaarvoice;如果是，如果类别名称因任何原因而随时间变化，则可能会出现下游问题。
对字段值的严格限制-在创建文本提要时必须遵守以下规则:
- 不要在字段值中包含分隔符(逗号、管道或制表符)的实例，例如
的名字或描述． - 不要在字段值周围使用双引号。
- 避免在字段值中包含前导和尾随空格，因为当存储在Bazaarvoice数据库中时，它们将包含在值中。
完成本节中的步骤，以文本文件的形式向Bazaarvoice提供目录数据。
步骤1:创建并格式化文本文件
下面几节详细介绍Bazaarvoice文本提要文件的确切规范。
文件属性
文件格式必须如下所示:
| 文件属性 | 描述 |
|---|---|
| 头 | 必须列在文件的第一行和开始//．在使用时，为特定的场景包含一个头多个目录源，例如将一个文本文件与多个目录提要源一起用作主提要时。这里有一个例子: / / catalogMode =完成 |
| 分隔符 | 使用下列分隔符之一分隔列:
|
列标题行 |
需要描述文件中提供的值。该文件必须包含至少两列。指列定义获取可包含在文件中的头文件和值的列表。 |
文件扩展名 |
您可以在命名提要文件时使用任何文件扩展名，因为Bazaarvoice会自动检测文件类型。不过，Bazaarvoice建议使用常用的扩展名，如.csv、.tsv或.txt。 |
列定义
文本文件支持以下列。请注意，列名不区分大小写。
| 列名 | 价值 | 要求 |
|---|---|---|
ExternalId |
唯一的产品ID，只能包含字母数字字符、连字符( 此格式仅在数据提要中使用，最终用户不可见。 |
是的 |
的名字 |
产品的名称，最终用户可以看到。 |
没有 |
描述 |
产品描述。描述只能在可选的Facebook评分与评论或问答应用程序中使用。Bazaarvoice建议产品描述至少要三句话或300个字符长。 |
没有 |
品牌 |
产品所属的品牌名称。
注意:如果 BrandExternalId没有指定除品牌，即使在提要中指定了品牌外部ID或在过去创建了品牌外部ID，也会创建品牌外部ID。 |
推荐 |
BrandExternalId |
产品所属品牌的ID。 |
推荐 |
类别 |
产品的类别名称。 |
推荐 |
CategoryExternalId |
产品的类别ID。
注意:如果 CategoryExternalId没有指定除类别，即使在提要中指定了类别外部ID或在过去创建了类别外部ID，也会创建类别外部ID。 |
推荐 |
ProductUrl |
产品页面的唯一、未损坏的URL。不要包含可能用于跟踪和合作代码的无关的查询字符串参数。如果URL包含保留(特殊)字符，则必须这样做url |
是的 |
ImageUrl |
产品图像的唯一URL。最佳的但稍微灵活的显示尺寸是600 x 600像素。如果URL包含保留(特殊)字符，则必须这样做url
注意:如果对话部署在HTTPS站点上，则必须在您的数据库中的HTTPS位置提供映像url产品目录．如果您不这样做，您的客户将看到一个混合内容警告。 |
是的 |
ModelNumber |
企业用来标识特定行业使用的部件的唯一引用代码。每个型号可以包含字母、数字和其他字符。 | 没有;如果包括在内，每个产品一个 |
ManufacturerPartNumber |
制造商特定部件号(MPN)。部件号可以包含字母、数字和字符。 | 推荐 |
EAN |
欧洲商品编号(EAN)，用于在全球范围内标记零售商品。EAN必须是由8个或13个数字组成的字符串(不允许有字母或其他字符)。删除空格和连字符，因为它们破坏了联合匹配。
注意:Bazaarvoice不强制ean的长度或数字限制。但是，在目录导入过程中验证值，并且只存储有效值。 |
要么 如果包含，则可以指定无限数量的子元素。如果指定多个值，联合匹配将得到改善。 |
通用产品 |
通用产品代码(UPC)，这是一种6位或12位的条形码，用于美国的标准零售包装。UPC只能包含数字，不能包含字母或其他字符。删除空格和连字符，因为它们破坏了联合匹配。
注意:Bazaarvoice不强制ean的长度或数字限制。但是，在目录导入过程中验证值，并且只存储有效值。 |
要么 如果包含，则可以指定无限数量的子元素。如果指定多个值，联合匹配将得到改善。 |
国际标准图书编号 |
国际标准书号(ISBN)，这是一个10或13个字符的值，主要用于媒体产品，如书籍、音乐和视频。必威手机版本最后一个字符提供一个校验和，帮助验证产品标识符。大多数ISBN只由数字组成，除了一些10个字符的ISBN值使用X作为校验和。 | 要么 如果包含，则可以指定无限数量的子元素。如果指定多个值，联合匹配将得到改善。 |
GTIN |
全球贸易项目编号(GTIN)，是全球唯一的14位数字，用于标识贸易项目、产品或服务。必威手机版本Bazaarvoice自动检测GTIN字段中提供的值类型，并将其存储为适当的UPC、EAN或ISBN值在Bazaarvoice数据库中。 | 没有 |
BV_FE_Family |
产品所属的产品族名称。Bazaarvoice建议您在产品名称中排除特殊字符。 | 没有 |
BV_FE_Expand |
产品包名称，使产品能够在产品包的页面上显示关于家族组件的所有内容。 | 没有 |
不活跃的 |
标记产品不活跃的如果一个是的或真正的值在此列中指定。
注意:如果该产品在数据库中不存在，并且标记为非活动，则不会将其添加到数据库中。 |
没有 |
这个角色。例如，使用具有多个值的产品属性
如果一个产品的某个属性有多个值，您应该尽可能提供所有值，以最大化Bazaarvoice网络的价值。例如，一件衬衫在您的目录系统中可能有不同的sku，每个颜色或尺寸变体对应一个sku。Bazaarvoice支持以下产品属性的多个值:
- 通用产品
- EAN
- 国际标准图书编号
- GTIN
- ManufacturerPartNumber
- ModelNumber
要为一个属性提供多个值，您可以
- 将值组合到一个列中，并使用空格分隔值。这里有一个例子:
ExternalId | UPC
123 | 123000000001
456 | 456000000001 456000000002 456000000003
788 | 789000000001 789000000002 - 在文件中重复产品，在每行上提供不同的值。这里有一个例子:
ExternalId,通用产品
123, 123000000001
456, 456000000001
456, 456000000002
789, 789000000001
789, 789000000002
789, 789000000003
步骤2:上传提要
Bazaarvoice建议您上传最新的产品提要，每当您的产品目录发生变化时，您的网站就会反映出来。当您的产品目录在您的实时站点上发生变化时，您必须向Bazaarvoice提供匹配的更新。
通过使用SSH无密码输入提供公共Secure Socket Shell (SSH)密钥，可以为数据添加另一级别的安全性。此过程依赖于您的私钥，并与Bazaarvoice SFTP服务器使用的公钥配对。如果您需要设置这种基于密钥的认证方式，请联系Bazaarvoice客户服务获取信息和帮助。
将提要文件上传到/ import-inboxSFTP服务器的目录:
- 如果您的数据托管在美国，请使用以下url:
- 交付准备服务器。sftp-stg.bazaarvoice.com
- 生产服务器,sftp.bazaarvoice.com
- 如果您的数据托管在欧洲，请使用以下url:
- 交付准备服务器。sftp7-stg.bazaarvoice.com
- 生产服务器,sftp7.bazaarvoice.com
请确保使用22端口连接到SFTP。联系Bazaarvoice客户服务如果你不知道你的SFTP证书或你的数据托管在哪里。
在您将产品提要上传到SFTP服务器后，Bazaarvoice将在中部时间凌晨2点(CST: UTC-6或CDT: UTC-5)自动开始导入提要，尽管Bazaarvoice可能要到当天晚些时候才能完成导入提要的工作。
如果将提要上传到登台服务器，则可以手动触发导入。(不能手动触发到生产服务器的导入。)完成以下步骤手动导入提要:
- 从登台服务器的Workbench中选择>验证产品提要．
- 选择安排一次性导入手动导入提要。
步骤3:检查提要状态
在将提要上传到登台或生产SFTP服务器后，您可以查看提要的导入摘要和错误或警告计数。检查导入摘要使您能够在下一次导入之前纠正错误，从而确保为下一次导入提供了有效的提要。
通过选择，在工作台中查看登台服务器或生产服务器的导入摘要>验证产品提要．如果您的提要返回错误或警告，请选择它以获取更多信息。
文本提要示例
下面的例子是一个简单的逗号分隔值文件，提供补充EAN目录数据:
ExternalId, EAN 123,0123000000001 456,0456000000001 456,0456000000002 789,0789000000001 789,0789000000002 789,0789000000003
下面是一个CSV文件的示例，可以用作产品目录数据的主要提要:
//catalogMode=COMPLETE ExternalId, UPC 123,123000000001 456,456000000001 456,456000000002 789,789000000001 789,789000000002 789,789000000003
增量提要文件
完整的产品目录提要包括目录中可用的所有产品，以及您希望为其收集内容的所有产品。必威手机版本增量提要包含产品子集的数据。必威手机版本
考虑以下使用完整和增量提要的策略:
- 只提供全量饲料
您可以向Bazaarvoice上传一个完整的、定期的XML目录提要，其中包括所有活动产品和类别的所有当前数据。必威手机版本这是推荐的策略。
- 完整和增量提要
您可以混合提供完整的和增量的目录提要。我们建议您提供一个初始的完整目录提要，然后定期提供增量提要，其中只包含对目录数据的更改。如果出现以下情况，可以考虑使用完整和增量产品提要:
- 您的产品目录更改得非常频繁，因此有必要每天更新产品提要
- 对您的产品提要进行不频繁或适度的更新
但是，为了防止由于上传和处理任何给定的增量提要失败而导致数据集中出现空白，我们建议您定期提供完整的提要(包含完整目录的当前数据)，以确保不存在数据空白。
- 仅使用增量提要
如果不能在一个完整的目录提要中提供所有产品，则只能提必威手机版本供增量提要。一定要包括删除= " true "属性，当只提供增量提要时。指控制活跃的产品集必威手机版本有关此方法的更多信息。
警告:如果您只使用增量提要，并且从未向Bazaarvoice提供完整提要，则如果错过了增量提要上传或以任何方式失败，目录数据可能与源产品目录不同步。
每个提要文件都表明它是完整的还是增量的，尽管这取决于提要格式的不同:
- XML提要文件:使用增量属性中的
<饲料>元素 - 文本提要文件:指定文件头
使用产品系列分享评论
“对话”中的产品族功能使您可以在多个相关产品之间共享UGC。必威手机版本通过将产品划分为fami必威手机版本ly，用户可以在所有family成员的产品展示页面中显示关于某个family成员的UGC。在产品家族成员之间分享评论可以提高Bazaarvoice实现的以下关键性能指标:
- 显示评论的产品百分比必威手机版本
- 显示评论的产品数量必威手机版本
- 每个产品的平均评论
- 显示的评论总数
产品族的类型
您使用的产品族的类型取决于产品的不同:必威手机版本
产品变体-在必威手机版本消费者体验方面与其他产品几乎相同，但其sku或零件编号不同的产品。例如，不同颜色、不同尺寸或必威手机版本不同重量或数量包装的产品可能是彼此的变体。来自产品变体的内容通常在各个方向共享。给定家庭必威手机版本中的所有产品都显示关于其他家庭成员的内容。
当每个产品变体都显示在自己的产品显示页面上时，创建产品变体的产品族效果最好。如果您的网站上所有产品变体都共享同一页面，那么在与Bazaarvoice集成时，将这些变体视为一个产品可能比为这些产品设置一个产品族更简单、更实用。必威手机版本
- 产品包-一起销售的产品组，否则必威手机版本可能单独销售。关于产品包的内容通常在一个方向上共享:从单个组件到产品包。通常，包的产品显示页面显示了关于各个组件的所有评论。但是，每个组件的产品显示页面只显示关于该组件的评论。
配置产品族
您可以在产品提要中或通过Workbench配置产品族。您可以使用这些方法同时将产品分配给一个或多个系列。
在配置产品族时，请注意以下事项:
- 产品族配置不能在登台环境和生产环境之间进行转换。
- 您在Workbench中对产品族所做的任何更改都只能通过Workbench来撤销。
- 产品提要中的族定义不会覆盖Workbench中的任何族操作。
使用产品饲料
我们建议您通过产品提要创建产品族，如果您清楚地知道哪些产品可以分组到家族中。必威手机版本在产品提要中自动化这些关系比使用Workbench创建它们更直接、更快。
您可以通过包含以下一个或两个属性来配置产品提要中的产品族:
- BV_FE_FAMILY-添加一个产品到特定的家族。
- BV_FE_EXPAND-使一个产品可以显示家族中其他成员的所有内容。
在这个XML示例中，家族中的所有产品都显示关于家族必威手机版本中所有其他成员的内容。
<产品> < ExternalId >…< / ExternalId > <名称>Green iPod Nano... ... ... ... ... <属性> <属性id="BV_FE_FAMILY"> <值>iPod_Nanos <属性id="BV_FE_EXPAND"> <值>BV_FE_FAMILY:iPod_Nanos…< / ExternalId > <名称>Pink iPod Nano ... ... ... ... ... <属性> <属性id="BV_FE_FAMILY"> <值>iPod_Nanos <属性id="BV_FE_EXPAND"> <值>BV_FE_FAMILY:iPod_Nanos < /产品>
在下面的XML示例中，产品包包含BV_FE_EXPAND，因此所有关于家族组件的评论都显示在包的页面上。但是，产品中省略了BV_FE_EXPAND<属性>各个组件的定义，以防止在组件页面上显示关于包的审查。
<产品> < ExternalId >…< / ExternalId > <名称>价值包< /名称> <描述>…<描述> / < BrandExternalId >…< / BrandExternalId > < CategoryExternalId >…< / CategoryExternalId > < ProductPageUrl >…< / ProductPageUrl > < ImageUrl >…< / ImageUrl >Value_Bundle BV_FE_FAMILY:Value_Bundle …< / ExternalId > <名称>独立的组件< /名称> <描述>…<描述> / < BrandExternalId >…< / BrandExternalId > < CategoryExternalId >…< / CategoryExternalId > < ProductPageUrl >…< / ProductPageUrl > < ImageUrl >…< / ImageUrl > < /产品> Value_Bundle
使用工作台
在以下情况下使用Workbench手动创建族:
- 您不熟悉XML。
- 您无法对产品提要进行操作。
- 您需要创建一个族，其UGC共享关系不是直接的，也不可能在产品提要中配置。
下面两个示例描述了使用Workbench创建产品族的场景。
- MP3播放器的分类管理器希望在所有颜色的32mb和64mb播放器之间共享评论。在提要中为32 MB设备和64 MB设备设置单独的族是很简单的。但是，由于32 MB设备和64 MB设备具有不同的sku，因此可能无法使用提要将它们组合到一个系列中。类别管理器应该在Workbench中配置类。
- 一位个人护理品牌经理想在夏季将润唇膏和防晒霜捆绑销售。品牌经理希望配置一个包含唇膏和防晒霜的产品系列，以便在产品包的页面上共享对各个产品系列成员的评论。然而，润唇膏和防晒霜并没有一个共同的产品饲料元素将它们联系在一起。品牌经理应该在Workbench中配置产品族。当季节结束，品牌经理不再希望一起销售产品时，经理可以使用Workbench删除产品族包。必威手机版本
完成以下步骤，通过Workbench配置产品族。
- 登录到Workbench并导航到内容>管理家庭．
- 选择添加新家庭，并输入产品族的名称。
- 为想要添加到系列中的每个产品输入Product ID，如XML产品提要中所示，然后选择添加产品．
- 取消选择扩大如果您不希望相应的产品显示来自家庭成员的内容。
- 选择x回到管理家庭页面。
定义产品类别层次结构
如果创建XML提要文件，则可以定义产品类别层次结构。属性将每个产品与层次结构中的特定类别相关联< CategoryExternalId >元素，可以定义类别的父类，从而定义类别层次结构< ParentExternalId >元素。
如果您正在提供，请注意以下内容多个提要有关目录数据:
- 在多个提要中出现的产品必须在所有提要中处于同一类别。因此，如果产品A在饲料A中属于X类，那么产品A就不能在饲料B中属于Y类。
- 在多个提要中列出的类别必须在所有提要中属于同一父类别。因此，如果类别A在提要A的父类别X中，那么类别A不能在提要B的父类别Y中。
下面的XML文件摘录定义了一个< CategoryExternalId >类引用的类别< ParentExternalId >元素。
<类别> <类别>Food -1123 Food <=无父类别;这是一个顶级层次结构元素…<必威手机版本Products> Fruit -1789 Fruit Food -1123 <= "Fruit" Category是Category " Food "的子Category…123 Apple Fruit -1789 <=属于Category " Fruit "…< /产品>…> 必威手机版本< /产品
