交互数据
即使您使用BV Pixel来支持评论请求,基于feed的方法也可以用于将评论请求发送到实体店购买交易期间收集的电子邮件地址。
手动发送交互数据
按照以下步骤手动发送交互数据:
步骤1:创建交互提要
步骤2:验证XML交互提要
步骤3:上传交互提要
步骤4:安排交互数据提要和审查请求
HTML示例代码
要获得更多的指导,请参考这些完整的HTML示例。
步骤1:创建交互提要
除了在线收集的交易数据外,您还可以在实体店的购买交易期间收集电子邮件地址。
您还可以为非事务审查请求收集审查请求交互数据提要。至少,非事务性交互提要必须包含预期审查请求收件人的电子邮件地址列表。
Bazaarvoice从在线互动中发送的数据(用于审核请求)必须以以下格式之一发送:
- XML文件(首选)
- 以制表符分隔的文本文件
指审查请求文件类型有关这两种格式的详细信息。
如果您打算每天发送多个提要,请为每个文件名添加一个唯一字符(以区分它们)。例如:
YourSiteName \ _InteractionData1 \ _20190928.xml
YourSiteName \ _InteractionData2 \ _20190928.xml
上传的每个以制表符分隔的文件必须有唯一的名称,以避免它覆盖前一个文件。我们接受您选择的任何命名约定,但建议包括您的网站名称和当前日期。例如:
YourSiteName \ _InteractionData \ _20190928.txt
YourSiteName \ _OrderData \ _20190928.xml
选项1:XML交互数据提要文件
基于XML的数据交互文件应该以根节点开始,然后是根节点XML模式.
提要中的每个事务都有自己的特点交互
元素。与事务相关的元数据显示为子元素,如TransactionDate
在适当的交易下。
下面的例子展示了一个简化的XML交互提要的一般结构,它显示了所有可能的元素:
<?xml version="1.0" encoding="UTF-8"?><饲料xmlns =“//www.busanline.com/xs/PRR/PostPurchaseFeed/14.7”>< >的交互< 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)必须与提要中用于任何特殊字符的方案相匹配。
- 如果没有特定字段的值,请从提要中省略该字段。不要将字段包含为空值。
选项2:以制表符分隔的交互提要文件
以制表符分隔的审查请求文本文件支持两种列:
- 交互-交互列出现在产品列之前,每个列只出现一次。
- 产品-产品列出现在交互列之后,可以重复出现(最多5个),以定义多个产品作为单个交互的一部分。必威手机版本
以下列为交互列:
- 交互的日期
- 语言环境
- 电子邮件地址
- 用户ID
- 用户名
以下列为产品列:
- 产品ID
- 产品名称
- 产品缩略图图片URL
- 产品价格
下面的示例显示了一个简化的以tab分隔的交互提要的一般结构,其中包含交互日期、电子邮件地址和用户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将忽略这些争吵。
事务性审查请求的数据字段
下表标识了事务性审查请求所需或推荐的字段:
场 | 审查请求的最佳实践? | 需要吗? | 描述 |
---|---|---|---|
TransactionDate |
是的 | 是的,如果使用发送延迟 | 购买、运输或其他交互日期。Bazaarvoice支持以下日期格式:
|
语言环境 (包括语言和国家信息) |
是的 | 是的,如果支持多种语言的审查请求 | 控制所使用的特定于语言的电子邮件模板,示例如下:
|
EmailAddress |
是的 | 是的 | 客户电子邮件地址。必须为有效格式。 |
用户标识 |
是的 | 没有 | 客户的用户ID,通常在在线交易期间创建。该值被编码到Bazaarvoice用户身份验证字符串(UAS)中。 交互数据提要中的用户ID必须与在评论提交过程中传递给Bazaarvoice的用户ID相匹配(作为评分和评论实现的一部分)。对于在结帐过程中未生成用户ID的购买记录,例如客户购买者,此字段可以为空。 如果相同的用户ID在同一个提要中出现多次,并且使用了不同的电子邮件地址,则用户ID将被设置为null,并将警告打印到日志文件中。 如果使用Bazaarvoice托管身份验证,该字段应被省略。 |
用户名 |
是的 | 是的,如果你想:
|
客户在在线帐户上创建的用户名或昵称。此字段可用于个性化电子邮件问候语。 |
以下字段适用于交互中的每个产品或服务。审查请求中列出的产品的最大数量是5个。必威手机版本
场 | 审查请求的最佳实践? | 需要吗? | 描述 |
---|---|---|---|
ExternalId (产品) |
是的 | 是的 | 必须与您的产品目录数据提要中发送到Bazaarvoice的项目的外部产品ID匹配。 |
ImageUrl (产品) |
是的 | 是的 如果不能为图像提供URL,则会显示可定制的“无可用图像”图形。 |
产品缩略图将显示在邮件模板中。始终提供完整的URL,包括“http://www”。如果没有提供,将从当前产品数据库中检索。 |
的名字 (产品) |
是的 | 是的 | 将在电子邮件模板中使用。如果没有提供,将从当前产品数据库中检索。在XML提要中,它将名称放在CDATA节中:<![CDATA [Your_Product_Name]] > 用等价的HTML实体号替换特殊字符(®= & # 174;) |
价格 |
是的 | 不,但是推荐 | 用于控制产品在给定电子邮件中出现的顺序(例如将价值最高的产品列在前面)必威手机版本。应该是没有货币符号的十进制数,例如,“20.99”,“40.00” |
非事务审查请求的数据字段
下表列出了非事务审查请求所需或推荐的字段:
场 | 审查请求的最佳实践? | 需要吗? | 描述 |
---|---|---|---|
TransactionDate |
是的 | 是的,如果使用发送延迟 | 购买、运输或其他交互日期。Bazaarvoice支持以下日期格式:
|
语言环境 (包括语言和国家信息) |
是的 | 是的,如果支持多种语言的审查请求 | 控制所使用的特定于语言的电子邮件模板,示例如下:
|
EmailAddress |
是的 | 是的 | 客户电子邮件地址。必须为有效格式。 |
用户标识 |
是的 | 没有 | 客户的用户ID,通常在在线交易期间创建。该值被编码到Bazaarvoice用户身份验证字符串(UAS)中。 交互数据提要中的用户ID必须与在评论提交过程中传递给Bazaarvoice的用户ID相匹配(作为评分和评论实现的一部分)。对于在结帐过程中未生成用户ID的购买记录,例如客户购买者,此字段可以为空。 如果相同的用户ID在同一个提要中出现多次,并且使用了不同的电子邮件地址,则用户ID将被设置为null,并将警告打印到日志文件中。 如果使用Bazaarvoice托管身份验证,该字段应被省略。 |
用户名 |
是的 | 不需要,除非你想:
|
客户在在线帐户上创建的用户名或昵称。此字段可用于个性化电子邮件问候语。 |
以下字段适用于希望在审查请求上列出的每个非事务事件。审查请求中列出的事件的最大数量是5个。
场 | 审查请求的最佳实践? | 需要吗? | 描述 |
---|---|---|---|
ExternalId (产品) |
是的 | 不,但是推荐 | 必须与您的产品目录数据提要中发送到Bazaarvoice的项目的外部产品ID匹配。 |
ImageUrl (产品) |
是的 | 不,但是推荐 | 产品缩略图将显示在邮件模板中。始终提供完整的URL,包括“http://www”。如果没有提供,将从当前产品数据库中检索。 |
的名字 (产品) |
是的 | 不,但是推荐 | 将在电子邮件模板中使用。如果没有提供,将从当前产品数据库中检索。在XML提要中,它将名称放在CDATA节中:<![CDATA [Your_Product_Name]] > 用等价的HTML实体号替换特殊字符(®= & # 174;) |
价格 |
是的 | 不,但是推荐 | 用于控制产品在给定电子邮件中出现的顺序(即将价值最高的产品列在前面)。必威手机版本应该是没有货币符号的十进制数,例如,“20.99”,“40.00” |
步骤2:验证XML交互提要
在将XML交互提要提交给Bazaarvoice之前,使用本地验证器(如XMLBeans)验证它们。
- 访问http://xmlbeans.apache.org/并安装XMLBeans。安装步骤因操作系统和平台而异。
- 将您试图验证的Bazaarvoice模式的一个副本保存到您的本地机器。方法中定义的站点
xmlns
并将输出保存为XSD
在本地机器上文件。 - 在本地计算机上,使用命令行调用XMLBeans来验证文件。
步骤3:上传交互提要
您将需要以下值将交互数据提要文件上传到Bazaarvoice SFTP位置。举例如下:
- 交付准备服务器。
sftp-stg.bazaarvoice.com
- 生产服务器,
sftp.bazaarvoice.com
- 安全用户名-
例子
- 安全的密码,
password123123123
- 目录-
ppe /收件箱
步骤4:安排交互数据提要和审查请求
您可以指定交互数据提要发送到Bazaarvoice的频率。我们建议您将提要安排为每天运行一次。
决定在交互后多久向客户发送审查请求以获得反馈。您可以在互动事件发生后的任何时间向Bazaarvoice发送互动数据,直到审核请求交付日期的24小时前。
调度时的最佳实践
Bazaarvoice推荐以下时间表:
- 在交互日期后21天内交付评审请求。
- 从交互之日起,延迟向Bazaarvoice发送数据馈送20天。
- 在将交互数据发送到Bazaarvoice之前,从交互数据提要中删除已取消和返回的项。Bazaarvoice为您的交互数据提要中的每一条记录发送一个审查请求。因此,如果您担心向取消或退回产品的客户发送审查请求,请从提要中删除这些项目。必威手机版本
下表列出了审查请求的默认调度选项。
选项 | 可能的值 | 推荐值(默认值) |
---|---|---|
交互频率-数据馈送到Bazaarvoice | 每日或每周 | 每天 |
交互事件和评审请求交付之间的天数 | 一到几天 | 21天 |
审查请求中列出的产品或服务的最大数量必威手机版本 | 1到n | 五种产品或必威手机版本服务 |
审查请求活动
审查请求活动可以通过使用以下基于提要的集成方法之一来实现:
- 选项1:白标签。全方位服务选项,Bazaarvoice与行业领先的电子邮件服务提供商(ESP)一起提供评论请求。注意:客户不需要与电子邮件服务提供商(ESP)联系。
选项2:合作伙伴集成。Bazaarvoice通过您现有的电子邮件集成触发审查请求。您的ESP可能需要额外的费用来实施合作伙伴集成的审查请求活动。
注意:联系Bazaarvoice客户服务参阅支持的ESP合作伙伴列表。
示例提要
为了帮助您实现,请参考对话知识库以获得以下示例提要和格式: