发送到Bazaarvoice用于审查请求的数据(以前是交互后电子邮件或PIE)被称为交互数据提要。此提要必须是以下文件格式之一:

  • 扩展名为.txt的以制表符分隔的文本文件
  • XML文件(首选格式)

每个上传的文件必须有一个唯一的名称，以避免它覆盖前一个文件。我们接受您选择的任何命名约定，但我们建议包括您的网站名称和当前日期，例如以下示例:

  • YourSiteName_InteractionData_20120928.txt
  • YourSiteName_OrderData_20120928.xml

如果您打算每天发送多个提要，请在文件名中添加一个唯一的字符。例如:

  • YourSiteName_InteractionData1_20120928.xml
  • YourSiteName_InteractionData2_20120928.xml

以制表符分隔的交互数据提要

以制表符分隔的审查请求文本文件支持两种列:

  • 交互．交互列出现在产品列之前，每个列只出现一次。
  • 产品．产品列出现在交互列之后，并且可以在重复的集合中出现(最多5个)，以将多个产品定义为单个交互的一部分。必威手机版本

以下列为“交互”列:

  • 交互的日期
  • 语言环境
  • 电子邮件地址
  • 用户ID
  • 用户名

以下列为“产品”列:

  • 产品ID
  • 产品名称
  • 产品缩略图图片URL
  • 产品价格

下面的示例显示了一个简化的以制表符分隔的交互提要的一般结构:

  • 交互的日期
  • 电子邮件地址
  • 用户ID“interaction”列
  • 不同数量的重复产品ID，产品缩略图URL
  • 产品名称“Product”列
日期邮箱userId productId imageUrl productName日期邮箱userId productId imageUrl productName productId imageUrl productName日期邮箱userId productId imageUrl productName日期邮箱userId productId imageUrl productName productId imageUrl productName productName

在创建以制表符分隔的交互提要时，请使用以下最佳实践:

  • 交互日期可以是任何可以通过Java的SimpleDateFormat类中定义的方法表示的格式。Bazaarvoice推荐以下格式:

    yyyy-MM-dd HH: mm: ss。瑞士

  • 提要可以利用标题行来表示列名;Bazaarvoice将忽略这些争吵。

基于xml的交互数据提要

的根节点开始， feed中的每个事务都有自己的特点交互元素。与事务相关的元数据显示为子元素，如TransactionDate在适当的交易下。

下面的例子展示了一个简化的XML交互提要的一般结构，它展示了所有可能的元素:

<？xml version="1.0" encoding="UTF-8"?><饲料xmlns =“//www.busanline.com/xs/PRR/PostPurchaseFeed/5.6”>< >的交互< TransactionDate >…< / TransactionDate >< EmailAddress >…< / EmailAddress ><用户名>…< /用户名><标识>…< / UserID ><地区>…< /地区><必威手机版本产品><产品>< ExternalId >…< / ExternalId ><名称>…< /名称>< ImageUrl >…< / ImageUrl ><价格>…> < /价格< /产品>> 必威手机版本< /产品> < /交互饲料> < /

在创建交互数据提要文件(XML交互提要)时，请使用以下最佳实践:

  • 交互日期必须符合XML dateTime格式。例如:

    2010 - 10 - 10 - t11:11:11.000

  • 确保提要的第一行遵循以下格式:

    <？XML版本="1.0"编码="utf-8"?>
  • 标准字符编码方案(如UTF-8或Windows-1252)必须与提要中用于任何特殊字符的方案相匹配。
  • 如果没有特定字段的值，请从提要中省略该字段。不要将字段包含为空值。

验证XML交互提要

在将XML交互提要提交给Bazaarvoice之前，可以使用XMLBeans等本地验证器验证XML交互提要。要做到这一点，请遵循以下步骤:

  1. 访问http://xmlbeans.apache.org/并安装XMLBeans。安装步骤可能因操作系统和平台而异。
  2. 将正在验证的Bazaarvoice模式的一份副本保存到本地机器。要做到这一点，请访问xmlns中定义的站点。例如://www.busanline.com/xs/PRR/PostPurchaseFeed/5.6并将输出保存为本地机器上的XSD文件。
  3. 使用命令行调用XMLBeans来验证文件。XMLBeans命令行工具的完整文档可以在这里找到:http://xmlbeans.apache.org/docs/2.0.0/guide/conValidationWithXmlBeans.html#command_line_validation

例子

svalidate模式。xsd localfile.xml