此产品目录提要用于将Bazaarvoice用户生成的内容(如评论和评级)映射到您的相关产品和类别。必威手机版本

XML产品目录提要必须遵循特定的结构。Bazaarvoice接受XML或平面(CSV或TXT)文件格式。不过,XML是首选的文件格式。

提示:使用产品馈电发生器工具作为创建基于xml的产品目录提要的起点。请参阅指令在下面。

为什么产品目录数据如此重要?

产品目录提要支持以下功能:

  • 内容审查请求(以前是互动后的电子邮件或PIE)、通知和审查提交页面必须包含id、名称、品牌url、类别和产品信息等内容。
  • 联合-由于零售商和品牌经常使用不同的标识符和元数据来描述同一产品,一个准确的产品目录使Bazaarvoice能够匹配品牌和零售商提供的产品,然后根据产品匹配共享或“联合”用户生成的内容(UGC)。必威手机版本
  • 报告指示板-当您在Workbench中查看报表仪表板(和筛选器)时,将显示产品目录数据。

产品目录数据

Bazaarvoice支持以下方式来提供您的产品目录数据:

  • 基于xml的提要文件-提供一个包含所有目录数据的基于XML的单一结构化提要。目前,大多数PRR客户端通过单个基于XML的提要文件提供目录数据。

    注意:Bazaarvoice接受平面格式(CSV或TXT)(如果创建XML提要太难的话)。
  • 动态目录收集(DCC)-使Bazaarvoice收集和消费产品目录数据使用JavaScript标签放置在您的产品显示页面。当购物者访问产品显示页面时,JavaScript事件自动将目录数据传递给Bazaarvoice以供消费。

注意:大多数PRR客户端通过单个XML提要提供产品目录数据,而不是使用动态目录收集(DCC).DCC现在是提供目录数据的推荐方法。

逐步实现XML提要

完成以下步骤,创建一个XML提要并将其上传到Bazaarvoice:

步骤1:创建一个XML产品提要

步骤2:检查元素和属性

步骤3:验证产品提要

步骤4:上传产品提要

步骤5:检查提要状态

步骤6(可选):发送增量产品提要

步骤1:创建XML产品提要

您的技术团队必须为Bazaarvoice提供基于XML的、可用于生产的产品和产品类别的数据提要。必威手机版本XML产品目录提要必须遵循特定的结构。

构建您的产品目录提要

使用产品馈电发生器工具作为创建概要产品目录提要的起点。您可以将标记从生成器复制并粘贴到文本编辑器中。

  • 检查提要,确保提要的第一行遵循以下格式:
    <?XML版本="1.0"编码="utf-8"?>

    标准字符编码方案(如UTF-8或Windows-1252)必须与提要中用于任何特殊字符的方案相匹配。

  • 的根节点开始,检查基于xml的产品目录提要饲料.例如:

    <饲料xmlns =“//www.busanline.com/xs/PRR/ProductFeed/14.7”name =“客户端”增量=“假”extractDate =“2019 - 11 - 04 - t00:00:00”>
    属性 价值
    xmlns //www.busanline.com/xs/PRR/ProductFeed/14.7.这是用于定义提要结构的产品提要XML模式。
    的名字 客户名称,即贵公司的名称(例如,looneytunes
    增量 如果要发送包含整个产品目录的数据提要,请将此值设置为

    如果目录中的产品数量超过750,0必威手机版本00,则将此值设置为真正的发送增量提要,每个提要中不超过750,000个产品。必威手机版本

    extractDate 用时间戳自动填充此值,该时间戳标识从数据库中提取构成提要的数据的日期和时间。这个值必须以XML的dateTime格式表示。
  • XML产品目录提要必须遵循特定的结构。使用这个产品提要XML模式来定义提要的详细结构和内容。

    注意:模式的14.3+版本没有强制upc、ean和isbn的长度或数字限制。这些字段中的任何字符串都被产品模式视为有效。但是,在目录导入过程中验证UPC、EAN和ISBN字段中的值,并且只存储有效值。
警告:如果没有特定字段的值,请从提要中删除该字段。使用空白字段将阻止您的提要被导入。

示例XML产品目录提要

下面的示例显示了产品目录提要的一般结构。

<?XML版本="1.0"编码="utf-8"?><饲料xmlns =“//www.busanline.com/xs/PRR/ProductFeed/14.7”name =“客户端”增量=“假”extractDate =“2019 - 11 - 04 - t00:00:00.000000”><品牌><品牌>...> < /品牌> < /品牌<分类><目录>...> < /类别> < /类别<必威手机版本产品><产品>...< /产品>> 必威手机版本< /产品饲料> < /
  • 类别、品牌及其相关内容作为子元素显示在饲料元素和父元素类别品牌元素,分别。
  • 产品目录中的每个产品都有自己的特点产品元素的父元素必威手机版本元素。饲料
  • 与产品相关的元数据ProductPageUrl显示为适当产品下的子元素。
提示:请参阅此详细资料XML产品目录示例文件.它显示了Bazaarvoice所需的所有全局唯一标识符的提要结构和完整语法。

步骤2:检查元素和属性

必须使用适当的元素和属性来描述提要、品牌、类别和产品信息。的子元素和属性请参阅下表饲料品牌类别,产品元素。

与“Feed”元素相关的属性

下表标识了与数据提要所需的顶层相关联的属性饲料元素(前一节中也有描述)。

属性 价值
xmlns //www.busanline.com/xs/PRR/ProductFeed/14.7
的名字 客户名称,即贵公司的名称。
增量 如果要发送包含整个产品目录的数据提要,请将此值设置为

如果目录中的产品数量超过750,0必威手机版本00,则将此值设置为真正的发送增量提要,每个提要中不超过750,000个产品。必威手机版本

extractDate 用时间戳自动填充此值,该时间戳标识从数据库中提取构成提要的数据的日期和时间。这个值必须以XML的dateTime格式表示。

与“Brand”元素相关联的子元素

下表标识了与数据提要相关联的必需子元素品牌元素。

元素 价值
ExternalId

唯一的品牌ID,只能包含字母数字字符和以下特殊字符:),连字符(-),句号()和下划线(_).如果您的品牌标识包含无效字符,请使用替代字符替换它们,例如下划线。此格式仅在数据提要中使用,不会显示给最终用户。

