产品目录提要
此产品目录提要用于将Bazaarvoice用户生成的内容(如评论和评级)映射到您的相关产品和类别。必威手机版本
XML产品目录提要必须遵循特定的结构。Bazaarvoice接受XML或平面(CSV或TXT)文件格式。不过,XML是首选的文件格式。
为什么产品目录数据如此重要?
产品目录提要支持以下功能:
- 内容审查请求(以前是互动后的电子邮件或PIE)、通知和审查提交页面必须包含id、名称、品牌url、类别和产品信息等内容。
- 联合-由于零售商和品牌经常使用不同的标识符和元数据来描述同一产品,一个准确的产品目录使Bazaarvoice能够匹配品牌和零售商提供的产品,然后根据产品匹配共享或“联合”用户生成的内容(UGC)。必威手机版本
- 报告指示板-当您在Workbench中查看报表仪表板(和筛选器)时,将显示产品目录数据。
产品目录数据
Bazaarvoice支持以下方式来提供您的产品目录数据:
基于xml的提要文件-提供一个包含所有目录数据的基于XML的单一结构化提要。目前,大多数PRR客户端通过单个基于XML的提要文件提供目录数据。
注意:Bazaarvoice接受平面格式(CSV或TXT)(如果创建XML提要太难的话)。动态目录收集(DCC)-使Bazaarvoice收集和消费产品目录数据使用JavaScript标签放置在您的产品显示页面。当购物者访问产品显示页面时,JavaScript事件自动将目录数据传递给Bazaarvoice以供消费。
逐步实现XML提要
完成以下步骤,创建一个XML提要并将其上传到Bazaarvoice:
步骤1:创建一个XML产品提要
步骤2:检查元素和属性
步骤3:验证产品提要
步骤4:上传产品提要
步骤5:检查提要状态
步骤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
显示为适当产品下的子元素。
步骤2:检查元素和属性
必须使用适当的元素和属性来描述提要、品牌、类别和产品信息。的子元素和属性请参阅下表饲料,品牌,类别,产品元素。
与“Feed”元素相关的属性
下表标识了与数据提要所需的顶层相关联的属性饲料
元素(前一节中也有描述)。
属性 | 价值 |
---|---|
xmlns |
//www.busanline.com/xs/PRR/ProductFeed/14.7 |
的名字 |
客户名称,即贵公司的名称。 |
增量 |
如果要发送包含整个产品目录的数据提要,请将此值设置为假 .如果目录中的产品数量超过750,0必威手机版本00,则将此值设置为 |
extractDate |
用时间戳自动填充此值,该时间戳标识从数据库中提取构成提要的数据的日期和时间。这个值必须以XML的dateTime格式表示。 |
与“Brand”元素相关联的子元素
下表标识了与数据提要相关联的必需子元素品牌
元素。
元素 | 价值 |
---|---|
ExternalId |
唯一的品牌ID,只能包含字母数字字符和以下特殊字符: 确保ID是一个稳定的ID,即使品牌的名称发生了变化,该ID也不会因相同的逻辑品牌而发生变化。 |
的名字 |
品牌名称;对最终用户可见。 |
与“Category”元素关联的子元素
数据提要中的类别结构会影响Bazaarvoice实现的几个方面。标签可以分配给类别,这允许贡献者在提交内容时突出显示特定的产品属性。
例如,电子产品零售商可以为“耳机”产品类别创建以下标签:完美贴合、不合适、时尚、音质好和音质差。
这些标记以复选框的形式出现在内容提交表单上,也可以出现在产品类别或产品显示页面上。审稿人可以在提交内容时选择适当的标签,购物者可以在一个类别内过滤产品,只查看评级中包含匹配标签的产品。必威手机版本
类别也会填充类别选择器,这会影响组织中的人员如何在报告中过滤用户生成的内容等。例如,定义良好的类别结构可以帮助采购员只看到他们关心的产品类别的评论。
避免使用错误的分类出售
因为他们没有真正地对产品进行分类。必威手机版本
下表标识了与数据提要相关联的子元素类别
元素。
元素 | 价值 | 要求 |
---|---|---|
的名字 |
类别或子类别的名称;对最终用户可见。 | 是的 |
ExternalId |
唯一类别或子类别ID,只能包含字母数字字符和以下特殊字符: 确保ID是一个稳定的ID,即使类别的名称发生了变化,该ID也不会对同一逻辑类别发生变化。 |
是的 |
CategoryPageUrl |
类别或子类别的唯一未损坏的URL。不要包含可能用于跟踪和合作代码的无关的查询字符串参数。 | 是的 |
CategoryPageUrls |
包含一个 |
没有 |
ParentExternalId |
有关子类别的父类别的ID。 | 没有 |
ImageUrl |
类别图像的URL,通常托管在您的网站或内容分发网络(CDN)上。中不允许有空格ImageURL 节点。 |
没有 |
ImageUrls |
包含一个 |
没有 |
与“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个部分组成。数字的不同部分可以有不同的长度,通常用连字符(- )或波浪号(~ ).空格和连字符会破坏联合匹配,必须删除。 |
没有 |
的名字 |
包含子元素 |
没有 |
描述 |
产品描述。为了帮助评论较少必威手机版本或较短的产品为seo优化的着陆页贡献大量的内容,建议产品描述至少三句话或300个字符。如果跨多个元素存储关于产品的描述性信息,请将元素连接到必威手机版本描述 元素。类中无法识别HTML元素 |
没有 |
描述 |
包含子元素 |
没有 |
BrandExternalId |
产品的品牌标识。 | 没有 |
ProductPageUrls |
包含子元素 |
没有 |
ImageUrls |
包含一个 |
没有 |
ModelNumber |
企业用来标识特定行业使用的部件的唯一引用代码。型号可以包含字母、数字和其他字符。 | 没有 |
如果一个元素不是必需的,但是您为您的产品维护了它,请将它包含在数据提要中。必威手机版本
步骤3:验证产品提要
您的提要需要符合以下Bazaarvoice XML模式的格式良好的XML:
//www.busanline.com/xs/PRR/ProductFeed/14.7
在将提要上传到Bazaarvoice之前,使用提要验证工具根据模式验证提要。网上有许多免费的提要验证工具,例如XMLBeans。
提要验证工具将帮助您查看以下信息:
- 进口状态
- 中的数据提要相关的错误和警告
/ import-inbox
目录和已被自动导入器处理过的 - 登台上使用“调用一次性导入”链接的临时导入。这些都需要去除。
第四步:上传产品提要
Bazaarvoice建议您每天更新您的产品目录提要,以反映您的产品目录所做的任何更改。
通过提供公共属性,为数据添加额外的安全级别SSH (Secure Socket Shell)密钥使用SSH无密码输入。此过程依赖于您的私钥,并与Bazaarvoice SFTP服务器使用的公钥配对。
联系Bazaarvoice客户服务如果要设置此基于密钥的身份验证方法。
在你正式上线之前
将您的提要上传到/ import-inbox
目录。SFTP暂存服务器.
您也可以手动触发导入。完成以下步骤手动导入提要:
- 登录临时工作台.
- 选择设置»验证产品提要.
- 点击一次性导入手动导入提要。
在你上线之后
将您的提要上传到/ import-inbox
目录。SFTP生产服务器.
不能手动触发对生产服务器的导入。
SFTP连接值
将XML提要文件上传到/ import-inbox
SFTP服务器的目录。
- 如果您的数据托管在美国,请使用以下url:
- 交付准备服务器:
sftp-stg.bazaarvoice.com
- 生产服务器
sftp.bazaarvoice.com
- 交付准备服务器:
- 如果您的数据托管在欧洲,请使用以下url:
- 交付准备服务器
sftp7-stg.bazaarvoice.com
- 生产服务器
sftp7.bazaarvoice.com
- 交付准备服务器
第五步:检查提要状态
上传一个提要后暂存或生产SFTP服务器,可以查看提要的导入汇总(错误或警告计数)。
检查导入摘要可以帮助您在下次导入前纠正错误。
命令,查看导入摘要信息
- 登录https://portal.bazaarvoice.com登入Bazaarvoice传送门。
- 点击菜单位于左上角,可查看您的Bazaarvoice解决方案列表。
- 点击工作台在菜单上。工作台去哪里了?页面显示。
- 从下拉菜单中选择您的公司。提示:根据您的访问级别,选择登录到登台环境还是生产环境。
- 点击转到工作台.
- 选择设置»验证产品提要查看提要导入摘要。如果您的提要返回错误或警告,请单击它以显示更详细的信息。
步骤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的对话知识库,以获得以下示例提要和格式: