您可以以任何基于文本的格式自定义输出,包括XML或JSON。
输出格式可自定义,以支持在设计过程中做出的分面、排序和其他特定于实施的决策。 如有必要,您可以调整格式本身以简化客户前端的开发。
整个输出包含在<result>
标记中,而大多数动态数据都包含在<![CDATA[ ]]>
标记中。 这种组织允许结果包含HTML和其他非XML实体。
如果提供了指向其他页面的链接,则这些链接将以相对URL的形式显示。 此结果还包括传递的查询字符串参数,以生成所需结果。
当您开始“引导式搜索”实施时,请记住Adobe Search&Promote负责业务层。 即,围绕在任何给定时间向客户展示哪些结果和方面的逻辑。
当您实现分析结果并将结果显示为HTML的Web 应用程序前端时,将功能限制为仅显示。 换句话说,您用于创建表示层的任何服务器端逻辑不会决定向客户展示什么,除非有必要。 如果前端脚本正在更改搜索结果,则业务规则将无法按预期工作。
Adobe Search&Promote 通过URL参数保持所选搜索优化选项的用户状态。所有<link>
节点都包含客户选择的相关参数。 这些参数可以包括痕迹导航、分页、排序和彩块化选择。 如果适用,将返回<undolink>
节点以允许客户“退出”选择。 彩块化和痕迹导航可优惠这些类型的链接。
使用类似REST的API,您可以与它交互以执行搜索和接收结果。 最常用的结果格式是XML或JSON。
基本URI与特定帐户和暂存或实时环境关联。 您可以从帐户管理器请求基本URI的多个别名。 例如,名为Megacorp的虚构公司具有以下两个基本URL与其帐户关联:
https://search.megacorp.com
https://stage.megacorp.com
前一个URI针对其活动索引执行搜索,后一个URI针对其分阶段索引执行搜索。
搜索请求由基本URI和一组CGI参数或键值对组成,这些参数或键值对指示对与基本URI关联的帐户进行所需搜索。
支持三种格式的CGI参数。 默认情况下,您的帐户配置为使用分号(;
)分隔CGI参数,如下例所示:
https://search.megacorp.com?q=shoes ;page=2
如果您愿意,您可以让您的客户经理将您的帐户配置为使用&号(&
)来分隔CGI参数,如下例所示:
https://search.megacorp.com?q=shoes &page=2
还支持第三种格式,称为SEO格式,其中使用正斜杠(/
)代替分隔符并使用等号生成“clean”链接,如下例所示:
https://search.megacorp.com/q/shoes/page/2
每当使用SEO格式发送请求时,所有输出链接都以相同的格式返回。
下表描述了您可以使用的标准“现成”搜索查询参数。 可以基于用户定义的查询参数构建处理规则和业务规则,以实施与您的公司相关的自定义业务逻辑。 您可以与咨询团队合作,获取有关这些参数的文档。
搜索查询参数 |
示例 |
描述 |
---|---|---|
q |
q=字符串 |
指定搜索的查询字符串。 此参数映射到 sp_q 后端搜索参数。 |
q# |
q#=字符串 |
编号 q 和 x 的参数可完成分页或在给定字段内搜索。 q 参数将您在facet中搜索的词定义为相应的编号 x 参数。 例如,如果您有两个彩块化,它们分别命名为大小和颜色,则您可能会有以下内容: q1=small;x1=size;q2=red;x2=color 此参数映射到 sp_q_exact_# 后端搜索参数。 |
x# |
x#=字符串 |
编号 q 和 x 的参数可完成分页或在给定字段内搜索。 q 参数将您在facet中搜索的词定义为相应的编号 x 参数。 例如,如果您有两个彩块化,它们分别命名为大小和颜色,则您可能会有以下内容: q1=small;x1=size;q2=red;x2=color 此参数映射到 sp_x_# 后端搜索参数。 |
collection(集合) |
collection=字符串 |
指定要用于搜索的集合。 此参数映射到 sp_k 后端搜索参数。 |
count(计数) |
计数=数字 |
指定所显示结果的总计数。 默认值在设置 > 搜索 > 搜索中定义。 此参数映射到 sp_c 后端搜索参数。 |
page |
page= number |
指定返回的结果页。 |
排名 |
排名 |
指定用于静态排名的排名字段。 该字段必须是关联度大于0的“排名”类型字段。 此参数映射到 sp_sr 后端参数。 |
gs_store |
gs_store=字符串 |
指定要搜索的存储。 |
排序 |
排序=数字 |
指定排序顺序。 “0”是默认值,按相关性得分排序;“1”按日排序;“–1”不排序。 用户可以为 sp_s 参数的值指定字段名。 例如, sp_s=title 会根据标题字段中包含的值对结果进行排序。 当使用字段名称作为 sp_s 参数的值时,结果将按该字段排序,然后按相关性进行子排序。 要启用此功能,请执行以下操作:
|
以下是与系统集成的建议。
与搜索服务器通信。
您可以使用httpGET请求与Adobe Search&Promote Web服务器通信。 您的服务器生成这些请求或在客户端执行Ajax请求。
保存搜索历史记录。
Adobe Search&Promote 在http请求中传递整个状态时为无状态。
分析返回的结果。
建议使用基于SAX的XML分析器分析XML响应。 如果您正在生成Ajax请求,请配置Adobe Search&Promote以返回这些请求的JSON响应,以便更轻松地分析响应。
描述标准JSON响应输出的表。
另请参阅引导搜索JSON输出。
您可以查看以下JSON响应:
示例:
<banners>
<banner>
<area><![CDATA[top-left]]></area>
<content><![CDATA[<img src="https://www.megacorp.com/discount.gif"/>]]></content>
</banner>
</banners>
横幅中的标记 |
描述 |
---|---|
<banner> |
单个横幅节点。 您可以有多个横幅节点。 |
<area> |
网页上显示横幅的区域。 |
<content(内容)> |
横幅区域的HTML内容。 |
在以下示例中,每次客户通过facet进一步缩小范围时,所做的选择都会添加到痕迹导航中。 每个项目都表示为<breadcrumb-item>
。
示例:
<breadcrumb>
<breadcrumb-item>
<link><![CDATA[?q=new+year]]></link>
<value><![CDATA[new year]]></value>
</breadcrumb-item>
<breadcrumb-item>
<link><![CDATA[?q=new+year;q1=Articles;x1=content-type]]></link>
<value><![CDATA[Articles]]></value>
</breadcrumb-item>
</breadcrumb>
痕迹导航中的标记 |
描述 |
---|---|
<link> |
显示所需视图的搜索结果的相对链接。 单击痕迹导航链接可将客户带到视图,随后所有的细化都将被删除。 还提供其他选项。 |
<value> |
痕迹导航项的面向客户的文本。 |
彩块化是细化选项,让客户能够对结果进行筛选。 彩块化通常用于分类、价格范围、颜色选择和其他属性细化。 索引中的元数据是驱动器彩块化的原因。
客户在分类中向下移动时,通常会隐藏或显示分类彩块化。 最高级别的分类(类别)称为第1层。 当客户单击第1层选项时,将显示第2层(子类别)优化选项,而第1层选项将消失。 当客户单击第2层选项时,将显示第3层(子子类别)优化选项,而第2层选项将消失。 如上所述,这些选项是隐藏的并且显示的 — 您的Web应用程序不受这些选项的影响。
每个facet都包含在<facet-item>
标记中。 在以下示例中,它显示了一个允许客户按“假日”优化搜索结果的方面。
示例:
<facets>
<facet-item>
<facet-title><![CDATA[Holidays]]></facet-title>
<facet-value>
<label><![CDATA[New Year]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=New+Year;x1=content-type;x2=holidays]]></link>
<count><![CDATA[11]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Christmas]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=Christmas;x1=content-type;x2=holidays]]></link>
<count><![CDATA[7]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Chinese New Year]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=Chinese+New+Year;x1=content-type;x2=holidays]]></link>
<count><![CDATA[2]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Thanksgiving]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=Thanksgiving;x1=content-type;x2=holidays]]></link>
<count><![CDATA[2]]></count>
</facet-value>
<facet-value>
<label><![CDATA[4th of July]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=4th+of+July;x1=content-type;x2=holidays]]></link>
<count><![CDATA[1]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Father's Day]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=Father's+Day;x1=content-type;x2=holidays]]></link>
<count><![CDATA[1]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Hanukkah]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=Hanukkah;x1=content-type;x2=holidays]]></link>
<count><![CDATA[1]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Mother's Day]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=Mother's+Day;x1=content-type;x2=holidays]]></link>
<count><![CDATA[1]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Valentine's Day]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=Valentine's+Day;x1=content-type;x2=holidays]]></link>
<count><![CDATA[1]]></count>
</facet-value>
</facet-item>
<facet-item>
<facet-title><![CDATA[Seasons]]></facet-title>
<facet-value>
<label><![CDATA[Winter]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=Winter;x1=content-type;x2=seasons]]></link>
<count><![CDATA[20]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Summer]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=Summer;x1=content-type;x2=seasons]]></link>
<count><![CDATA[7]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Autumn]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=Autumn;x1=content-type;x2=seasons]]></link>
<count><![CDATA[4]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Spring]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=Spring;x1=content-type;x2=seasons]]></link>
<count><![CDATA[2]]></count>
</facet-value>
</facet-item>
</facets>
彩块化中的标记 |
描述 |
---|---|
<facet-title> |
facet的面向客户的标题。 |
<label> |
facet选项的面向客户的标签。 |
<link> |
相对链接,可使选项缩小。 |
<count(计数)> |
该精化结果集中的结果数。 |
<undolink> |
选择facet值后,节点将返回一个“撤消链接”,允许客户退出结果。 |
示例:
<result>
<query>
<user-query><![CDATA[new year]]></user-query>
<lower-results><![CDATA[1]]></lower-results>
<upper-results><![CDATA[16]]></upper-results>
<total-results><![CDATA[621]]></total-results>
</query>
这些标签一起使用时会显示如下消息:“‘新年’的621项中,显示结果1-16项。”
标题和查询中的标记 |
描述 |
---|---|
<user-query> |
随请求一起提交的关键字查询。 |
<lower-results> |
此页上第一个结果的项目编号。 |
<upper-results> |
此页上最后一个结果的项目编号。 |
<total-results> |
匹配用户查询的结果总数。 |
<custom-field> |
全局应用于搜索结果的可选字段。 |
示例:
<pagination>
<total-pages><39></total-pages>
<pages>
<page position="first"></page>
<page position="last">?i=1;page=39;q=new+year;q1=Articles;x1=content-type]]></page>
<page position="previous"></page>
<page position="next">?i=1;page=2;q=new+year;q1=Articles;x1=content-type]]></page>
<page position="1" selected="true">?i=1;q=new+year;q1=Articles;x1=content-type]]></page>
<page position="2">?i=1;page=2;q=new+year;q1=Articles;x1=content-type]]></page>
<page position="3">?i=1;page=3;q=new+year;q1=Articles;x1=content-type]]></page>
<page position="4">?i=1;page=4;q=new+year;q1=Articles;x1=content-type]]></page>
<page position="5">?i=1;page=5;q=new+year;q1=Articles;x1=content-type]]></page>
<page position="6">?i=1;page=6;q=new+year;q1=Articles;x1=content-type]]></page>
<page position="7">?i=1;page=7;q=new+year;q1=Articles;x1=content-type]]></page>
<page position="8">?i=1;page=8;q=new+year;q1=Articles;x1=content-type]]></page>
<page position="9">?i=1;page=9;q=new+year;q1=Articles;x1=content-type]]></page>
<page position="10">?i=1;page=10;q=new+year;q1=Articles;x1=content-type]]></page>
</pages>
</pagination>
分页中的标记 |
描述 |
---|---|
<total-pages> |
结果页总数,基于结果数除以每页结果数。 |
<page position="first"> |
包含指向结果集中第一页的相对链接,除非客户已查看第1页。 在这种情况下,它是空的。 |
<page position="last"> |
包含指向结果集中最后一页的相对链接,除非客户正在查看最后一页。 在这种情况下,它是空的。 |
<page position="previous"> |
包含指向结果集中上一页的相对链接,除非客户正在查看第1页;在这种情况下,它是空的。 |
<page position="next"> |
包含指向结果集中最后一页的相对链接,除非客户正在查看最后一页。 在这种情况下,它是空的。 |
<page position="x"> |
包含指向特定页码的相对链接。 显示十个连续的页码。 在第1页,是第1-10页。 在结果集(本例中为39页)末尾,将是第30-39页。 例如,在结果集的中心(第15页),它应该是第11-20页。 |
selected="true"> |
应用为当前选定页面的属性。 |
“最近搜索”是基于Cookie的功能,仅在您将Cookie信息中继到服务器时才有效。
示例:
<recent-searches>
<recent-search>
<search-term><![CDATA[shoes]]></search-term>
<link><![CDATA[?q=shoes]]></link>
</recent-search>
</recent-searches>
最近搜索中的标记 |
描述 |
---|---|
<recent-search> |
单个最近搜索节点。 您可以有多个最近搜索节点。 |
<search-term> |
客户之前搜索的词。 |
<link> |
指向上一搜索的链接。 |
结果集是JSON响应的可自定义区域。 每个索引在元数据的字段命名机制中都是唯一的。 每个结果都返回了常用字段,如标题、说明和URL。 但是,为索引中的页面定义的任何元数据都可以在每个结果节点中使用。 分类、价格、颜色和缩略图只是一些选项,您可以将它们应用于结果,从而生成更引人注目的搜索结果。
根据特定于您的实施的元数据自定义结果格式。 此处包含结果中显示的所有结果数据,包括缩略图图像URL。
此外,还可以在页面中配置多个结果区域,如“特色结果”,或单独的“产品”和“内容”结果部分。 在这些情况下,HTML中会提供多个结果区域,但facet仅与主结果集关联。
示例:
<results>
<result>
<index><![CDATA[1]]></index>
<result-title><![CDATA[New Year's Eve Slumber Party]]></result-title>
<url><![CDATA[https://mysite.com/parties/new-years-eve-slumber-party-705199/]]></url>
<meta-description><![CDATA[Fun New Year's celebration ideas for your kids]]></meta-description>
<category><![CDATA[parties]]></category>
<content-type><![CDATA[Articles]]></content-type>
<small-thumbnail-img><![CDATA[https://mysite.com/assets/cms/parties/new-years-eve-
slumber-party-parties-photo-80-FF1200SLEEPA18.jpg]]></small-thumbnail-img>
<large-thumbnail-img><![CDATA[https://mysite.com/assets/cms/parties/new-years-eve-
slumber-party-parties-photo-160-FF1200SLEEPA18.jpg]]></large-thumbnail-img>
<byline><![CDATA[Nancy Mades]]></byline>
<blurb><![CDATA[Fun New Year's celebration ideas for your kids]]></blurb>
</result>
<result>
<index><![CDATA[2]]></index>
<result-title><![CDATA[10 Holiday Traditions to Start This Year]]></result-title>
<url><![CDATA[https://mysite.com/parties/10-holiday-traditions-to-start-this-year-704781/]]></url>
<meta-description><![CDATA[Reader ideas to make Thanksgiving, Christmas, and New Year's even more magical]]></meta-description>
<category><![CDATA[parties]]></category>
<content-type><![CDATA[Articles]]></content-type>
<small-thumbnail-img><![CDATA[https://mysite.com/assets/cms/parties/10-holiday-
traditions-to-start-this-year-parties-photo-80-FF1107HOLIA01.jpg]]></small-thumbnail-img>
<large-thumbnail-img><![CDATA[https://mysite.com/assets/cms/parties/10-holiday-
traditions-to-start-this-year-parties-photo-160-FF1107HOLIA01.jpg]]></large-thumbnail-img>
<byline><![CDATA[Julie Taylor]]></byline>
<blurb><![CDATA[Reader ideas to make Thanksgiving, Christmas, and New Year's even more magical]]></blurb>
</result>
<result>
<index><![CDATA[3]]></index>
<result-title><![CDATA[A Perfect New Year's Eve]]></result-title>
<url><![CDATA[https://mysite.com/parties/a-perfect-new-years-eve-705258/]]></url>
<meta-description><![CDATA[You can turn New Year's into a celebration for the whole family.]]></meta-description>
<category><![CDATA[parties]]></category>
<content-type><![CDATA[Articles]]></content-type>
<byline><![CDATA[Teri Keough]]></byline>
<blurb><![CDATA[You can turn New Year's into a celebration for the whole family.]]></blurb>
</result>
<result>
<index><![CDATA[4]]></index>
<result-title><![CDATA[New Year's Fun and Games]]></result-title>
<url><![CDATA[https://mysite.com/parties/new-years-fun-and-games-705220/]]></url>
<meta-description><![CDATA[Craft, game and food ideas for a New Year's celebration with kids.]]></meta-description>
<category><![CDATA[parties]]></category>
<content-type><![CDATA[Articles]]></content-type>
<byline><![CDATA[Charlotte Meryman]]></byline>
<blurb><![CDATA[Craft, game and food ideas for a New Year's celebration with kids.]]></blurb>
</result>
<result>
<index><![CDATA[5]]></index>
<result-title><![CDATA[11 Great Ways to Start the New Year]]></result-title>
<url><![CDATA[https://mysite.com/parties/11-great-ways-to-start-the-new-year-705552/]]></url>
<meta-description><![CDATA[11 New Family Traditions to Start This Year from My Magazine]]></meta-description>
<category><![CDATA[parties]]></category>
<content-type><![CDATA[Articles]]></content-type>
<byline><![CDATA[Emily Block]]></byline>
<blurb><![CDATA[11 New Family Traditions to Start This Year from My Magazine]]></blurb>
</result>
<result>
<index><![CDATA[6]]></index>
<result-title><![CDATA[Celebrating Chinese New Year]]></result-title>
<url><![CDATA[https://mysite.com/parties/celebrating-chinese-new-year-705260/]]></url>
<meta-description><![CDATA[Crafts, food, and games to help you celebrate Chinese New Year.]]></meta-description>
<category><![CDATA[parties]]></category>
<content-type><![CDATA[Articles]]></content-type>
<blurb><![CDATA[Crafts, food, and games to help you celebrate Chinese New Year.]]></blurb>
</result>
<result>
<index><![CDATA[7]]></index>
<result-title><![CDATA[New Year's Eve, Family Style]]></result-title>
<url><![CDATA[https://mysite.com/holidays/new-years-eve-family-style-701283/]]></url>
<meta-description><![CDATA[Start a family New Year's Eve tradition by having an evening of kid-focused fun at home]]></meta-description>
<category><![CDATA[holidays]]></category>
<content-type><![CDATA[Articles]]></content-type>
<blurb><![CDATA[Start a family New Year's Eve tradition by having an evening of kid-focused fun at home]]></blurb>
</result>
<result>
<index><![CDATA[8]]></index>
<result-title><![CDATA[Chinese New Year Activities]]></result-title>
<url><![CDATA[https://mysite.com/crafts/chinese-new-year-activities-710345/]]></url>
<meta-description><![CDATA[Activities for celebrating Chinese New Year.]]></meta-description>
<category><![CDATA[crafts]]></category>
<content-type><![CDATA[Articles]]></content-type>
<blurb><![CDATA[Activities for celebrating Chinese New Year.]]></blurb>
</result>
<result>
<index><![CDATA[9]]></index>
<result-title><![CDATA[More Organized in the New Year]]></result-title>
<url><![CDATA[https://mysite.com/holidays/more-organized-in-the-new-year-701284/]]></url>
<meta-description><![CDATA[Tips for getting your household more organized--and getting the kids to help.]]></meta-description>
<category><![CDATA[holidays]]></category>
<content-type><![CDATA[Articles]]></content-type>
<blurb><![CDATA[Tips for getting your household more organized--and getting your kids to help out.]]></blurb>
</result>
<result>
<index><![CDATA[10]]></index>
<result-title><![CDATA[Checklists: Year-End Safety Checklist]]></result-title>
<url><![CDATA[https://mysite.com/holidays/checklists-year-end-safety-checklist-701352/]]></url>
<meta-description><![CDATA[Make sure that your home is safe with our year-end safety checklist!]]></meta-description>
<category><![CDATA[holidays]]></category>
<content-type><![CDATA[Articles]]></content-type>
<blurb><![CDATA[Make sure that your home is safe with our year-end safety checklist!]]></blurb>
</result>
</results>
</customer-result>
结果中的标记 |
描述 |
---|---|
<index> |
此结果集中结果的序列号。 在此示例中,每页显示十个结果,在结果的第2页上,第一个项的索引为11。 |
<result-title> |
此页面的面向客户的标题。 |
<url> |
此页面的URL。 它用于创建允许客户点击结果的超链接。 |
示例:
<search-form>
<include-tnt-mbox>1 </included-tnt-mbox>
<autocomplete>
<css><![CDATA[<!--link rel="stylesheet" type="te
xt/css"href="//content.atomz.com/sp000000a8/publish/autoc%20%20%20%20%20%20%20%20%20omplete_styles.css?sp_css_cache_ver=2&lang=zh-Hans" /-->]]>
</css>
<form-content><![CDATA[<div id="autocomplete"></div>]]>
</form-content>
<js><![CDATA[<script type="text/javascript"
src="//content.atomz.com/sp100491de/publish/autoc%20%20%20%20omplete_data.js?sp_js_cache_ver=3&lang=zh-Hans"></script>]]>
</js>
</autcomplete>
<hidden-parameters>
<parameter>
<name><![CDATA[store]]></name>
<value><![CDATA[mens]]></value>
</parameter>
</hidden-parameters>
</search-form>
搜索表单中的标记 |
描述 |
---|---|
<include-tnt-mbox> |
可选. 如果JSON中存在值1,则它表示您的帐户已链接到 Test&目标 ,并且至少有一个业务规则位于A:B测试中。 |
<autocomplete> |
可选. 使用自动完成时,此节点会显示在页面上,指示CSS和JavaScript以及表单中的内容存在。 除非某人更改了自动完成设置,否则这些字段通常不会更改。 在这种情况下,xxx_cache_ver字段会递增,以强制客户浏览器上缓存的内容失效。 |
<css> |
与自动完成关联的CSS。 建议您将此标记放在页面的高处以改进页面渲染。 |
<form-content> |
搜索自中所需的内容,以自动完成实用程序与正确的控件关联。 |
<js> |
自动完成所需的自定义JavaScript。 建议您将此标记放在页面中低位以改进页面渲染。 自动完成也需要YUI JavaScript。 |
<hidden-parameters> |
包含要包含在搜索表单中的所有隐藏参数(名称和值)。 |
以下示例显示了三选项排序菜单的数据。 该菜单允许客户按相关性、标题或评级进行排序。 当前选定的项目包含属性“selected=true”。 " 始终优惠相关选项,以允许客户返回到最初显示的默认搜索结果。
示例:
<sort>
<sort-item selected="true">
<label><![CDATA[Relevance]]></label>
<value><![CDATA[relevance]]></value>
<link><![CDATA[]]></link>
</sort-item>
<sort-item>
<label><![CDATA[Title]]></label>
<value><![CDATA[title]]></value>
<link><![CDATA[?q=new+year;q1=Articles;sort=title;x1=content-type]]></link>
</sort-item>
<sort-item>
<label><![CDATA[Rating]]></label>
<value><![CDATA[user-rating]]></value>
<link><![CDATA[?q=new+year;q1=Articles;sort=user-rating;x1=content-type]]></link>
</sort-item>
</sort>
“排序”菜单中的标记 |
描述 |
---|---|
<label> |
选项的面向客户的文本。 |
<value> |
表示此选项的"sort"查询字符串参数的值。 如果使用 <link> 值,则不需要此标记。 |
<link> |
对于未选择的选项, <link> 参数包含返回相同结果集的相对链接,该链接按新排序参数排序。 此字段对于当前选定的排序选项为空。 |
当结果很少或没有结果时,将返回建议。 此节点包含的术语会生成成功的查询,并可在“无结果”页面上显示。 此时还会返回链接,以便客户可以跳转到新查询。
示例:
<suggestions>
<suggestion-item>
<link><![CDATA[?q=video]]></link>
<word><![CDATA[video]]>
建议中的标记 |
描述 |
---|---|
<link> |
用于创建用于搜索建议词结果的超链接的相对链接。 |
<word> |
建议的术语。 |
示例:
<zones>
<zone>
<name><![CDATA[best-sellers]]></name>
<display><![CDATA[1]]></display>
</zone>
</zones>
区域中的标记 |
描述 |
---|---|
<zone> |
单个区域节点。 您可以有多个区域节点。 |
<name> |
区域的名称。 |
<display> |
1或0表示区域是否显示。 实际区域内容可以是网页或搜索结果中的静态区域,如最畅销商品或相关产品。 |
描述标准XML响应输出的表。
您可以查看以下XML响应:
示例:
<banners>
<banner>
<area><![CDATA[top-left]]></area>
<content><![CDATA[<img src="https://www.megacorp.com/discount.gif"/>]]></content>
</banner>
</banners>
横幅中的标记 |
描述 |
---|---|
<banner> |
单个横幅节点。 您可以有多个横幅节点。 |
<area> |
网页上显示横幅的区域。 |
<content(内容)> |
横幅区域的HTML内容。 |
在以下示例中,每次客户通过facet进一步缩小范围时,所做的选择都会添加到痕迹导航中。 每个项目都表示为<breadcrumb-item>
。
示例:
<breadcrumb>
<breadcrumb-item>
<link><![CDATA[?q=new+year]]></link>
<value><![CDATA[new year]]></value>
</breadcrumb-item>
<breadcrumb-item>
<link><![CDATA[?q=new+year;q1=Articles;x1=content-type]]></link>
<value><![CDATA[Articles]]></value>
</breadcrumb-item>
</breadcrumb>
痕迹导航中的标记 |
描述 |
---|---|
<link> |
显示所需视图的搜索结果的相对链接。 单击痕迹导航链接可将客户带到视图,随后所有的细化都将被删除。 还提供其他选项。 |
<value> |
痕迹导航项的面向客户的文本。 |
彩块化是细化选项,让客户能够对结果进行筛选。 彩块化通常用于分类、价格范围、颜色选择和其他属性细化。 索引中的元数据是驱动器彩块化的原因。
客户在分类中向下移动时,通常会隐藏或显示分类彩块化。 最高级别的分类(类别)称为第1层。 当客户单击第1层选项时,将显示第2层(子类别)优化选项,而第1层选项将消失。 当客户单击第2层选项时,将显示第3层(子子类别)优化选项,而第2层选项将消失。 如上所述,这些选项是隐藏的并且显示的 — 您的Web应用程序不受这些选项的影响。
每个facet都包含在<facet-item>
标记中。 在以下示例中,它显示了一个允许客户按“假日”优化搜索结果的方面。
示例:
<facets>
<facet-item>
<facet-title><![CDATA[Holidays]]></facet-title>
<facet-value>
<label><![CDATA[New Year]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=New+Year;x1=content-type;x2=holidays]]></link>
<count><![CDATA[11]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Christmas]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=Christmas;x1=content-type;x2=holidays]]></link>
<count><![CDATA[7]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Chinese New Year]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=Chinese+New+Year;x1=content-type;x2=holidays]]></link>
<count><![CDATA[2]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Thanksgiving]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=Thanksgiving;x1=content-type;x2=holidays]]></link>
<count><![CDATA[2]]></count>
</facet-value>
<facet-value>
<label><![CDATA[4th of July]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=4th+of+July;x1=content-type;x2=holidays]]></link>
<count><![CDATA[1]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Father's Day]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=Father's+Day;x1=content-type;x2=holidays]]></link>
<count><![CDATA[1]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Hanukkah]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=Hanukkah;x1=content-type;x2=holidays]]></link>
<count><![CDATA[1]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Mother's Day]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=Mother's+Day;x1=content-type;x2=holidays]]></link>
<count><![CDATA[1]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Valentine's Day]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=Valentine's+Day;x1=content-type;x2=holidays]]></link>
<count><![CDATA[1]]></count>
</facet-value>
</facet-item>
<facet-item>
<facet-title><![CDATA[Seasons]]></facet-title>
<facet-value>
<label><![CDATA[Winter]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=Winter;x1=content-type;x2=seasons]]></link>
<count><![CDATA[20]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Summer]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=Summer;x1=content-type;x2=seasons]]></link>
<count><![CDATA[7]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Autumn]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=Autumn;x1=content-type;x2=seasons]]></link>
<count><![CDATA[4]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Spring]]></label>
<link><![CDATA[?q=new+year;q1=Articles;q2=Spring;x1=content-type;x2=seasons]]></link>
<count><![CDATA[2]]></count>
</facet-value>
</facet-item>
</facets>
彩块化中的标记 |
描述 |
---|---|
<facet-title> |
facet的面向客户的标题。 |
<label> |
facet选项的面向客户的标签。 |
<link> |
相对链接,可使选项缩小。 |
<count(计数)> |
该精化结果集中的结果数。 |
<undolink> |
选择facet值后,节点将返回一个“撤消链接”,允许客户退出结果。 |
示例:
<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
<result>
<query>
<user-query><![CDATA[new year]]></user-query>
<lower-results><![CDATA[1]]></lower-results>
<upper-results><![CDATA[16]]></upper-results>
<total-results><![CDATA[621]]></total-results>
</query>
这些标签一起使用时会显示如下消息:“‘新年’的621项中,显示结果1-16项。”
标题和查询中的标记 |
描述 |
---|---|
<user-query> |
随请求一起提交的关键字查询。 |
<lower-results> |
此页上第一个结果的项目编号。 |
<upper-results> |
此页上最后一个结果的项目编号。 |
<total-results> |
匹配用户查询的结果总数。 |
<custom-field> |
全局应用于搜索结果的可选字段。 |
示例:
<pagination>
<total-pages><39></total-pages>
<pages>
<page position="first"></page>
<page position="last">?i=1;page=39;q=new+year;q1=Articles;x1=content-type]]></page>
<page position="previous"></page>
<page position="next">?i=1;page=2;q=new+year;q1=Articles;x1=content-type]]></page>
<page position="1" selected="true">?i=1;q=new+year;q1=Articles;x1=content-type]]></page>
<page position="2">?i=1;page=2;q=new+year;q1=Articles;x1=content-type]]></page>
<page position="3">?i=1;page=3;q=new+year;q1=Articles;x1=content-type]]></page>
<page position="4">?i=1;page=4;q=new+year;q1=Articles;x1=content-type]]></page>
<page position="5">?i=1;page=5;q=new+year;q1=Articles;x1=content-type]]></page>
<page position="6">?i=1;page=6;q=new+year;q1=Articles;x1=content-type]]></page>
<page position="7">?i=1;page=7;q=new+year;q1=Articles;x1=content-type]]></page>
<page position="8">?i=1;page=8;q=new+year;q1=Articles;x1=content-type]]></page>
<page position="9">?i=1;page=9;q=new+year;q1=Articles;x1=content-type]]></page>
<page position="10">?i=1;page=10;q=new+year;q1=Articles;x1=content-type]]></page>
</pages>
</pagination>
分页中的标记 |
描述 |
---|---|
<total-pages> |
结果页总数,基于结果数除以每页结果数。 |
<page position="first"> |
包含指向结果集中第一页的相对链接,除非客户已查看第1页。 在这种情况下,它是空的。 |
<page position="last"> |
包含指向结果集中最后一页的相对链接,除非客户正在查看最后一页。 在这种情况下,它是空的。 |
<page position="previous"> |
包含指向结果集中上一页的相对链接,除非客户正在查看第1页;在这种情况下,它是空的。 |
<page position="next"> |
包含指向结果集中最后一页的相对链接,除非客户正在查看最后一页。 在这种情况下,它是空的。 |
<page position="x"> |
包含指向特定页码的相对链接。 显示十个连续的页码。 在第1页,是第1-10页。 在结果集(本例中为39页)末尾,将是第30-39页。 例如,在结果集的中心(第15页),它应该是第11-20页。 |
selected="true"> |
应用为当前选定页面的属性。 |
“最近搜索”是基于Cookie的功能,仅在您将Cookie信息中继到服务器时才有效。
示例:
<recent-searches>
<recent-search>
<search-term><![CDATA[shoes]]></search-term>
<link><![CDATA[?q=shoes]]></link>
</recent-search>
</recent-searches>
最近搜索中的标记 |
描述 |
---|---|
<recent-search> |
单个最近搜索节点。 您可以有多个最近搜索节点。 |
<search-term> |
客户之前搜索的词。 |
<link> |
指向上一搜索的链接。 |
“结果”集是XML响应的可自定义区域。 每个索引在元数据的字段命名机制中都是唯一的。 每个结果都返回了常用字段,如标题、说明和URL。 但是,为索引中的页面定义的任何元数据都可以在每个结果节点中使用。 分类、价格、颜色和缩略图只是一些选项,您可以将它们应用于结果,从而生成更引人注目的搜索结果。
根据特定于您的实施的元数据自定义结果格式。 此处包含结果中显示的所有结果数据,包括缩略图图像URL。
此外,还可以在页面中配置多个结果区域,如“特色结果”,或单独的“产品”和“内容”结果部分。 在这些情况下,HTML中会提供多个结果区域,但facet仅与主结果集关联。
示例:
<results>
<result>
<index><![CDATA[1]]></index>
<result-title><![CDATA[New Year's Eve Slumber Party]]></result-title>
<url><![CDATA[https://mysite.com/parties/new-years-eve-slumber-party-705199/]]></url>
<meta-description><![CDATA[Fun New Year's celebration ideas for your kids]]></meta-description>
<category><![CDATA[parties]]></category>
<content-type><![CDATA[Articles]]></content-type>
<small-thumbnail-img><![CDATA[https://mysite.com/assets/cms/parties/new-years-eve-
slumber-party-parties-photo-80-FF1200SLEEPA18.jpg]]></small-thumbnail-img>
<large-thumbnail-img><![CDATA[https://mysite.com/assets/cms/parties/new-years-eve-
slumber-party-parties-photo-160-FF1200SLEEPA18.jpg]]></large-thumbnail-img>
<byline><![CDATA[Nancy Mades]]></byline>
<blurb><![CDATA[Fun New Year's celebration ideas for your kids]]></blurb>
</result>
<result>
<index><![CDATA[2]]></index>
<result-title><![CDATA[10 Holiday Traditions to Start This Year]]></result-title>
<url><![CDATA[https://mysite.com/parties/10-holiday-traditions-to-start-this-year-704781/]]></url>
<meta-description><![CDATA[Reader ideas to make Thanksgiving, Christmas, and New Year's even more magical]]></meta-description>
<category><![CDATA[parties]]></category>
<content-type><![CDATA[Articles]]></content-type>
<small-thumbnail-img><![CDATA[https://mysite.com/assets/cms/parties/10-holiday-
traditions-to-start-this-year-parties-photo-80-FF1107HOLIA01.jpg]]></small-thumbnail-img>
<large-thumbnail-img><![CDATA[https://mysite.com/assets/cms/parties/10-holiday-
traditions-to-start-this-year-parties-photo-160-FF1107HOLIA01.jpg]]></large-thumbnail-img>
<byline><![CDATA[Julie Taylor]]></byline>
<blurb><![CDATA[Reader ideas to make Thanksgiving, Christmas, and New Year's even more magical]]></blurb>
</result>
<result>
<index><![CDATA[3]]></index>
<result-title><![CDATA[A Perfect New Year's Eve]]></result-title>
<url><![CDATA[https://mysite.com/parties/a-perfect-new-years-eve-705258/]]></url>
<meta-description><![CDATA[You can turn New Year's into a celebration for the whole family.]]></meta-description>
<category><![CDATA[parties]]></category>
<content-type><![CDATA[Articles]]></content-type>
<byline><![CDATA[Teri Keough]]></byline>
<blurb><![CDATA[You can turn New Year's into a celebration for the whole family.]]></blurb>
</result>
<result>
<index><![CDATA[4]]></index>
<result-title><![CDATA[New Year's Fun and Games]]></result-title>
<url><![CDATA[https://mysite.com/parties/new-years-fun-and-games-705220/]]></url>
<meta-description><![CDATA[Craft, game and food ideas for a New Year's celebration with kids.]]></meta-description>
<category><![CDATA[parties]]></category>
<content-type><![CDATA[Articles]]></content-type>
<byline><![CDATA[Charlotte Meryman]]></byline>
<blurb><![CDATA[Craft, game and food ideas for a New Year's celebration with kids.]]></blurb>
</result>
<result>
<index><![CDATA[5]]></index>
<result-title><![CDATA[11 Great Ways to Start the New Year]]></result-title>
<url><![CDATA[https://mysite.com/parties/11-great-ways-to-start-the-new-year-705552/]]></url>
<meta-description><![CDATA[11 New Family Traditions to Start This Year from My Magazine]]></meta-description>
<category><![CDATA[parties]]></category>
<content-type><![CDATA[Articles]]></content-type>
<byline><![CDATA[Emily Block]]></byline>
<blurb><![CDATA[11 New Family Traditions to Start This Year from My Magazine]]></blurb>
</result>
<result>
<index><![CDATA[6]]></index>
<result-title><![CDATA[Celebrating Chinese New Year]]></result-title>
<url><![CDATA[https://mysite.com/parties/celebrating-chinese-new-year-705260/]]></url>
<meta-description><![CDATA[Crafts, food, and games to help you celebrate Chinese New Year.]]></meta-description>
<category><![CDATA[parties]]></category>
<content-type><![CDATA[Articles]]></content-type>
<blurb><![CDATA[Crafts, food, and games to help you celebrate Chinese New Year.]]></blurb>
</result>
<result>
<index><![CDATA[7]]></index>
<result-title><![CDATA[New Year's Eve, Family Style]]></result-title>
<url><![CDATA[https://mysite.com/holidays/new-years-eve-family-style-701283/]]></url>
<meta-description><![CDATA[Start a family New Year's Eve tradition by having an evening of kid-focused fun at home]]></meta-description>
<category><![CDATA[holidays]]></category>
<content-type><![CDATA[Articles]]></content-type>
<blurb><![CDATA[Start a family New Year's Eve tradition by having an evening of kid-focused fun at home]]></blurb>
</result>
<result>
<index><![CDATA[8]]></index>
<result-title><![CDATA[Chinese New Year Activities]]></result-title>
<url><![CDATA[https://mysite.com/crafts/chinese-new-year-activities-710345/]]></url>
<meta-description><![CDATA[Activities for celebrating Chinese New Year.]]></meta-description>
<category><![CDATA[crafts]]></category>
<content-type><![CDATA[Articles]]></content-type>
<blurb><![CDATA[Activities for celebrating Chinese New Year.]]></blurb>
</result>
<result>
<index><![CDATA[9]]></index>
<result-title><![CDATA[More Organized in the New Year]]></result-title>
<url><![CDATA[https://mysite.com/holidays/more-organized-in-the-new-year-701284/]]></url>
<meta-description><![CDATA[Tips for getting your household more organized--and getting the kids to help.]]></meta-description>
<category><![CDATA[holidays]]></category>
<content-type><![CDATA[Articles]]></content-type>
<blurb><![CDATA[Tips for getting your household more organized--and getting your kids to help out.]]></blurb>
</result>
<result>
<index><![CDATA[10]]></index>
<result-title><![CDATA[Checklists: Year-End Safety Checklist]]></result-title>
<url><![CDATA[https://mysite.com/holidays/checklists-year-end-safety-checklist-701352/]]></url>
<meta-description><![CDATA[Make sure that your home is safe with our year-end safety checklist!]]></meta-description>
<category><![CDATA[holidays]]></category>
<content-type><![CDATA[Articles]]></content-type>
<blurb><![CDATA[Make sure that your home is safe with our year-end safety checklist!]]></blurb>
</result>
</results>
</customer-result>
结果中的标记 |
描述 |
---|---|
<index> |
此结果集中结果的序列号。 在此示例中,每页显示十个结果,在结果的第2页上,第一个项的索引为11。 |
<result-title> |
此页面的面向客户的标题。 |
<url> |
此页面的URL。 它用于创建允许客户点击结果的超链接。 |
示例:
<search-form>
<include-tnt-mbox>1 </included-tnt-mbox>
<autocomplete>
<css><![CDATA[<!--link rel="stylesheet" type="te
xt/css"href="//content.atomz.com/sp000000a8/publish/autoc%20%20%20%20%20%20%20%20%20omplete_styles.css?sp_css_cache_ver=2&lang=zh-Hans" /-->]]>
</css>
<form-content><![CDATA[<div id="autocomplete"></div>]]>
</form-content>
<js><![CDATA[<script type="text/javascript"
src="//content.atomz.com/sp100491de/publish/autoc%20%20%20%20omplete_data.js?sp_js_cache_ver=3&lang=zh-Hans"></script>]]>
</js>
</autcomplete>
<hidden-parameters>
<parameter>
<name><![CDATA[store]]></name>
<value><![CDATA[mens]]></value>
</parameter>
</hidden-parameters>
</search-form>
搜索表单中的标记 |
描述 |
---|---|
<include-tnt-mbox> |
可选. 当XML中存在值1时,它表示您的帐户已链接到 Test&目标 ,并且至少有一个业务规则位于A:B测试中。 |
<autocomplete> |
可选. 使用自动完成时,此节点会显示在页面上,指示CSS和JavaScript以及表单中的内容存在。 除非某人更改了自动完成设置,否则这些字段通常不会更改。 在这种情况下,xxx_cache_ver字段会递增,以强制客户浏览器上缓存的内容失效。 |
<css> |
与自动完成关联的CSS。 建议您将此标记放在页面的高处以改进页面渲染。 |
<form-content> |
搜索自中所需的内容,以自动完成实用程序与正确的控件关联。 |
<js> |
自动完成所需的自定义JavaScript。 建议您将此标记放在页面中低位以改进页面渲染。 自动完成也需要YUI JavaScript。 |
<hidden-parameters> |
包含要包含在搜索表单中的所有隐藏参数(名称和值)。 |
以下示例显示了三选项排序菜单的数据。 该菜单允许客户按相关性、标题或评级进行排序。 当前选定的项目包含属性“selected=true”。 " 始终优惠相关选项,以允许客户返回到最初显示的默认搜索结果。
示例:
<sort>
<sort-item selected="true">
<label><![CDATA[Relevance]]></label>
<value><![CDATA[relevance]]></value>
<link><![CDATA[]]></link>
</sort-item>
<sort-item>
<label><![CDATA[Title]]></label>
<value><![CDATA[title]]></value>
<link><![CDATA[?q=new+year;q1=Articles;sort=title;x1=content-type]]></link>
</sort-item>
<sort-item>
<label><![CDATA[Rating]]></label>
<value><![CDATA[user-rating]]></value>
<link><![CDATA[?q=new+year;q1=Articles;sort=user-rating;x1=content-type]]></link>
</sort-item>
</sort>
“排序”菜单中的标记 |
描述 |
---|---|
<label> |
选项的面向客户的文本。 |
<value> |
表示此选项的"sort"查询字符串参数的值。 如果使用 <link> 值,则不需要此标记。 |
<link> |
对于未选择的选项, <link> 参数包含返回相同结果集的相对链接,该链接按新排序参数排序。 此字段对于当前选定的排序选项为空。 |
当结果很少或没有结果时,将返回建议。 此节点包含的术语会生成成功的查询,并可在“无结果”页面上显示。 此时还会返回链接,以便客户可以跳转到新查询。
示例:
<suggestions>
<suggestion-item>
<link><![CDATA[?q=video]]></link>
<word><![CDATA[video]]>
建议中的标记 |
描述 |
---|---|
<link> |
用于创建用于搜索建议词结果的超链接的相对链接。 |
<word> |
建议的术语。 |
示例:
<zones>
<zone>
<name><![CDATA[best-sellers]]></name>
<display><![CDATA[1]]></display>
</zone>
</zones>
区域中的标记 |
描述 |
---|---|
<zone> |
单个区域节点。 您可以有多个区域节点。 |
<name> |
区域的名称。 |
<display> |
1或0表示区域是否显示。 实际区域内容可以是网页或搜索结果中的静态区域,如最畅销商品或相关产品。 |
描述AEM(Adobe Experience Manager)标准XML响应输出的表。
另请参阅 . 向导式搜索XML输出
您可以查看以下XML响应:
网站搜索/促销可以管理客户的横幅,将横幅插入网页的各个部分。
示例横幅:
以下是放置在名为“top”的页面区域中的横幅的示例。
<banners>
<banner>
<area><![CDATA[top]]></area>
<content><![CDATA[<div style="color:#70A100">We have custom shipping</div>]]></content>
</banner>
</banners>
节点 |
父节点 |
描述 |
---|---|---|
横幅 |
客户成果 |
包含0-n个横幅节点,指示每个横幅区域以及插入该区域的内容。 |
横幅 |
横幅 |
单个横幅节点。 您可以有多个横幅节点。 |
面积 |
横幅 |
网页上显示横幅的区域。 |
content |
横幅 |
横幅内容。 |
支持多个痕迹导航。 您可以在Design > Navigation > Breadcrumbs中定义痕迹导航及其相应行为。 此外,您需要为定义的每个痕迹导航指定唯一的名称。 痕迹导航XML节点迭代所有定义的痕迹导航。 建议在搜索结果中只显示一个痕迹导航。
在以下示例中,每次客户通过facet进一步缩小范围时,所做的选择都会添加到痕迹导航中。 每个项目都表示为<breadcrumb-item>
。
痕迹导航节点示例:
<breadcrumbs>
<breadcrumb>
<name><![CDATA[default]]></name>
<breadcrumb-item>
<link><![CDATA[?i=1;q=mens;sp_cs=UTF-8;view=xml]]></link>
<value><![CDATA[mens]]></value>
<label><![CDATA[]]></label>
</breadcrumb-item>
<breadcrumb-item>
<link><![CDATA[?i=1;q=mens;q1=Channel;sp_cs=UTF-8;view=xml;x1=brand]]></link>
<value><![CDATA[Channel]]></value>
<label><![CDATA[brand]]></label>
</breadcrumb-item>
</breadcrumb>
</breadcrumbs>
节点 |
父节点 |
描述 |
---|---|---|
痕迹 |
客户成果 |
包含定义每个痕迹导航的0-n痕迹导航节点。 大多数客户只有一个痕迹导航。 |
痕迹 |
痕迹 |
包含定义痕迹导航定义的子节点。 |
name |
痕迹 |
痕迹导航的名称。 |
breadcrumb项目 |
痕迹导航中的单个项。 每个项目表示跟踪中的步骤,因为用户会缩小结果集的范围。 |
|
link |
breadcrumb项目 |
显示所需视图的搜索结果的相对链接。 单击痕迹导航链接可将客户带到视图,随后所有的细化都将被删除。 还提供了其他选项,如删除和删除。 |
value |
breadcrumb项目 |
痕迹导航项的面向客户的文本。 |
标签 |
breadcrumb项目 |
标签标签输出一个标签,用于描述已选择哪个facet来生成该痕迹导航项的痕迹导航值。 它仅用于向导式痕迹导航块的上下文。 对于查询术语步骤,此值为空。 |
自定义字段是具有全局上下文的变量的杂项集合。 它通常用于传递在搜索结果页面的元数据中设置的用于SEO的变量。
自定义字段节点示例:
<custom-fields>
<custom-field name="seo-search-title"><![CDATA[Geometrixx Search Results]]></custom-field>
<custom-field name="seo-search-keywords"><![CDATA[]]></custom-field>
</custom-fields>
节点 |
父节点 |
描述 |
---|---|---|
custom-fields |
客户成果 |
可以包含定义自定义字段的0-n子节点。 |
custom-field |
custom-fields |
可选. 包含由name属性指示的给定自定义字段的值。 |
彩块化是细化选项,让客户能够对结果进行筛选。 彩块化通常用于分类、价格范围、颜色选择和其他属性细化。 彩块化构建在索引中的元数据之上。
客户在分类中向下移动时,通常会隐藏或显示分类彩块化。 最高级别的分类(类别)称为第1层。 当客户单击第1层选项时,将显示第2层(子类别)优化选项,而第1层选项将消失。 当客户单击第2层选项时,将显示第3层(子子类别)优化选项,而第2层选项将消失。 如上所述,这些选项被隐藏和显示;您的web应用程序不会影响它们。
每个facet都包含在<facet-item>
标记中。 在以下示例中,它显示了一个允许客户按“假日”优化搜索结果的方面。
彩块示例:
<facets>
<facet>
<facet-title><![CDATA[Department]]></facet-title>
<behavior><![CDATA[sticky]]></behavior>
<selected>1</selected>
<undo-link><![CDATA[?i=1;lang=enus;q=*;q1=Armora+Jeans;sp_staged=1;view=xml;x1=brand]]></undo-link>
<facet-value>
<selected><![CDATA[true]]></selected>
<label><![CDATA[Mens]]></label>
<link><![CDATA[?i=1;lang=enus;q=*;q1=Armora+Jeans;q2=Mens;sp_staged=1;view=xml;x1=brand;x2=leveli]]></link>
<count><![CDATA[3]]></count>
<undolink><![CDATA[?i=1;lang=enus;q=*;q1=Armora+Jeans;sp_staged=1;view=xml;x1=brand]]></undolink>
</facet-value>
</facet>
<facet>
<facet-title><![CDATA[Sub-Category]]></facet-title>
<behavior><![CDATA[sticky]]></behavior>
<selected>0</selected>
<facet-value>
<label><![CDATA[Apparel]]></label>
<link><![CDATA[?i=1;lang=enus;q=*;q1=Mens;q2=Armora+Jeans;q3=Apparel;sp_staged=1;view=xml;x1=leveli;x2=brand;x3=levelii]]></link>
<count><![CDATA[3]]></count>
</facet-value>
</facet>
<facet>
<facet-title><![CDATA[Brand]]></facet-title>
<behavior><![CDATA[multi-select]]></behavior>
<selected>1</selected>
<undo-link><![CDATA[?i=1;lang=enus;q=*;q1=Mens;sp_staged=1;view=xml;x1=leveli]]></undo-link>
<facet-value>
<label><![CDATA[Amoura]]></label>
<link><![CDATA[?i=1;lang=enus;q=*;q1=Mens;q2=Armora+Jeans|Amoura;sp_staged=1;view=xml;x1=leveli;x2=brand]]></link>
<count><![CDATA[9]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Armora]]></label>
<link><![CDATA[?i=1;lang=enus;q=*;q1=Mens;q2=Armora+Jeans|Armora;sp_staged=1;view=xml;x1=leveli;x2=brand]]></link>
<count><![CDATA[12]]></count>
</facet-value>
<facet-value>
<selected><![CDATA[true]]></selected>
<label><![CDATA[Armora Jeans]]></label>
<link><![CDATA[?i=1;lang=enus;q=*;q1=Mens;q2=Armora+Jeans|Armora+Jeans;sp_staged=1;view=xml;x1=leveli;x2=brand]]></link>
<count><![CDATA[3]]></count>
<undolink><![CDATA[?i=1;lang=enus;q=*;q1=Mens;sp_staged=1;view=xml;x1=leveli]]></undolink>
</facet-value>
<facet-value>
<label><![CDATA[Art of Grooming]]></label>
<link><![CDATA[?i=1;lang=enus;q=*;q1=Mens;q2=Armora+Jeans|Art+of+Grooming;sp_staged=1;view=xml;x1=leveli;x2=brand]]></link>
<count><![CDATA[4]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Bear Co.]]></label>
<link><![CDATA[?i=1;lang=enus;q=*;q1=Mens;q2=Armora+Jeans|Bear+Co.;sp_staged=1;view=xml;x1=leveli;x2=brand]]></link>
<count><![CDATA[1]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Citizens]]></label>
<link><![CDATA[?i=1;lang=enus;q=*;q1=Mens;q2=Armora+Jeans|Citizens;sp_staged=1;view=xml;x1=leveli;x2=brand]]></link>
<count><![CDATA[4]]></count>
</facet-value>
<facet-value>
<label><![CDATA[D&B]]></label>
<link><![CDATA[?i=1;lang=enus;q=*;q1=Mens;q2=Armora+Jeans|D%26B;sp_staged=1;view=xml;x1=leveli;x2=brand]]></link>
<count><![CDATA[17]]></count>
</facet-value>
<facet-value>
<label><![CDATA[David Yuri]]></label>
<link><![CDATA[?i=1;lang=enus;q=*;q1=Mens;q2=Armora+Jeans|David+Yuri;sp_staged=1;view=xml;x1=leveli;x2=brand]]></link>
<count><![CDATA[2]]></count>
</facet-value>
</facet>
</facets>
节点 |
父节点 |
描述 |
---|---|---|
facet |
客户成果 |
容器facet节点,具有0-n个子节点,表示每个facet。 |
fact |
facet |
单个facet实例。 |
facet-title |
fact |
facet的面向客户的标题。 |
行为 |
fact |
Facet的行为。 例如,普通、粘滞或多选。 |
selected |
fact |
1,否则为0。 |
还原链接 |
fact |
仅当选择了小平面时显示。 撤消链接会还原整个彩块化。 例如,当它是多选facet时,它会取消选择该facet的所有选项。 |
facet-value |
fact |
包含属于该facet的所有单个facet项。 |
选定 |
facet-value |
如果选择了具有facet的当前项,则此节点存在并设置为“true”。 |
标签 |
facet-value |
facet选项的面向客户的标签。 默认情况下,这应已由HTML转义。 |
链接 |
facet-value |
相对链接,以便选项进一步细化。 |
count(计数) |
facet-value |
该精化结果集中的结果数。 |
还原链接 |
facet-value |
选择facet值后,节点将返回“撤消链接”,允许客户退出选择单个facet选择。 |
示例:
xml version="1.0" encoding="utf-8" standalone="yes"
支持用于对结果进行排序的菜单,以及更改每页返回的结果数。 它还支持一个导航菜单,该菜单对于使用“搜索为导航”很有用。 帐户可以定义同一类型的多个菜单,并使用其中的任意菜单进行演示。
“示例菜单”节点:
以下示例显示了三选项排序菜单和导航菜单的数据。 通过“排序”菜单,客户可以按相关性、标题或评级进行排序。 当前选定的项目包含属性“selected=true”。 " 始终优惠相关选项,以允许客户返回到最初显示的默认搜索结果。
<menus>
<menu>
<name><![CDATA[sort]]></name>
<item selected="true">
<label><![CDATA[Relevance]]></label>
<value><![CDATA[relevance]]></value>
<link><![CDATA[ ]]></link>
</item>
<item>
<label><![CDATA[Lowest Price]]></label>
<value><![CDATA[Price]]></value>
<link><![CDATA[?i=1;q=mens;sort=Price;sp_cs=UTF-8;sp_staged=1;view=xml]]></link>
</item>
<item>
<label><![CDATA[Highest Price]]></label>
<value><![CDATA[Price_r]]></value>
<link><![CDATA[?i=1;q=mens;sort=Price_r;sp_cs=UTF-8;sp_staged=1;view=xml]]></link>
</item>
<item>
<label><![CDATA[Brand]]></label>
<value><![CDATA[brand]]></value>
<link><![CDATA[?i=1;q=mens;sort=brand;sp_cs=UTF-8;sp_staged=1;view=xml]]></link>
</item>
</menu>
<menu>
<name><![CDATA[ss_head_nav]]></name>
<item>
<label><![CDATA[WOMEN'S]]></label>
<value><![CDATA[?q1=Womens;sp_sfvl_field=levelii|leveli|brand|leveliii;x=0;x1=leveli;y=0;view=nav;top=1]]></value>
<link><![CDATA[?q1=Womens;sp_sfvl_field=levelii|leveli|brand|leveliii;x=0;x1=leveli;y=0;view=nav;top=1;i=1;m_ss_head_nav=WOMEN'S]]></link>
</item>
<item>
<label><![CDATA[MEN'S]]></label>
<value><![CDATA[/q1/Mens/x1/leveli/view/nav/top/1/]]></value>
<link><![CDATA[/q1/Mens/x1/leveli/view/nav/top/1/]]></link>
</item>
<item>
<label><![CDATA[JEWELRY & ACCESSORIES]]></label>
<value><![CDATA[?q1=Jewelry+%26+Accessories&sp_sfvl_field=levelii|leveli|brand|leveliii&x1=leveli&view=nav&top=1]]></value>
<link><![CDATA[?q1=Jewelry+%26+Accessories&sp_sfvl_field=levelii|leveli|brand|leveliii&x1=leveli&view=nav&top=1;i=1;m_ss_head_nav=JEWELRY+%26+ACCESSORIES]]></link>
</item>
<item>
<label><![CDATA[BEAUTY & FRAGRANCE]]></label>
<value><![CDATA[?q1=Beauty+%26+Fragrance;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1]]></value>
<link><![CDATA[?q1=Beauty+%26+Fragrance;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1;i=1;m_ss_head_nav=BEAUTY+%26+FRAGRANCE]]></link>
</item>
<item>
<label><![CDATA[GIFTS & HOME]]></label>
<value><![CDATA[?q1=Gifts+%26+Home;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1]]></value>
<link><![CDATA[?q1=Gifts+%26+Home;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1;i=1;m_ss_head_nav=GIFTS+%26+HOME]]></link>
</item>
<item>
<label><![CDATA[CHILDREN & TOYS]]></label>
<value><![CDATA[?q1=Children+%26+Toys;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1]]></value>
<link><![CDATA[?q1=Children+%26+Toys;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1;i=1;m_ss_head_nav=CHILDREN+%26+TOYS]]></link>
</item>
<item>
<label><![CDATA[ELECTRONICS]]></label>
<value><![CDATA[?q1=Electronics+%26+Toys;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1]]></value>
<link><![CDATA[?q1=Electronics+%26+Toys;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1;i=1;m_ss_head_nav=ELECTRONICS]]></link>
</item>
</menu>
</menus>
节点 |
父节点 |
描述 |
---|---|---|
菜单 |
客户成果 |
包含定义每个菜单的0-n个子节点。 |
菜单 |
菜单 |
菜单的单个实例(对应于在设计 > 导航 > 菜单中定义的菜单)。 |
名称 |
菜单 |
菜单的名称。 |
项目 |
菜单 |
定义菜单中的每个项。 如果当前选择了给定的菜单项,则选定的可选属性将设置为true。 |
标签 |
项目 |
菜单项的面向客户的文本。 |
值 |
项目 |
表示菜单项的值(也设置菜单的查询参数值)。 如果使用<link>值,则不需要此标记。 |
链接 |
项目 |
对于未选择的选项,<link>参数包含返回相同结果集但应用了菜单选项的相对链接。 此字段对于当前选定的排序选项为空。 |
结果集将拆分到多个页面。 通常,客户在单个页面上显示10 - 20个结果。 后续结果将显示在下一页。 分页XML允许您构建一组导航链接,以便客户可以逐页浏览结果集。 有四个可用的导航链接:first、last、next和previous。 每种类型的链接都可让客户快速浏览页面,以便轻松地审阅和优化所需内容。
以下示例显示了在第一页上搜索的分页,其中将分页配置为显示指向五个页面的链接。
分页示例:
<pagination>
<total-pages><![CDATA[112]]></total-pages>
<pages>
<page position="first"><![CDATA[]]></page>
<page position="last"><![CDATA[?i=1;page=112;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page>
<page position="next"><![CDATA[?i=1;page=2;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page>
<page position="1" selected="true"><![CDATA[?i=1;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page>
<page position="2"><![CDATA[?i=1;page=2;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page>
<page position="3"><![CDATA[?i=1;page=3;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page>
<page position="4"><![CDATA[?i=1;page=4;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page>
<page position="5"><![CDATA[?i=1;page=5;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page>
</pages>
</pagination>
节点 |
父节点 |
描述 |
---|---|---|
分页 |
客户成果 |
结果页总数,基于结果数除以每页结果数。 |
总页数 |
分页 |
将搜索结果分布到的页面总数。 |
页面 |
分页 |
包含0-n个页面节点,用于定义分页中的每个页面。 |
page |
页面 |
存在四个特殊页面节点:第一个、最后一个、上一个和下一个。 这四个页面是可选的,仅在有意义时才显示在结果集中。 例如,如果您位于第1页,则不存在“上一个”链接。 所有其他页面都指示一个位置。 列出的页数取决于在分页用户界面中配置的“页面链接数”。 “选定”属性指示客户当前所在的页面。 |
示例查询节点:
<query>
<user-query><![CDATA[mens]]></user-query>
<lower-results><![CDATA[1]]></lower-results>
<upper-results><![CDATA[12]]></upper-results>
<total-results><![CDATA[265]]></total-results>
</query>
节点 |
父节点 |
描述 |
---|---|---|
query |
客户成果 |
提供查询概述的全局节点。 |
用户查询 |
查询 |
搜索的关键字。 如果“是否是You Mean ”由于原始词未产生结果而自动搜索建议词,则会反映在搜索的新关键词中(请参阅建议节点以获取原始关键词)。 |
低结果 |
查询 |
此页上第一个结果的项目编号。 |
上结果 |
查询 |
此页上最后一个结果的项目编号。 |
总结果 |
查询 |
匹配用户查询的结果总数。 |
“最近搜索”是基于Cookie的功能,仅当您将Cookie信息中继至网站搜索/促销服务器时才有效。
最近搜索的示例:
<recent-searches>
<clear-link><![?q=womens&gscr=clear]]></clear-link>
<recent-search>
<link><![?q=mens]]></link>
<label><![CDATA[mens]]></label>
<recent-search>
</recent-searches>
节点 |
父节点 |
描述 |
---|---|---|
最近搜索 |
客户成果 |
仅当搜索有最近搜索时,节点才存在。 |
清除链接 |
最近搜索 |
清除所有客户最近搜索的相对路径。 |
最近搜索 |
最近搜索 |
定义最近搜索。 |
链接 |
最近搜索 |
创建链接的路径,该链接执行用户最近执行的搜索。 |
标签 |
最近搜索 |
最近搜索的面向客户的显示标签。 |
“结果”集是XML响应的可自定义区域。 每个索引在元数据的字段命名机制中都是唯一的。 每个结果都返回了常用字段,如标题、说明和URL。 但是,为索引中的页面定义的任何元数据都可以在每个结果节点中使用。 分类、价格、颜色和缩略图只是一些选项,您可以将它们应用于结果,从而生成更引人注目的搜索结果。
根据特定于您的实施的元数据自定义结果格式。 此处包含结果中显示的所有结果数据,包括缩略图图像URL。
此外,还可以在页面中配置多个结果区域,如“特色结果”,或单独的“产品”和“内容”结果部分。 在这些情况下,HTML中会提供多个结果区域,但facet仅与主结果集关联。
示例结果节点:
<results>
<result-set>
<name><![CDATA[default]]></name>
<result>
<field name="index"><![CDATA[1]]></field>
<field name="sku"><![CDATA[200190]]></field>
<field name="pagename"><![CDATA[Relaxed Paint Splattered]]></field>
<field name="img_sm_url"><![CDATA[https://geometrixx.com/images/08_geometrixx_icon_men.jpg]]></field>
<field name="brand"><![CDATA[Armora Jeans]]></field>
<field name="price"><![CDATA[195]]></field>
<field name="foundIn"><![CDATA[Mens,
Apparel,
Denim]]></field>
</result>
<result>
<field name="index"><![CDATA[2]]></field>
<field name="sku"><![CDATA[200195]]></field>
<field name="pagename"><![CDATA[Tumbled Jeans]]></field>
<field name="img_sm_url"><![CDATA[https://geometrixx.com/images/08_geometrixx_icon_men.jpg]]></field>
<field name="brand"><![CDATA[Armora Jeans]]></field>
<field name="price"><![CDATA[235]]></field>
<field name="foundIn"><![CDATA[Mens,
Apparel,
Denim]]></field>
</result>
<result>
<field name="index"><![CDATA[3]]></field>
<field name="sku"><![CDATA[200196]]></field>
<field name="pagename"><![CDATA[Montana Relaxed]]></field>
<field name="img_sm_url"><![CDATA[https://geometrixx.com/images/08_geometrixx_icon_men.jpg]]></field>
<field name="brand"><![CDATA[Armora Jeans]]></field>
<field name="price"><![CDATA[220]]></field>
<field name="foundIn"><![CDATA[Mens,
Apparel,
Denim]]></field>
</result>
</result-set>
</results>
节点 |
父节点 |
描述 |
---|---|---|
结果 |
客户成果 |
0-n个结果集的容器节点。 零结果集意味着您处于特殊的无结果登陆页。 |
结果集 |
结果 |
传入的搜索可触发多个搜索。 每个结果集都包含执行的特定命名搜索的结果。 |
名称 |
结果集 |
结果集所属的搜索的名称。 |
结果 |
结果集 |
包含与结果集的单个结果关联的所有字段。 |
字段 |
结果 |
name属性定义所显示索引中字段的名称。 该值是该字段的实际值。 某些结果可能缺少与单个结果无关的字段。 |
搜索表单包含在结果集中,让客户动态地构建其搜索表单。 此步骤是可选的。 大多数客户都有固定的搜索表单。 但是,它确实允许客户根据至少一个执行A:B测试的业务规则来确定搜索表单是否需要Test&目标 mbox。 同样,它允许客户自动获取最新的自动完成CSS和JavaScript。
搜索表单XML的示例:
<search-form>
<include-tnt-mbox>1</include-tnt-mbox>
<autocomplete>
<enabled>1</enabled>
<css><![CDATA[<link rel="stylesheet" type="text/css" href="https://content.t1.atomz.com/sp10043554/stage/autocomplete_styles.css?sp_js_param=2" />
]]></css>
<form-content><![CDATA[<div id="autocomplete"></div>
<input type="hidden" name="sp_staged" id="sp_staged" value="1" />
]]></form-content>
<javascript><![CDATA[<script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/yui/2.6.0/build/utilities/utilities.js"></script>
<script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/yui/2.6.0/build/datasource/datasource-min.js"></script>
<script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/yui/2.6.0/build/autocomplete/autocomplete-min.js"></script>
<script type="text/javascript" src="https://content.t1.atomz.com/sp10043554/stage/autocomplete_data.js?sp_js_param=3"></script>]]></javascript>
</autocomplete>
</search-form>
节点 |
父节点 |
描述 |
---|---|---|
搜索表单 |
客户成果 |
包含用于驱动搜索表单的数据。 |
include-tnt-mbox |
搜索表单 |
从技术上讲,只有在至少有一个执行Test&目标 A:B测试的业务规则时,您才需要在搜索表单中使用mbox。 此节点指示您是否需要mbox,或是否允许您减少Test&目标服务器上的点击次数。 |
自动完成 |
搜索表单 |
容纳与自动完成相关的子节点。 |
已启用 |
自动完成 |
当搜索帐户使用自动完成时,设置为1。 |
css |
自动完成 |
CSS实现自动完成。 将此节点放在页面上。 |
表单内容 |
自动完成 |
插入到搜索表单中的内容。 |
javascript |
自动完成 |
JavaScript实现自动完成。 将此节点放在页面上尽可能低。 |
客户可以通过以下三种方式配置Did You Mean功能:由于没有结果而提出建议,在没有结果时自动搜索第一个建议,或由于结果低而提出建议(如果建议的结果数较高)。 所有建议都会产生结果。
此建议节点包含的术语会生成成功的查询。 此时还会返回链接,以便客户可以跳转到新查询。
由于0个结果而建议的输出示例:
<suggestions>
<auto-searched>0</auto-searched>
<suggestions-low-results>0</suggestions-low-results>
<suggestion-item>
<link><![CDATA[?i=1;q=arcade;sp_cs=UTF-8;view=xml]]></link>
<word><![CDATA[arcade]]></word>
</suggestion-item>
</suggestions>
根据建议自动搜索的输出示例:
<suggestions>
<auto-searched>1</auto-searched>
<orig-query><![CDATA[arcace]]></orig-query>
<suggestions-low-results>0</suggestions-low-results>
</suggestions>
由于结果低而建议的输出示例:
<suggestions>
<auto-searched>0</auto-searched>
<suggestions-low-results>1</suggestions-low-results>
<suggestion-item>
<link><![CDATA[?i=1;q=coffee;sp_cs=UTF-8;view=xml]]></link>
<word><![CDATA[coffee]]></word>
</suggestion-item>
</suggestions>
节点 |
父节点 |
描述 |
---|---|---|
建议 |
客户成果 |
包含定义建议的子节点(如果存在)。 |
自动搜索 |
建议 |
如果存在,则指示网站搜索/促销是否因没有结果而自动搜索新词。 |
原始查询 |
建议 |
当站点搜索/促销自动根据第一建议搜索时,查询节点中的用户查询显示所搜索的关键字。 此节点显示原始查询词。 将二者结合起来,让客户可以创建“搜索游戏机而不是游戏机”等结构。 |
建议 — 低结果 |
建议 |
如果存在,则指示网站搜索/促销是否正在提出建议,因为当前搜索词产生的结果较低,而建议产生的结果要高得多。 可在中配置这两个阈值。 |
建议项 |
建议 |
包含0-n个节点,表示各种建议。 |
链接 |
建议项 |
包含用于创建指向建议术语的链接的路径。 |
词 |
建议项 |
包含建议的字。 |
支持根据结果切换客户搜索体验的功能。 部分操作涉及在具有不同搜索结果布局的不同模板之间进行切换。 例如,您可能有一个模板,其中含有大量产品时的产品网格视图。 或者,在显示包含更多详细信息的单个结果时,您可能有一个“聚焦”模板。 当搜索不产生任何结果时,您也可能有“无结果”模板。 模板节点指示用于显示搜索结果的模板。
示例模板:
<template><![CDATA[grid]]></template>
节点 |
父节点 |
描述 |
---|---|---|
模板 |
客户成果 |
指示用于显示搜索结果的模板的名称。 |
区域是可通过业务规则打开或关闭的页面部分。 区域可以包含任何内容,包括(但不限于)彩块化、搜索、痕迹导航和静态内容。 客户网页上的区域应与网站搜索/促销相同。
区域节点示例:
<zones>
<zone>
<name><![CDATA[brand-facet]]></name>
<display>1</display>
</zone>
</zones>
节点 |
父节点 |
描述 |
---|---|---|
区域 |
客户成果 |
包含0-n个区域。 |
区域 |
区域 |
单个区域节点。 您可以有多个区域节点。 |
名称 |
区域 |
区域的名称。 |
显示 |
1或0,指示显示还是隐藏与区域名称对应的区域。 |
|
*搜索在虚构网站(称为“Geometrixx”)上的示例输出以及用于生成示例输出的示例演示模板。
*搜索在虚构网站(称为Geometrixx)上的输出示例。
<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
<customer-results>
<query>
<user-query><![CDATA[*]]></user-query>
<lower-results><![CDATA[1]]></lower-results>
<upper-results><![CDATA[12]]></upper-results>
<total-results><![CDATA[1337]]></total-results>
</query>
<custom-fields>
<custom-field name="seo-search-title"><![CDATA[Geometrixx Search Results]]></custom-field>
<custom-field name="seo-search-keywords"><![CDATA[]]></custom-field>
</custom-fields>
<menus>
<menu>
<name>sort</name>
<item selected="true">
<label><![CDATA[Relevance]]></label>
<value><![CDATA[relevance]]></value>
<link><![CDATA[ ]]></link>
</item>
<item>
<label><![CDATA[Lowest Price]]></label>
<value><![CDATA[Price]]></value>
<link><![CDATA[?i=1;q=*;sort=Price;sp_cs=UTF-8;sp_staged=1;view=xml]]></link>
</item>
<item>
<label><![CDATA[Highest Price]]></label>
<value><![CDATA[Price_r]]></value>
<link><![CDATA[?i=1;q=*;sort=Price_r;sp_cs=UTF-8;sp_staged=1;view=xml]]></link>
</item>
<item>
<label><![CDATA[Brand]]></label>
<value><![CDATA[brand]]></value>
<link><![CDATA[?i=1;q=*;sort=brand;sp_cs=UTF-8;sp_staged=1;view=xml]]></link>
</item>
</menu>
<menu>
<name><![CDATA[ss_head_nav]]></name>
<label><![CDATA[WOMEN'S]]></label>
<value><![CDATA[?q1=Womens;sp_sfvl_field=levelii|leveli|brand|leveliii;x=0;x1=leveli;y=0;view=nav;top=1]]></value>
<link><![CDATA[?q1=Womens;sp_sfvl_field=levelii|leveli|brand|leveliii;x=0;x1=leveli;y=0;view=nav;top=1;i=1;m_ss_head_nav=WOMEN'S]]></link>
<label><![CDATA[MEN'S]]></label>
<value><![CDATA[/q1/Mens/x1/leveli/view/nav/top/1/]]></value>
<link><![CDATA[/q1/Mens/x1/leveli/view/nav/top/1/]]></link>
<label><![CDATA[JEWELRY & ACCESSORIES]]></label>
<value><![CDATA[?q1=Jewelry+%26+Accessories&sp_sfvl_field=levelii|leveli|brand|leveliii&x1=leveli&view=nav&top=1]]></value>
<link><![CDATA[?q1=Jewelry+%26+Accessories&sp_sfvl_field=levelii|leveli|brand|leveliii&x1=leveli&view=nav&top=1;i=1;m_ss_head_nav=JEWELRY+%26+ACCESSORIES]]></link>
<label><![CDATA[BEAUTY & FRAGRANCE]]></label>
<value><![CDATA[?q1=Beauty+%26+Fragrance;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1]]></value>
<link><![CDATA[?q1=Beauty+%26+Fragrance;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1;i=1;m_ss_head_nav=BEAUTY+%26+FRAGRANCE]]></link>
<label><![CDATA[GIFTS & HOME]]></label>
<value><![CDATA[?q1=Gifts+%26+Home;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1]]></value>
<link><![CDATA[?q1=Gifts+%26+Home;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1;i=1;m_ss_head_nav=GIFTS+%26+HOME]]></link>
<label><![CDATA[CHILDREN & TOYS]]></label>
<value><![CDATA[?q1=Children+%26+Toys;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1]]></value>
<link><![CDATA[?q1=Children+%26+Toys;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1;i=1;m_ss_head_nav=CHILDREN+%26+TOYS]]></link>
<label><![CDATA[ELECTRONICS]]></label>
<value><![CDATA[?q1=Electronics+%26+Toys;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1]]></value>
<link><![CDATA[?q1=Electronics+%26+Toys;sp_sfvl_field=levelii|leveli|brand|leveliii;x1=leveli;view=nav;top=1;i=1;m_ss_head_nav=ELECTRONICS]]></link>
</menu>
</menus>
<breadcrumbs>
<breadcrumb>
<name><![CDATA[default]]></name>
<breadcrumb-item>
<link><![CDATA[?i=1;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></link>
<value><![CDATA[*]]></value>
<label><![CDATA[]]></label>
</breadcrumb-item>
</breadcrumb>
</breadcrumbs>
<suggestions>
<auto-searched>0</auto-searched>
<suggestions-low-results>0</suggestions-low-results>
</suggestions>
<pagination>
<total-pages><![CDATA[112]]></total-pages>
<pages>
<page position="first"><![CDATA[]]></page>
<page position="last"><![CDATA[?i=1;page=112;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page>
<page position="next"><![CDATA[?i=1;page=2;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page>
<page position="1" selected="true"><![CDATA[?i=1;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page>
<page position="2"><![CDATA[?i=1;page=2;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page>
<page position="3"><![CDATA[?i=1;page=3;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page>
<page position="4"><![CDATA[?i=1;page=4;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page>
<page position="5"><![CDATA[?i=1;page=5;q=*;sp_cs=UTF-8;sp_staged=1;view=xml]]></page>
</pages>
</pagination>
<facets>
<facet-item>
<facet-title><![CDATA[Department]]></facet-title>
<selected>0</selected>
<facet-value>
<label><![CDATA[Womens]]></label>
<link><![CDATA[?i=1;q=*;q1=Womens;sp_cs=UTF-8;sp_staged=1;view=xml;x1=leveli]]></link>
<count><![CDATA[219]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Mens]]></label>
<link><![CDATA[?i=1;q=*;q1=Mens;sp_cs=UTF-8;sp_staged=1;view=xml;x1=leveli]]></link>
<count><![CDATA[202]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Beauty & Fragrance]]></label>
<link><![CDATA[?i=1;q=*;q1=Beauty+%26+Fragrance;sp_cs=UTF-8;sp_staged=1;view=xml;x1=leveli]]></link>
<count><![CDATA[169]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Children & Toys]]></label>
<link><![CDATA[?i=1;q=*;q1=Children+%26+Toys;sp_cs=UTF-8;sp_staged=1;view=xml;x1=leveli]]></link>
<count><![CDATA[209]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Electronics & Toys]]></label>
<link><![CDATA[?i=1;q=*;q1=Electronics+%26+Toys;sp_cs=UTF-8;sp_staged=1;view=xml;x1=leveli]]></link>
<count><![CDATA[200]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Gifts & Home]]></label>
<link><![CDATA[?i=1;q=*;q1=Gifts+%26+Home;sp_cs=UTF-8;sp_staged=1;view=xml;x1=leveli]]></link>
<count><![CDATA[156]]></count>
</facet-value>
<facet-value>
<label><![CDATA[Jewelry & Accessories]]></label>
<link><![CDATA[?i=1;q=*;q1=Jewelry+%26+Accessories;sp_cs=UTF-8;sp_staged=1;view=xml;x1=leveli]]></link>
<count><![CDATA[182]]></count>
</facet-value>
</facet-item>
</facets>
<results>
<result-set>
<name><![CDATA[default]]></name>
<result>
<field name="index"><![CDATA[1]]></field>
<field name="brand"><![CDATA[Citizens]]></field>
<field name="price"><![CDATA[149]]></field>
<field name="foundIn"><![CDATA[Womens,
Apparel,
Denim]]></field>
</result>
<result>
<field name="index"><![CDATA[2]]></field>
<field name="brand"><![CDATA[One For All]]></field>
<field name="price"><![CDATA[145]]></field>
<field name="foundIn"><![CDATA[Womens,
Apparel,
Denim]]></field>
</result>
<result>
<field name="index"><![CDATA[3]]></field>
<field name="brand"><![CDATA[Citizens]]></field>
<field name="price"><![CDATA[208]]></field>
<field name="foundIn"><![CDATA[Womens,
Apparel,
Denim]]></field>
</result>
<result>
<field name="index"><![CDATA[4]]></field>
<field name="brand"><![CDATA[Vera Watson]]></field>
<field name="price"><![CDATA[850]]></field>
<field name="foundIn"><![CDATA[Womens,
Dresses,
Day]]></field>
</result>
<result>
<field name="index"><![CDATA[5]]></field>
<field name="brand"><![CDATA[Ray Laredo]]></field>
<field name="price"><![CDATA[195]]></field>
<field name="foundIn"><![CDATA[Children & Toys,
Apparel,
Boys Toddler (2T-4T)]]></field>
</result>
<result>
<field name="index"><![CDATA[6]]></field>
<field name="brand"><![CDATA[Ray Laredo]]></field>
<field name="price"><![CDATA[80]]></field>
<field name="foundIn"><![CDATA[Children & Toys,
Apparel,
Boys Toddler (2T-4T)]]></field>
</result>
<result>
<field name="index"><![CDATA[7]]></field>
<field name="brand"><![CDATA[Petrol]]></field>
<field name="price"><![CDATA[85]]></field>
<field name="foundIn"><![CDATA[Children & Toys,
Apparel,
Boys Toddler (2T-4T)]]></field>
</result>
<result>
<field name="index"><![CDATA[8]]></field>
<field name="brand"><![CDATA[Woolberry]]></field>
<field name="price"><![CDATA[280]]></field>
<field name="foundIn"><![CDATA[Children & Toys,
Apparel,
Boys Toddler (2T-4T)]]></field>
</result>
<result>
<field name="index"><![CDATA[9]]></field>
<field name="brand"><![CDATA[Petrol]]></field>
<field name="price"><![CDATA[149]]></field>
<field name="foundIn"><![CDATA[Children & Toys,
Apparel,
Boys Toddler (2T-4T)]]></field>
</result>
<result>
<field name="index"><![CDATA[10]]></field>
<field name="brand"><![CDATA[Ray Laredo]]></field>
<field name="price"><![CDATA[55]]></field>
<field name="foundIn"><![CDATA[Children & Toys,
Apparel,
Boys Toddler (2T-4T)]]></field>
</result>
<result>
<field name="index"><![CDATA[11]]></field>
<field name="brand"><![CDATA[Petrol]]></field>
<field name="price"><![CDATA[45]]></field>
<field name="foundIn"><![CDATA[Children & Toys,
Apparel,
Boys Toddler (2T-4T)]]></field>
</result>
<result>
<field name="index"><![CDATA[12]]></field>
<field name="brand"><![CDATA[Ray Laredo]]></field>
<field name="price"><![CDATA[47]]></field>
<field name="foundIn"><![CDATA[Children & Toys,
Apparel,
Boys Toddler (2T-4T)]]></field>
</result>
</result-set>
</results>
<banners>
<banner>
<area><![CDATA[top]]></area>
<content><![CDATA[<div style="color:#70A100">We have custom shipping</div>]]></content>
</banner>
</banners>
<zones>
<zone>
<name><![CDATA[brand-facet]]></name>
<display>1</display>
</zone>
</zones>
<search-form>
<include-tnt-mbox>1</include-tnt-mbox>
<autocomplete>
<enabled>1</enabled>
<css><![CDATA[<link rel="stylesheet" type="text/css" href="https://content.t1.atomz.com/sp10043554/stage/autocomplete_styles.css?sp_js_param=2" />
]]></css>
<form-content><![CDATA[<div id="autocomplete"></div>
<input type="hidden" name="sp_staged" id="sp_staged" value="1" />
]]></form-content>
<javascript><![CDATA[<script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/yui/2.6.0/build/utilities/utilities.js"></script>
<script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/yui/2.6.0/build/datasource/datasource-min.js"></script>
<script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/yui/2.6.0/build/autocomplete/autocomplete-min.js"></script>
<script type="text/javascript" src="https://content.t1.atomz.com/sp10043554/stage/autocomplete_data.js?sp_js_param=3"></script>]]></javascript>
</autocomplete>
</search-form>
</customer-results>
以下是用于生成上述示例输出的示例演示模板。
<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
<customer-results>
<query>
<user-query><![CDATA[<guided-query-param gsname="q" />]]></user-query>
<lower-results><![CDATA[<guided-results-lower>]]></lower-results>
<upper-results><![CDATA[<guided-results-upper>]]></upper-results>
<total-results><![CDATA[<guided-results-total>]]></total-results>
</query>
<custom-fields>
<custom-field name="seo-search-title"><![CDATA[Geometrixx Search Results]]></custom-field>
<custom-field name="seo-search-keywords"><![CDATA[<guided-general-field gsname="default" field="seo_search_keywords"/>]]></custom-field>
</custom-fields>
<menus>
<menu>
<name>sort</name>
<guided-menu gsname="sort">
<guided-if-menu-item-selected>
<item selected="true">
<label><![CDATA[<guided-menu-item-label />]]></label>
<value><![CDATA[<guided-menu-item-value />]]></value>
<link><![CDATA[ ]]></link>
</item>
<guided-else-menu-item-selected>
<item>
<label><![CDATA[<guided-menu-item-label />]]></label>
<value><![CDATA[<guided-menu-item-value />]]></value>
<link><![CDATA[<guided-menu-item-path />]]></link>
</item>
</guided-if-menu-item-selected>
</guided-menu>
</menu>
<menu>
<name><![CDATA[ss_head_nav]]></name>
<guided-menu gsname="ss_head_nav">
<guided-if-menu-item-selected>
<item selected="true">
<label><![CDATA[<guided-menu-item-label />]]></label>
<value><![CDATA[<guided-menu-item-value />]]></value>
<link><![CDATA[<guided-menu-item-path />]]></link>
<guided-else-menu-item-selected>
<label><![CDATA[<guided-menu-item-label />]]></label>
<value><![CDATA[<guided-menu-item-value />]]></value>
<link><![CDATA[<guided-menu-item-path />]]></link>
</guided-if-menu-item-selected>
</guided-menu>
</menu>
</menus>
<breadcrumbs>
<breadcrumb>
<name><![CDATA[default]]></name>
<guided-breadcrumb gsname="default">
<breadcrumb-item>
<link><![CDATA[<guided-breadcrumb-path gsname="goto">]]></link>
<value><![CDATA[<guided-breadcrumb-value />]]></value>
<label><![CDATA[<guided-breadcrumb-label>]]></label>
</breadcrumb-item>
</guided-breadcrumb>
</breadcrumb>
</breadcrumbs>
<suggestions>
<auto-searched><guided-if-suggestion-autosearch>1<guided-else-suggestion-autosearch>0</guided-if-suggestion-autosearch></auto-searched>
<guided-if-suggestion-autosearch><orig-query><![CDATA[<guided-suggestion-original-query/>]]></orig-query></guided-if-suggestion-autosearch>
<suggestions-low-results><guided-if-suggestion-low-results>1<guided-else-suggestion-low-results>0</guided-if-suggestion-low-results></suggestions-low-results>
<guided-suggestions>
<suggestion-item>
<link><![CDATA[<guided-suggestion-path />]]></link>
<word><![CDATA[<guided-suggestion />]]></word>
</suggestion-item>
</guided-suggestions>
</suggestions>
<pagination>
<total-pages><![CDATA[<guided-page-total />]]></total-pages>
<pages>
<page position="first"><![CDATA[<guided-page-path gsname="first" />]]></page>
<page position="last"><![CDATA[<guided-page-path gsname="last" />]]></page>
<guided-if-page-prev><page position="prev"><![CDATA[<guided-page-path gsname="prev" />]]></page></guided-if-page-prev>
<guided-if-page-next><page position="next"><![CDATA[<guided-page-path gsname="next" />]]></page></guided-if-page-next>
<guided-if-page-viewall><page position="viewall"><![CDATA[<guided-page-path gsname="viewall" />]]></page></guided-if-page-viewall>
<guided-if-page-viewpages><page position="viewall"><![CDATA[<guided-page-path gsname="viewpages" />]]></page></guided-if-page-viewpages>
<guided-pages>
<guided-if-page-selected><page position="<guided-page-number />" selected="true"><![CDATA[<guided-page-path />]]></page>
<guided-else-page-selected><page position="<guided-page-number />"><![CDATA[<guided-page-path />]]></page>
</guided-if-page-selected>
</guided-pages>
</pages>
</pagination>
<facets>
<guided-facet gsname="leveli">
<facet-item>
<facet-title><![CDATA[Department]]></facet-title>
<selected><guided-if-facet-selected>1<guided-else-facet-selected>0</guided-if-facet-selected></selected>
<guided-if-facet-selected><undo-link><![CDATA[<guided-facet-undo-path gsname="leveli">]]></undo-link></guided-if-facet-selected>
<guided-facet-values>
<facet-value>
<guided-if-facet-value-selected><selected><![CDATA[true]]></selected></guided-if-facet-value-selected>
<label><![CDATA[<guided-facet-value>]]></label>
<link><![CDATA[<guided-facet-value-path />]]></link>
<count><![CDATA[<guided-facet-count>]]></count>
<guided-if-facet-value-selected><undolink><![CDATA[<guided-facet-value-undo-path />]]></undolink></guided-if-facet-value-selected>
</facet-value>
</guided-facet-values>
</facet-item>
</guided-facet>
</facets>
<results>
<result-set>
<name><![CDATA[default]]></name>
<guided-results gsname="default">
<result>
<field name="index"><![CDATA[<guided-result-index />]]></field>
<field name="brand"><![CDATA[<guided-result-field gsname="brand" />]]></field>
<field name="price"><![CDATA[<guided-result-field gsname="price" />]]></field>
<field name="foundIn"><![CDATA[<guided-if-result-field gsname="leveli"><!--tmpl_var name='leveli'-->, </guided-if-result-field>
<guided-if-result-field gsname="levelii"><!--tmpl_var name='levelii'-->, </guided-if-result-field>
<guided-if-result-field gsname="leveliii"><!--tmpl_var name='leveliii'--></guided-if-result-field>]]></field>
</result>
</guided-results>
</result-set>
</results>
<guided-if-recent-searches>
<recent-searches>
<clear-link><guided-recent-searches-clear-path/></clear-link>
<guided-recent-searches>
<recent-search>
<link><guided-recent-searches-path></link>
<label><guided-recent-searches-value></label>
<recent-search>
</guided-recent-searches>
</recent-searches>
</guided-if-recent-searches>
<banners>
<guided-if-banner-set gsname="top">
<banner>
<area><![CDATA[top]]></area>
<content><![CDATA[<guided-banner gsname="top">]]></content>
</banner>
</guided-if-banner-set>
<guided-if-banner-set gsname="bottom">
<banner>
<area><![CDATA[bottom]]></area>
<content><![CDATA[<guided-banner gsname="bottom">]]></content>
</banner>
</guided-if-banner-set>
</banners>
<zones>
<zone>
<name><![CDATA[brand-facet]]></name>
<display><guided-if-zone gsname="brand-facet">1<guided-else-zone>0</guided-if-zone></display>
</zone>
</zones>
<search-form>
<include-tnt-mbox><guided-if-tnt-business-rules>1<guided-else-tnt-business-rules>0</guided-if-tnt-business-rules></include-tnt-mbox>
<autocomplete>
<enabled><guided-if-autocomplete>1<guided-else-autocomplete>0</guided-if-autocomplete></enabled>
<css><![CDATA[<guided-ac-css/>]]></css>
<form-content><![CDATA[<guided-ac-form-content/>]]></form-content>
<javascript><![CDATA[<guided-ac-javascript/>]]></javascript>
</autocomplete>
</search-form>
</customer-results>