确保ID是一个稳定的ID,即使品牌的名称发生了变化,该ID也不会因相同的逻辑品牌而发生变化。

的名字 品牌名称;对最终用户可见。

与“Category”元素关联的子元素

数据提要中的类别结构会影响Bazaarvoice实现的几个方面。标签可以分配给类别,这允许贡献者在提交内容时突出显示特定的产品属性。

例如,电子产品零售商可以为“耳机”产品类别创建以下标签:完美贴合、不合适、时尚、音质好和音质差。

这些标记以复选框的形式出现在内容提交表单上,也可以出现在产品类别或产品显示页面上。审稿人可以在提交内容时选择适当的标签,购物者可以在一个类别内过滤产品,只查看评级中包含匹配标签的产品。必威手机版本

类别也会填充类别选择器,这会影响组织中的人员如何在报告中过滤用户生成的内容等。例如,定义良好的类别结构可以帮助采购员只看到他们关心的产品类别的评论。

避免使用错误的分类出售因为他们没有真正地对产品进行分类。必威手机版本

下表标识了与数据提要相关联的子元素类别元素。

元素 价值 要求
的名字 类别或子类别的名称;对最终用户可见。 是的
ExternalId

唯一类别或子类别ID,只能包含字母数字字符和以下特殊字符:),连字符(-),句号()和下划线(_).如果类别id包含无效字符,请使用替代字符替换它们,例如下划线。此格式仅在数据提要中使用,不会显示给最终用户。

确保ID是一个稳定的ID,即使类别的名称发生了变化,该ID也不会对同一逻辑类别发生变化。

是的
CategoryPageUrl 类别或子类别的唯一未损坏的URL。不要包含可能用于跟踪和合作代码的无关的查询字符串参数。 是的
CategoryPageUrls

包含一个< CategoryPageUrl >元素在多语言实现中为每个区域设置。每一个< CategoryPageUrl >元素具有语言环境String类型的属性。

没有
ParentExternalId 有关子类别的父类别的ID。 没有
ImageUrl 类别图像的URL,通常托管在您的网站或内容分发网络(CDN)上。中不允许有空格ImageURL节点。 没有
ImageUrls

包含一个< ImageUrl >元素在多语言实现中为每个区域设置。每一个< ImageUrl >元素具有语言环境String类型的属性。

没有

与“Product”元素相关联的子元素

下表标识了与数据提要相关联的常见子元素产品元素。要获得可用元素的完整列表,请参考数据提要模式。

元素 价值 要求
ExternalId 唯一的产品族级ID,只能包含字母数字字符和以下特殊字符:),连字符(-),句号()和下划线(_).如果您的产品id包含无效字符,请使用替代字符替换它们,例如下划线。如果一个产品有它自己的页面,这个页面就是产品ID。

产品ID不一定是库存单位(SKU) ID,因为Bazaarvoice不会为不同风格的产品收集单独的内容。

此格式仅在数据提要中使用,不会显示给最终用户。

是的
的名字 产品名称;对最终用户可见。 是的
CategoryExternalId 产品所属的商店目录中的类别ID或子类别ID。 是的
ProductPageUrl 产品页面的唯一、未损坏的URL。不要包含可能用于跟踪和合作代码的无关的查询字符串参数。 是的
ImageUrl 产品图像的唯一URL。最佳但稍微灵活的显示尺寸是100像素x 100像素。建议使用缩略图。中不允许有空格ImageURL节点。 是的
方面笨手笨脚的 至少包含一个子节点< EAN >元素。 不,除非包括< EAN >元素
EAN 欧洲商品编号,用于在全球范围内标记零售商品;可以是8或13个字符的数字字符串。 没有
ManufacturerPartNumbers 至少包含一个子节点< ManufacturerPartNumber >元素。 不,除非包括< ManufacturerPartNumber >元素
ManufacturerPartNumber 特定于制造商的部件号,可以包含字母、数字和字符。 没有
优派克思 至少包含一个子节点< UPC >元素。 不,除非包括< UPC >元素
通用产品 通用产品代码,这是用于美国标准零售包装的6位或12位条形码。UPC必须只包含数字,不能包含字母或字符。此外,空格和连字符会破坏联合匹配,必须删除。 没有
isbn 至少包含一个子节点< ISBN >元素。 不,除非包括< ISBN >元素
国际标准图书编号 国际标准书号,是图书的唯一标识符,用于商业用途。数字长度为10或13位,由4或5个部分组成。数字的不同部分可以有不同的长度,通常用连字符(-)或波浪号().空格和连字符会破坏联合匹配,必须删除。 没有
的名字

包含子元素<名称>元素在多语言实现中为每个区域设置。每一个<名称>元素具有语言环境String类型的属性。

没有
描述 产品描述。为了帮助评论较少必威手机版本或较短的产品为seo优化的着陆页贡献大量的内容,建议产品描述至少三句话或300个字符。如果跨多个元素存储关于产品的描述性信息,请将元素连接到必威手机版本描述元素。

类中无法识别HTML元素描述元素。

没有
描述

包含子元素<描述>元素在多语言实现中为每个区域设置。每一个<描述>元素具有语言环境String类型的属性。

没有
BrandExternalId 产品的品牌标识。 没有
ProductPageUrls

包含子元素< ProductPageUrl >元素在多语言实现中为每个区域设置。每一个< ProductPageUrl >元素具有语言环境String类型的属性。

没有
ImageUrls

包含一个< ImageUrl >元素在多语言实现中为每个区域设置。每一个< ImageUrl >元素具有语言环境String类型的属性。

没有
ModelNumber 企业用来标识特定行业使用的部件的唯一引用代码。型号可以包含字母、数字和其他字符。 没有

如果一个元素不是必需的,但是您为您的产品维护了它,请将它包含在数据提要中。必威手机版本

步骤3:验证产品提要

您的提要需要符合以下Bazaarvoice XML模式的格式良好的XML:

//www.busanline.com/xs/PRR/ProductFeed/14.7

在将提要上传到Bazaarvoice之前,使用提要验证工具根据模式验证提要。网上有许多免费的提要验证工具,例如XMLBeans。

提要验证工具将帮助您查看以下信息:

  • 进口状态
  • 中的数据提要相关的错误和警告/ import-inbox目录和已被自动导入器处理过的
  • 登台上使用“调用一次性导入”链接的临时导入。这些都需要去除。

第四步:上传产品提要

Bazaarvoice建议您每天更新您的产品目录提要,以反映您的产品目录所做的任何更改。

注意:Bazaarvoice还建议你将其上传到存储提要的SFTP位置,直到被Bazaarvoice的自动导入过程拾取为止。

通过提供公共属性,为数据添加额外的安全级别SSH (Secure Socket Shell)密钥使用SSH无密码输入。此过程依赖于您的私钥,并与Bazaarvoice SFTP服务器使用的公钥配对。

联系Bazaarvoice客户服务如果要设置此基于密钥的身份验证方法。

在你正式上线之前

将您的提要上传到/ import-inbox目录。SFTP暂存服务器

注意:一旦上传,Bazaarvoice会在中部时间凌晨2点(CST: UTC-6或CDT: UTC-5)自动开始导入提要。虽然Bazaarvoice可能不会完成导入您的提要,直到当天晚些时候由于导入过程!

您也可以手动触发导入。完成以下步骤手动导入提要:

  1. 登录临时工作台
  2. 选择设置»验证产品提要
  3. 点击一次性导入手动导入提要。

在你上线之后

将您的提要上传到/ import-inbox目录。SFTP生产服务器

注意:Bazaarvoice的生产提要导入过程会在每晚的基础上自动拾取该文件夹中的文件。

不能手动触发对生产服务器的导入。

SFTP连接值

将XML提要文件上传到/ import-inboxSFTP服务器的目录。

  • 如果您的数据托管在美国,请使用以下url:
    • 交付准备服务器:sftp-stg.bazaarvoice.com
    • 生产服务器sftp.bazaarvoice.com
  • 如果您的数据托管在欧洲,请使用以下url:
    • 交付准备服务器sftp7-stg.bazaarvoice.com
    • 生产服务器sftp7.bazaarvoice.com

第五步:检查提要状态

上传一个提要后暂存生产SFTP服务器,可以查看提要的导入汇总(错误或警告计数)。

检查导入摘要可以帮助您在下次导入前纠正错误。

命令,查看导入摘要信息

  1. 登录https://portal.bazaarvoice.com登入Bazaarvoice传送门。
  2. 点击菜单位于左上角,可查看您的Bazaarvoice解决方案列表。
  3. 点击工作台在菜单上。工作台去哪里了?页面显示。
  4. 从下拉菜单中选择您的公司。
    提示:根据您的访问级别,选择登录到登台环境还是生产环境。
  5. 点击转到工作台
  6. 选择设置»验证产品提要查看提要导入摘要。如果您的提要返回错误或警告,请单击它以显示更详细的信息。
注意:您应该只向服务器上传格式良好的提要。使用提要导入摘要来捕获主要验证工具可能遗漏的错误。

步骤6(可选):发送增量产品提要

一个完整的产品目录提要(推荐策略)包括所有必威手机版本目录中可用的产品,您希望为其收集内容。增量提要包含产品子集的数据。必威手机版本

要减小文件大小,您可以发送增量提要,其中包括新添加和更新的产品、类别和品牌,包括已删除的项目。必威手机版本

增量提要与标准XML提要的区别如下:

  • 饲料元素包含被设置为的增量属性真正的
  • 删除与适用对象关联的属性产品类别,品牌Elements设置为真正的

下面的示例显示了一个增量产品提要。

<饲料name =“ExampleClient”增量=“真正的”extractDate =“2019 - 08 - 31 - t08:02:00凌晨”><分类><目录>< ExternalId >1 - 8< / ExternalId ><名称>我的宠物如何让我成为冠军< /名称>< ParentExternalId >1 - 16< / ParentExternalId >< CategoryPageUrl >http://www.client.com/Content/ContentNoNAV.aspx?PC=heartofchampion< / CategoryPageUrl >> < /类别<目录>< ExternalId >1 - 9< / ExternalId ><名称>为什么我的宠物是冠军< /名称>< ParentExternalId >1 - 16< / ParentExternalId >< CategoryPageUrl >http://www.client.com/Content/ContentNoNAV.aspx?PC=heartofchampion< / CategoryPageUrl >> < /类别<类别删除=“真正的”>< ExternalId >1 - 6< / ExternalId ><名称>淘气的< /名称>< CategoryPageUrl >http://www.client.com/Content/ContentNoNAV.aspx?PC=naughtynicecontest< / CategoryPageUrl >> < /类别<类别删除=“真正的”>< ExternalId >1 - 7< / ExternalId ><名称>不错的< /名称>< CategoryPageUrl >http://www.client.com/Content/ContentNoNAV.aspx?PC=naughtynicecontest< / CategoryPageUrl >> < /类别> < /类别饲料> < /

在本例中,以下元素将提要定义为增量产品提要:

此外,以下元素指定删除相关类别:

<类别删除= " true " >

示例提要

为了帮助您实现,请参考Bazaarvoice的对话知识库,以获得以下示例提要和格式: